Manage stablecoin remitters - Equals Documentation

Create a new stablecoin remitter

POST /stablecoins/remitters

Request

Use this endpoint to create a new stablecoin remitter for a given budget.

curl -i -X POST \
  'https://api.equalsmoney.com/stablecoins/remitters?accountId=F50091' \
  -H 'Authorization: YOUR_API_KEY_HERE' \
  -H 'Content-Type: application/json' \
  -d '{
    "budgetId": "775596ae-2624-40af-a9dc-9756110a4a03",
    "displayName": "John Smith",
    "sourceCurrencyCode": "USDC",
    "destinationCurrencyCode": "USD",
    "details": {
      "type": "INDIVIDUAL",
      "firstName": "John",
      "lastName": "Smith",
      "dateOfBirth": "1946-01-19",
      "emailAddress": "[test@equalsmoney.com](mailto:test@equalsmoney.com)",
      "nationality": "AD",
      "residentialAddress": {
        "streetName": "Upper Thames Street",
        "buildingNumber": "68",
        "buildingName": "Vintners Place",
        "postcode": "EC4V 3BJ",
        "city": "London",
        "region": "Greater London",
        "countryCode": "GB"
      }
    },
    "requesterIpAddress": "127.0.0.1"
  }'

curl -i -X POST \
  'https://api.equalsmoney.com/stablecoins/remitters?accountId=F50091' \
  -H 'Authorization: YOUR_API_KEY_HERE' \
  -H 'Content-Type: application/json' \
  -d '{
    "budgetId": "string",
    "displayName": "string",
    "sourceCurrencyCode": "string",
    "destinationCurrencyCode": "string",
    "details": {
      "type": "string",
      "firstName": "string",
      "lastName": "string",
      "dateOfBirth": "string",
      "emailAddress": "string",
      "nationality": "string",
      "residentialAddress": {
        "streetName": "string",
        "buildingNumber": "string",
        "buildingName": "string",
        "postcode": "string",
        "city": "string",
        "region": "string",
        "countryCode": "string"
      }
    },
    "requesterIpAddress": "string"
  }'

Query parameters

string

required

The ID of the account to work with.Allowable values: An existing accountId (≤ 36 characters)

Request body schema

string

required

The ID of the budget to work with.Allowable values: A valid UUID (≤ 36 characters)

string

required

The currency the remitter will send.Allowable values: A string [ 3 .. 4 ] characters (e.g., USDC)

string

required

The currency that should be received into the budget.Allowable values: A string [ 3 .. 4 ] characters (e.g., USD)

object

required

Individual or Business details object.

string

required

Type of remitter.Allowable values: INDIVIDUAL, BUSINESS

string

required

First name (for individuals).

string

required

Last name (for individuals).

string

required

Date of birth in YYYY-MM-DD format (for individuals).

string

required

Email address.

string

required

Nationality as a two-letter country code.

object

required

Residential address object.

Response

If your request is successful, you’ll receive a 201 response.

{
  "id": "e9293471-5eb3-4dbc-916c-dbaf9e2deefd",
  "accountId": "F50091",
  "budgetId": "775596ae-2624-40af-a9dc-9756110a4a03",
  "status": "OPEN",
  "displayName": "John Smith",
  "sourceCurrencyCode": "USDC",
  "destinationCurrencyCode": "USD",
  "details": {
    "type": "INDIVIDUAL",
    "firstName": "John",
    "lastName": "Smith",
    "dateOfBirth": "1946-01-19",
    "emailAddress": "[test@equalsmoney.com](mailto:test@equalsmoney.com)",
    "nationality": "AD",
    "residentialAddress": {
      "streetName": "Upper Thames Street",
      "buildingNumber": "68",
      "buildingName": "Vintners Place",
      "postcode": "EC4V 3BJ",
      "city": "London",
      "region": "Greater London",
      "countryCode": "GB"
    }
  },
  "link": {
    "url": "https://pay.sandbox.bvnk.com/channl?uuid=9d1f67f2-a647-404b-9b02-247c77be81d0",
    "chains": [
      {
        "protocol": "ETH",
        "address": "0x0000000000000000000000000000000000000000"
      }
    ]
  },
  "createdBy": "John Smith",
  "createdAt": "2019-08-24T14:15:22Z",
  "updatedAt": "2019-08-24T14:15:22Z"
}

