List All Payments
GET/payments
Returns all individual payments matching the request criteria. This endpoint supports pagination and filtering on payment status, receiver ID, and timestamp. Each payment has details on the transaction itself, receiver, disbursement, asset, status history, and blockchain information.
Request
Query Parameters
Default value: 1
The page requested.
Default value: 20
Define how many results will be returned in the response.
Possible values: [DRAFT
, READY
, PENDING
, PAUSED
, SUCCESS
, FAILED
]
Exact match on the status of the payment.
UUID that represents a receiver in the database
Only return payments that are created after this date. Format: YYYY-MM-DD
Only return payments that are created before this date. Format: YYYY-MM-DD
Possible values: [created_at
]
Default value: created_at
Field used to sort payments
Possible values: [asc
, desc
]
Default value: asc
Direction for sorting payments.
Responses
- 200
- 401
- 403
A paginated list of payments
- application/json
- Schema
- Example (from schema)
Schema
Array [
Array [
]
]
pagination
object
data
object[]
Possible values: [DRAFT
, READY
, PENDING
, PAUSED
, SUCCESS
, FAILED
]
status_history
object[]
Possible values: [DRAFT
, READY
, PENDING
, PAUSED
, SUCCESS
, FAILED
]
disbursement
object
The unique identifier of the disbursement
The name of the disbursement
Possible values: [DRAFT
, READY
, STARTED
, PAUSED
, COMPLETED
]
The creation timestamp of the disbursement
The last update timestamp of the disbursement
asset
object
Asset code
Asset issuer address
receiver_wallet
object
receiver
object
wallet
object
Possible values: [DRAFT
, READY
, REGISTERED
, FLAGGED
]
{
"pagination": {
"next": "?page=3&page_limit=2",
"prev": "?page=1&page_limit=2",
"pages": 8,
"total": 16
},
"data": [
{
"id": "ddf22f55-3259-4822-a4e2-ce01334997f4",
"amount": "100.00",
"stellar_transaction_id": "0b339d1c89d314186b8147c2af4c9a9ed5bbdbcd7ada8d138633907649b",
"stellar_operation_id": "string",
"status": "DRAFT",
"status_history": [
{
"status": "DRAFT",
"status_message": "string",
"timestamp": "2023-02-03T10:45:51.000Z"
}
],
"disbursement": {
"id": "c51ba1d5-52d3-412f-a59c-6ef32d59ab43",
"name": "disbursement-june-29",
"status": "DRAFT",
"created_at": "2023-06-30T01:22:57.831975Z",
"updated_at": "2023-06-30T01:22:58.316511Z"
},
"asset": {
"id": "ffaec4b3-46b0-4db4-a4c4-6c3508057705",
"code": "USDC",
"issuer": "GBBD47IF6LWK7P7MDEVSCWR7DPUWV3NY3DTQEVFL4NAT4AQH3ZLLFLA5",
"created_at": "2023-02-03T10:45:51.000Z",
"updated_at": "2023-02-03T10:45:51.000Z",
"deleted_at": "2023-06-03T10:55:51.000Z"
},
"receiver_wallet": {
"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",
"created_at": "2023-02-03T10:45:51.000Z",
"updated_at": "2023-02-03T10:45:51.000Z",
"status": "DRAFT"
},
"created_at": "2023-02-03T10:45:51.000Z",
"updated_at": "2023-02-03T10:45:51.000Z"
}
]
}
Unauthorized
Response Headers
- application/json
- Schema
- Example (from schema)
- response
Schema
extras
object
{
"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": "Forbidden"
}
{
"error": "Forbidden"
}