Skip to main content
GET
/
api
/
v1
/
transfers
List Transfers
curl --request GET \
  --url https://api.usezentra.com/api/v1/transfers \
  --header 'Authorization: Bearer <token>'

​
List Transfers

Retrieve transfers for your account with pagination and basic date or status filters.

​
Endpoint

GET /api/v1/transfers

​
Query Parameters

​
page
number
default:"1"
Page number.
​
limit
number
default:"20"
Number of records per page.
​
status
string
Filter by transfer status.
​
start_date
string
Start date filter in ISO 8601 format.
​
end_date
string
End date filter in ISO 8601 format.

​
Example Request

curl "https://api.usezentra.com/api/v1/transfers?page=1&limit=20&status=successful" \
  -H "Authorization: Bearer YOUR_SECRET_KEY"

​
Example Response

{
  "status": "success",
  "data": [
    {
      "id": "txn_abc123",
      "reference": "TXN_123456",
      "amount_minor": 50000,
      "currency": "NGN",
      "bankCode": "058",
      "accountNumber": "0123456789",
      "accountName": "JOHN DOE",
      "status": "successful",
      "createdAt": "2024-01-15T10:30:00Z"
    }
  ],
  "pagination": {
    "page": 1,
    "limit": 20,
    "total": 100,
    "totalPages": 5
  }
}

​
Response Notes

  • Amounts are returned in minor units.
  • Use the transfer id for retrieval and the transfer reference for verification, retry, and reconciliation flows.
  • For near-real-time lifecycle updates, prefer webhooks over polling.

​
Next Steps

Get Transfer

Fetch one transfer by id

Create Transfer

Initiate a new transfer