List All Receivers
Returns all receivers matching the request criteria. This endpoint supports pagination and filtering on receiver status, receiver attributes, and timestamp. Each payment has details on the receiver, high-level payments metrics, and wallets associated with the receiver.
Query Parameters
- page number
Default value:
1
The page requested.
- page_limit number
Default value:
20
Define how many results will be returned in the response.
- q string
A search term used to query through the receiver phone_number, email, and ID.
- status string
Possible values: [
DRAFT
,READY
,REGISTERED
,FLAGGED
]Exact match on the status of the receiver wallet.
Example: DRAFT - created_at_after string
Only return receivers that are created after this date. Format: YYYY-MM-DD
Example: 2006-01-02 - created_at_before string
Only return receivers that are created before this date. Format: YYYY-MM-DD
Example: 2006-01-02 - sort string
Possible values: [
created_at
]Default value:
created_at
Field used to sort receivers
- direction string
Possible values: [
asc
,desc
]Default value:
asc
Direction for sorting receivers.
- 200
- 401
- 403
A paginated list of Receiver details
- application/json
- Schema
- Example (from schema)
Schema
pagination object
next stringprev stringpages integertotal integerdata object[]
Array [id stringphone_number stringexternal_id stringemail stringcreated_at stringtotal_payments stringsuccessful_payments stringfailed_payments stringremaining_payments stringregistered_wallets stringreceived_amounts object[]
Array [asset_code stringasset_issuer stringreceived_amount string]wallets object[]
Array [id stringreceiver object
id stringwallet object
id stringname stringhomepage stringstellar_address stringstellar_memo stringstellar_memo_type stringcreated_at stringupdated_at stringinvited_at stringlast_sms_sent stringtimestamp when the receiver last received an SMS about this wallet
total_payments stringpayments_received stringfailed_payments stringremaining_payments stringreceived_amounts object[]
Array [asset_code stringasset_issuer stringreceived_amount string]status stringPossible values: [
DRAFT
,READY
,REGISTERED
,FLAGGED
]status_history object[]
Array [status stringPossible values: [
DRAFT
,READY
,REGISTERED
,FLAGGED
]timestamp date-time]]]
{
"pagination": {
"next": "?page=3&page_limit=2",
"prev": "?page=1&page_limit=2",
"pages": 8,
"total": 16
},
"data": [
{
"id": "f83bb638-dda4-41e6-80c9-d03e6eec2aef",
"phone_number": "+15552368475",
"external_id": "usr12334",
"email": "[email protected]",
"created_at": "2023-02-03T10:45:51.000Z",
"total_payments": "2",
"successful_payments": "2",
"failed_payments": "0",
"remaining_payments": "0",
"registered_wallets": 1,
"received_amounts": [
{
"asset_code": "USDC",
"asset_issuer": "GBBD47IF6LWK7P7MDEVSCWR7DPUWV3NY3DTQEVFL4NAT4AQH3ZLLFLA5",
"received_amount": "100.00"
}
],
"wallets": [
{
"id": "803031d4-1d04-4879-b6d9-dc5641f9988e",
"receiver": {
"id": "029e2ed0-feb6-4c40-8b47-0836a85741a2"
},
"wallet": {
"id": "5ada9ed5-455a-4782-a0ee-160767e0deb1",
"name": "Vibrant Assist",
"homepage": "https://vibrantapp.com"
},
"stellar_address": "GCXAJ3XJ3VK3JFH3QMDFOSKM2NMMZBSO3VIT6EUPQWSDW2J74M23RRSL",
"stellar_memo": "string",
"stellar_memo_type": "string",
"created_at": "2023-02-03T10:45:51.000Z",
"updated_at": "2023-02-03T10:45:51.000Z",
"invited_at": "2023-02-09T10:45:51.000Z",
"last_sms_sent": "2023-02-10T10:45:51.000Z",
"total_payments": "2",
"payments_received": "2",
"failed_payments": "0",
"remaining_payments": "0",
"received_amounts": [
{
"asset_code": "USDC",
"asset_issuer": "GBBD47IF6LWK7P7MDEVSCWR7DPUWV3NY3DTQEVFL4NAT4AQH3ZLLFLA5",
"received_amount": "100.00"
}
],
"status": "DRAFT",
"status_history": [
{
"status": "DRAFT",
"timestamp": "2023-02-10T10:45:51.000Z"
}
]
}
]
}
]
}
Unauthorized
Response Headers
- application/json
- Schema
- Example (from schema)
- response
Schema
- error string
extras object
status numbermessage string
{
"error": "Not authorized",
"extras": {
"status": 401,
"message": "Not authorized"
}
}
{
"error": "Not authorized",
"extras": {
"status": 401,
"message": "Not authorized"
}
}
Forbidden
Response Headers
- application/json
- Schema
- Example (from schema)
- response
Schema
- error string
{
"error": "Forbidden"
}
{
"error": "Forbidden"
}