Skip to main content
GET
/
v1
/
transfers
List transfers
curl --request GET \
  --url https://api.adullam.dev/v1/transfers \
  --header 'Authorization: Bearer <token>'
{
  "data": [
    {
      "id": "txf_abc123",
      "status": "processing",
      "amount": 10000,
      "currency": "XOF",
      "recipient_phone": "+22507123456",
      "recipient_name": "DIALLO IBRAHIM",
      "channel": "mtnCI",
      "description": "Salary payment",
      "reference": "PAY_001",
      "ussd_reference": "MP240115.1032.T98765",
      "fees": 50,
      "metadata": {
        "employee_id": "EMP_123"
      },
      "created_at": "2024-01-15T10:30:00Z",
      "updated_at": "2024-01-15T10:30:00Z",
      "completed_at": null,
      "failure_reason": null
    }
  ],
  "has_more": true,
  "next_cursor": "ghi789"
}

​
List Transfers

Listing transfers with pagination allows you to review recent transfer activity in your Adullam account. Use the List Transfers API to retrieve a paginated list of transfers, including details such as amount, status, and recipient information.

Authorizations

​
Authorization
string
header
required

Use the access token obtained from /v1/auth/token

Query Parameters

​
status
enum<string>
Available options:
pending,
processing,
completed,
failed,
cancelled
​
limit
integer
default:50
Required range: 1 <= x <= 100
​
cursor
string
​
recipient_phone
string
​
channel
enum<string>
Available options:
orangeCI,
mtnCI,
moovCI,
waveCI
​
reference
string
​
created_after
string<date-time>
​
created_before
string<date-time>

Response

List of transfers

​
data
object[]
​
has_more
boolean
Example:

true

​
next_cursor
string | null
Example:

"ghi789"