List Withdrawals

You can retrieve a list of SPEI® withdrawals made from your account and filter using specific SPEI® criteria like tracking key, origin ID, beneficiary account number, and withdrawal status.

GET /spei/v2/withdrawals

The GET /spei/v2/withdrawals method returns a cursor based paginated filtered list of SPEI® withdrawals made from your account, ordered by ascending date of creation. The cursor-based pagination allows for more efficient and reliable navigation through large datasets, ensuring you don't miss or duplicate records as new withdrawals are added.

When no query parameters are provided, the created_at_gte filter defaults to the start of the current day (today at 00:00:00 UTC). Details about the available filters and return contract are available in the API Reference.

GET /spei/v2/withdrawals/{wid}

If you need to retrieve the details of a specific withdrawal, use the GET /spei/v2/withdrawals/{wid} method with the withdrawal's unique identifier. Details about the return contract are available in the API Reference.

Refund withdrawals

When a withdrawal fails, the banking system may issue a compensatory deposit back to the sender. In the V2 API, each refunded withdrawal includes a refunded_deposit object with the compensatory deposit's fid and tracking_key, providing a direct link between the failed withdrawal and its compensatory deposit.