Activities

Before You Start

Read the following guides before proceeding:

Guide	Why
Getting Started	Platform overview and setup
Api Basics	Required headers and request configuration
Authentication	How to obtain the corporation token
Webhooks	Activity changes are pushed as well as polled

Everything the corporation does with money lands in the activity feed: card payments, bank transfers,
corridor payouts, FX swaps, deposits and card fees. Each item carries its amounts, rate, counterparties
and the steps it passed through, so a Pending item shows exactly where it is rather than only that it
has not finished.

The feed matters more here than in a request-response reading of the API, because several flows have no
status endpoint at all. An FX swap returns a trade_id, a bulk transfer returns an operation_id, a
corridor transfer returns a transfer_id — and none of them can be looked up. The feed is where their
outcome appears.

For a period rather than a page, use the statement: the same transactions plus opening and closing
balances, debits and credits per asset, and the corporation's details for the header.

Observing an Asynchronous Outcome

Detailed documentation available in Activity History and
Statements.

sequenceDiagram
    participant App as Your App
    participant Corp as Wirex Corporate API

    App->>Corp: 1. POST /api/v3/bank/initiate/pix
    Corp-->>App: transfer_id, status pending

    Corp->>App: 2. POST /v2/webhooks/activities — status Pending
    App->>Corp: 3. GET /api/v1/activity/feed
    Corp-->>App: activity_steps[] — CryptoOut Completed, BankOut Pending

    Corp->>App: 4. POST /v2/webhooks/activities — status Completed

    App->>Corp: 5. POST /api/v1/activity/statement/full
    Corp-->>App: balances[] and transactions[] for the period

Step	Action	Description
1	A transfer endpoint	Returns an identifier and an initial status
2	Webhook	The activity is created and reported
3	`GET /api/v1/activity/feed`	Read `activity_steps[]` to see which stage is outstanding
4	Webhook	The activity reaches `Completed` or `Failed`
5	`POST /api/v1/activity/statement/full`	Reconcile the period

Webhook deliveries are not retried. Poll the feed for anything that must not be missed.

Guides

Guide	Description
Activity History	The feed, its filters, activity types and steps, and pending withdrawals
Statements	Period statements with per-asset opening and closing balances