List All Receivers

GET 
/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.

Request

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.

Responses

200

A paginated list of Receiver details

application/json

Schema

Schema

pagination

object

next string

prev string

pages integer

total integer

data

object[]

Array [

id string

phone_number string

external_id string

email string

created_at string

total_payments string

successful_payments string

failed_payments string

remaining_payments string

registered_wallets string

received_amounts

object[]

Array [

asset_code string

asset_issuer string

received_amount string

]

wallets

object[]

Array [

id string

receiver

object

id string

wallet

object

id string

name string

homepage string

stellar_address string

stellar_memo string

stellar_memo_type string

created_at string

updated_at string

invited_at string

last_sms_sent string

timestamp when the receiver last received an SMS about this wallet

total_payments string

payments_received string

failed_payments string

remaining_payments string

received_amounts

object[]

Array [

asset_code string

asset_issuer string

received_amount string

]

status ReceiversWalletStatus (string)

Possible values: [DRAFT, READY, REGISTERED, FLAGGED]

status_history

object[]

Array [

status ReceiversWalletStatus (string)

Possible values: [DRAFT, READY, REGISTERED, FLAGGED]

timestamp date-time

]

]

]

Example (from schema)

{
  "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": "jdoe@mail.org",
      "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:51Z"
            }
          ]
        }
      ]
    }
  ]
}

401

Unauthorized

application/json

Schema

Schema

error string

extras

object

status number

message string

Example (from schema)

{
  "error": "Not authorized",
  "extras": {
    "status": 401,
    "message": "Not authorized"
  }
}

Example

{
  "error": "Not authorized",
  "extras": {
    "status": 401,
    "message": "Not authorized"
  }
}

403

Forbidden

application/json

Schema

Schema

error string

Example (from schema)

{
  "error": "Forbidden"
}

Example

{
  "error": "Forbidden"
}

Loading...