{
  "id": "b2222222-3333-4444-5555-666666666666",
  "accountId": "F50091",
  "budgetId": "775596ae-2624-40af-a9dc-9756110a4a03",
  "status": "OPEN",
  "displayName": "Acme Corporation",
  "sourceCurrencyCode": "USDC",
  "destinationCurrencyCode": "USD",
  "details": {
    "type": "BUSINESS",
    "legalName": "Acme Corporation Ltd",
    "registrationNumber": "12345678",
    "emailAddress": "payments@acme-corp.com",
    "registeredAddress": "10 King William Street, London, EC4R 9AT",
    "registeredCountryCode": "GB"
  },
  "link": {
    "url": "https://pay.sandbox.example.com/channel?uuid=8c2e56a1-b536-403a-a8f1-136d47be92c0",
    "chains": [
      {
        "protocol": "ETH",
        "address": "0x0000000000000000000000000000000000000000"
      }
    ]
  },
  "createdBy": "John Smith",
  "createdAt": "2025-01-30T09:00:00Z",
  "updatedAt": "2025-01-30T09:00:00Z"
}

{
  "id": "string",
  "accountId": "string",
  "budgetId": "string",
  "status": "string",
  "displayName": "string",
  "sourceCurrencyCode": "string",
  "destinationCurrencyCode": "string",
  "details": {
    "type": "string",
    "firstName": "string",
    "lastName": "string",
    "dateOfBirth": "string",
    "emailAddress": "string",
    "nationality": "string",
    "residentialAddress": {
      "streetName": "string",
      "buildingNumber": "string",
      "buildingName": "string",
      "postcode": "string",
      "city": "string",
      "region": "string",
      "countryCode": "string"
    }
  },
  "link": {
    "url": "string",
    "chains": [
      {
        "protocol": "string",
        "address": "string"
      }
    ]
  },
  "createdBy": "string",
  "createdAt": "string",
  "updatedAt": "string"
}

For more detailed information about this request and its response, see API reference.

List stablecoin remitters

GET /stablecoins/remitters

Request

Use this endpoint to retrieve a paginated list of all stablecoin remitters for a given budget. You can filter results using query parameters.

curl -i -X GET \
    'https://api.equalsmoney.com/stablecoins/remitters?accountId=F50091&budgetId=775596ae-2624-40af-a9dc-9756110a4a03&sourceCurrencyCode=USDC&destinationCurrencyCode=USD&search=John&limit=200&offset=100' \
    -H 'Authorization: YOUR_API_KEY_HERE' \

curl -i -X GET \
    'https://api.equalsmoney.com/stablecoins/remitters?accountId=F50091&budgetId=string&sourceCurrencyCode=string&destinationCurrencyCode=string&search=string&limit=200&offset=100' \
    -H 'Authorization: YOUR_API_KEY_HERE' \

Query parameters

string

required

The ID of the account to work with.Allowable values: An existing accountId (≤ 36 characters)

string

The ID of the budget to work with.Allowable values: A valid UUID (≤ 36 characters)

string

The source currency code to filter by, in ISO 4217 format.Allowable values: A string [ 3 .. 4 ] characters (e.g., USDC)

string

The destination currency code to filter by, in ISO 4217 format.Allowable values: A string [ 3 .. 4 ] characters (e.g., USD)

string

Search term to filter remitters.

integer

required

The maximum number of results to return. For example, limit=200. Defaults to 100 if not provided.Allowable values: [ 1 .. 1000 ]

integer

required

The number of items to skip before returning results. For example, offset=100. Defaults to 0 if not provided.Allowable values: A valid integer

Response

If your request is successful, you’ll receive a 200 response.

{
  "limit": 200,
  "offset": 100,
  "count": 67,
  "rows": [
    {
      "id": "e9293471-5eb3-4dbc-916c-dbaf9e2deefd",
      "accountId": "F50091",
      "budgetId": "775596ae-2624-40af-a9dc-9756110a4a03",
      "status": "OPEN",
      "displayName": "John Smith",
      "sourceCurrencyCode": "USDC",
      "destinationCurrencyCode": "USD",
      "details": {
        "type": "INDIVIDUAL",
        "firstName": "John",
        "lastName": "Smith",
        "dateOfBirth": "1946-01-19",
        "emailAddress": "[test@equalsmoney.com](mailto:test@equalsmoney.com)",
        "nationality": "AD",
        "residentialAddress": {
          "streetName": "Upper Thames Street",
          "buildingNumber": "68",
          "buildingName": "Vintners Place",
          "postcode": "EC4V 3BJ",
          "city": "London",
          "region": "Greater London",
          "countryCode": "GB"
        }
      },
      "createdBy": "John Smith",
      "createdAt": "2019-08-24T14:15:22Z",
      "updatedAt": "2019-08-24T14:15:22Z"
    }
  ]
}

