---
title: "Retrieve external accounts"
---
You can retrieve one or all [external accounts](/platform/accounts/overview#external-accounts).

## Retrieve a single external account

Use the [Get a single external account](/api-reference/external-accounts/get-v1-external-accounts-external-account-id) endpoint to retrieve an external account. Include your API key and the external account id in the request:

```bash title="retrieve a single external account 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:

```json title="retrieve a single external account response"
{
  "data": {
    "account_name": "Amina Bello",
    "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",
    "routing_number": null
  },
  "error": null
}
```

## Retrieve all external accounts

Use the [Get multiple external accounts](/api-reference/external-accounts/get-v1-external-accounts) endpoint to retrieve all external accounts. Include your API key in the request:

```bash title="retrieve all external accounts 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:

```json title="retrieve all external accounts response"
{
  "data": {
    "items": [
      {
        "account_name": "Amina Bello",
        "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",
        "routing_number": null
      },
      {
        "account_name": "Amina Bello",
        "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": "Example Community Bank",
        "institution_type": null,
        "payee_type": "ach_wire",
        "routing_number": "101019644"
      }
    ],
    "items_per_page": 2,
    "page": 1,
    "total_pages": 1
  },
  "error": null
}
```