Retrieve external accounts

You can retrieve one or all external accounts.

Retrieve a single external account

Use the Get a single external account endpoint to retrieve an external account. Include your API key and the external account id in the request:

curl --request GET \
     --url https://api.gravv.xyz/v1/external-accounts/<external account id> \
     --header 'Api-Key: <Api Key>'

You will get a response similar to this:

{
  "data": {
    "account_name": "Joshua Edicha",
    "account_number": "1776218486",
    "account_owner_type": null,
    "address": null,
    "currency": "NGN",
    "customer_id": "373556ec-74e5-4cde-909c-b94d864915db",
    "date_created": "2025-10-10T11:14:37.921052Z",
    "iban": null,
    "id": "74943275-6874-41b4-bd71-13d6cf5ed802",
    "institution_country_iso_code": "NG",
    "institution_id": "c0cb83fa-8116-4744-8bc8-0c1cba405400",
    "institution_name": "Access Bank PLC",
    "institution_type": "bank",
    "payee_type": "bank_account_global",
    "routing_number": null
  },
  "error": null
}

Retrieve all external accounts

Use the Get multiple external accounts endpoint to retrieve all external accounts. Include your API key in the request:

curl --request GET \
     --url https://api.gravv.xyz/v1/external-accounts \
     --header 'Api-Key: <Api Key>'

You will get a response similar to this:

{
  "data": {
    "items": [
      {
        "account_name": "Joshua Edicha",
        "account_number": "1776218486",
        "account_owner_type": null,
        "address": null,
        "currency": "NGN",
        "customer_id": "373556ec-74e5-4cde-909c-b94d864915db",
        "date_created": "2025-10-10T11:14:37.921052Z",
        "iban": null,
        "id": "74943275-6874-41b4-bd71-13d6cf5ed802",
        "institution_country_iso_code": "NG",
        "institution_id": "c0cb83fa-8116-4744-8bc8-0c1cba405400",
        "institution_name": "Access Bank PLC",
        "institution_type": "bank",
        "payee_type": "bank_account_global",
        "routing_number": null
      },
      {
        "account_name": "Joshua Edicha",
        "account_number": "4401682860",
        "account_owner_type": "individual",
        "address": {
          "address_line1": "1800 N Pole St, Orlando, FL 32801",
          "address_line2": null,
          "city": "Orlando",
          "country": "US",
          "postal_code": "32801",
          "state": "US-FL"
        },
        "currency": "USD",
        "customer_id": "373556ec-74e5-4cde-909c-b94d864915db",
        "date_created": "2025-10-10T10:43:43.080497Z",
        "iban": null,
        "id": "25db4402-1cfd-43a9-928d-94016c8e3be5",
        "institution_country_iso_code": null,
        "institution_id": null,
        "institution_name": "Lead Bank",
        "institution_type": null,
        "payee_type": "bank_account_us",
        "routing_number": "101019644"
      }
    ],
    "items_per_page": 2,
    "page": 1,
    "total_pages": 1
  },
  "error": null
}