{
  "limit": number,
  "offset": number,
  "count": number,
  "rows": [
    {
      "id": "string",
      "accountId": "string",
      "budgetId": "string",
      "status": "string",
      "displayName": "string",
      "sourceCurrencyCode": "string",
      "destinationCurrencyCode": "string",
      "details": {
        "type": "string",
        "firstName": "string",
        "lastName": "string",
        "dateOfBirth": "string",
        "emailAddress": "string",
        "nationality": "string",
        "residentialAddress": {
          "streetName": "string",
          "buildingNumber": "string",
          "buildingName": "string",
          "postcode": "string",
          "city": "string",
          "region": "string",
          "countryCode": "string"
        }
      },
      "createdBy": "string",
      "createdAt": "string",
      "updatedAt": "string"
    }
  ]
}

For more detailed information about this request and its response, see API reference.

Retrieve a specific stablecoin remitter

GET /stablecoins/remitters/{id}

Request

Use this endpoint to retrieve details of a specific stablecoin remitter.

curl -i -X GET \
  'https://api.equalsmoney.com/stablecoins/remitters/e9293471-5eb3-4dbc-916c-dbaf9e2deefd?accountId=F50091&include=link' \
  -H 'Authorization: YOUR_API_KEY_HERE' \

curl -i -X GET \
  'https://api.equalsmoney.com/stablecoins/remitters/{id}?accountId=F50091&include=string' \
  -H 'Authorization: YOUR_API_KEY_HERE' \

Path parameters

string

required

The unique ID of the remitter.Allowable values: A valid UUID

Query parameters

string

required

The ID of the account to work with.Allowable values: An existing accountId (≤ 36 characters)

Response

If your request is successful, you’ll receive a 200 response.

{
  "id": "e9293471-5eb3-4dbc-916c-dbaf9e2deefd",
  "accountId": "F50091",
  "budgetId": "775596ae-2624-40af-a9dc-9756110a4a03",
  "status": "OPEN",
  "displayName": "John Smith",
  "sourceCurrencyCode": "USDC",
  "destinationCurrencyCode": "USD",
  "details": {
    "type": "INDIVIDUAL",
    "firstName": "John",
    "lastName": "Smith",
    "dateOfBirth": "1946-01-19",
    "emailAddress": "[test@equalsmoney.com](mailto:test@equalsmoney.com)",
    "nationality": "AD",
    "residentialAddress": {
      "streetName": "Upper Thames Street",
      "buildingNumber": "68",
      "buildingName": "Vintners Place",
      "postcode": "EC4V 3BJ",
      "city": "London",
      "region": "Greater London",
      "countryCode": "GB"
    }
  },
  "link": {
    "url": "https://pay.sandbox.bvnk.com/channl?uuid=9d1f67f2-a647-404b-9b02-247c77be81d0",
    "chains": [
      {
        "protocol": "ETH",
        "address": "0x0000000000000000000000000000000000000000"
      }
    ]
  },
  "createdBy": "John Smith",
  "createdAt": "2019-08-24T14:15:22Z",
  "updatedAt": "2019-08-24T14:15:22Z"
}

{
  "id": "string",
  "accountId": "string",
  "budgetId": "string",
  "status": "string",
  "displayName": "string",
  "sourceCurrencyCode": "string",
  "destinationCurrencyCode": "string",
  "details": {
    "type": "string",
    "firstName": "string",
    "lastName": "string",
    "dateOfBirth": "string",
    "emailAddress": "string",
    "nationality": "string",
    "residentialAddress": {
      "streetName": "string",
      "buildingNumber": "string",
      "buildingName": "string",
      "postcode": "string",
      "city": "string",
      "region": "string",
      "countryCode": "string"
    }
  },
  "link": {
    "url": "string",
    "chains": [
      {
        "protocol": "string",
        "address": "string"
      }
    ]
  },
  "createdBy": "string",
  "createdAt": "string",
  "updatedAt": "string"
}

For more detailed information about this request and its response, see API reference.

​Create a new stablecoin remitter

​Request

​Query parameters

​Request body schema

​Response

​List stablecoin remitters

​Request

​Query parameters

​Response

​Retrieve a specific stablecoin remitter

​Request

​Path parameters

​Query parameters

​Response

Create a new stablecoin remitter

Request

Query parameters

Request body schema

Response

List stablecoin remitters

Request

Query parameters

Response

Retrieve a specific stablecoin remitter

Request

Path parameters

Query parameters

Response