> ## Documentation Index
> Fetch the complete documentation index at: https://docs.equalsmoney.com/llms.txt
> Use this file to discover all available pages before exploring further.

# View account details

> Retrieve information about a given account, or get a list of all the accounts that you have access to.

## Retrieve an account's details

<Note>
  **GET** `/v2/accounts/{accountId}`
</Note>

### Request

Use this request to retrieve details about a given account, based on its `accountId`. The response will contain either personal or business details, such as the account name, the primary owner of the account, and enabled features.

<CodeGroup>
  ```bash Sample request theme={null}
  curl -i -X GET \
    'https://api.equalsmoney.com/v2/accounts/F12345' \
    -H 'Authorization: ApiKey YOUR_API_KEY_HERE'
  ```

  ```bash Request structure theme={null}
  curl -i -X GET \
    'https://api.equalsmoney.com/v2/accounts/{accountId}' \
    -H 'Authorization: ApiKey YOUR_API_KEY_HERE'
  ```
</CodeGroup>

You can use the optional `include` parameter to retrieve additional information, such as currencies configured on the account.

#### Path parameters

<ParamField body="accountId" type="string" required>
  The ID of the account for which you want to retrieve details.

  Allowable values: An existing `accountId`
</ParamField>

#### Query parameters

<ParamField body="personId" type="string">
  The ID of the person to filter results by.

  Allowable values: An existing `personId` (≤ 36 characters)
</ParamField>

<ParamField body="include" type="array of any">
  Optional embeds to include when returning the account details. For example, `include=currencies`.

  Allowable values: `addresses`, `currencies`, `primaryOwner`, `spot`, `market`, `settings`
</ParamField>

### Response

If your request is successful, you'll receive a `200` response. The contents of this response will vary depending on whether the account is a [business account](#business-account) or a [personal account](#personal-account).

#### Business account

<CodeGroup>
  ```json Sample response theme={null}
  {
    "id": "F12345",
    "productId": "d926625b-5e11-4ec1-b4cd-0af2a8021efc",
    "marketId": "091505ff-55e1-11ed-9dd3-06e3d0fbf8b0",
    "bankEntity": "ACME",
    "type": "Business",
    "status": "active",
    "primaryOwnerPersonaId": "4d7685cf-7f3e-4e8a-add9-2a13fc36c13e",
    "termsAccepted": true,
    "privacyAccepted": true,
    "salesperson": "Equals",
    "accountManager": "Equals",
    "solutions": false,
    "tier": "NotTraded",
    "currentRiskLevel": "Low",
    "createdAt": "2024-02-02T12:45:48.000Z",
    "updatedAt": "2024-02-02T12:48:04.000Z",
    "business": {
      "logo": {
        "url": "",
        "fileName": ""
      },
      "accountId": "F12345",
      "name": "ACME & SONS",
      "countryOfRegistration": "",
      "companyType": "ltd",
      "companiesHouseId": " ",
      "telephoneNumber": "+447111222333",
      "timezone": "Europe/London",
      	"registeredName": "ACME & SONS",
      "fourthLine": "",
      "tradingName": "ACME & SONS",
      "website": "",
      "industry": "",
      "createdAt": "2024-02-02T12:45:48.000Z",
      "updatedAt": "2024-02-02T12:45:48.000Z"
    },
    "personal": null,
    "features": {
      "id": "3e3bd241-e853-4830-98ce-216b0586d6cc",
      "cards": false,
      "physicalCards": "inactive",
      "virtualCards": "inactive",
      "microCorp": false,
      "payments": true,
      "sharedCardProductId": "23ada04b-5b3b-4b73-8343-da3f14d8d96f",
      "individualVirtualCardProductId": "23ada04b-5b3b-4b73-8343-da3f14d8d96f",
      "individualPhysicalCardProductId": "4ac7a04a-da92-4785-add0-5168abf05683",
      "useBalanceName": false,
      "forwardContracts": false,
      "sourceOfBalance": "boxes",
      "cardsIndividualType": "prepaid",
      "cardsSharedType": "prepaid",
      "statementsFrom": "2024-02-02T12:47:01.000Z",
      "selfApprove": false,
      "apiIgnorePaymentApproval": true,
      "moveMoneyRequests": false,
      "subBalances": false,
      "autoCreditToFundsHeld": false,
      "dualAuthorise": false,
      "freeInternalTransfers": false,
      "createdAt": "2024-01-31T11:05:04.000Z",
      "updatedAt": "2024-01-31T11:05:04.000Z"
    }
  }
  ```

  ```json Response structure theme={null}
  {
    "id": "string",
    "productId": "string",
    "marketId": "string",
    "bankEntity": "string",
    "type": "string",
    "status": "string",
    "primaryOwnerPersonaId": "string",
    "termsAccepted": boolean,
    "privacyAccepted": boolean,
    "salesperson": "string",
    "accountManager": "string",
    "solutions": boolean,
    "tier": "string",
    "currentRiskLevel": "string",
    "createdAt": "string",
    "updatedAt": "string",
    "business": {
      "logo": {
        "url": "string",
        "fileName": "string"
      },
      "accountId": "string",
      "name": "string",
      "countryOfRegistration": "string",
      "companyType": "string",
      "companiesHouseId": "string",
      "telephoneNumber": "string",
      "timezone": "string",
      "registeredName": "string",
      "fourthLine": "string",
      "tradingName": "string",
      "website": "string",
      "industry": "",
      "createdAt": "string",
      "updatedAt": "string"
    },
    "personal": null,
    "features": {
      "id": "string",
      "cards": boolean,
      "physicalCards": "string",
      "virtualCards": "string",
      "microCorp": boolean,
      "payments": boolean,
      "sharedCardProductId": "string",
      "individualVirtualCardProductId": "string",
      "individualPhysicalCardProductId": "string",
      "useBalanceName": boolean,
      "forwardContracts": boolean,
      "sourceOfBalance": "string",
      "cardsIndividualType": "string",
      "cardsSharedType": "string",
      "statementsFrom": "string",
      "selfApprove": boolean,
      "apiIgnorePaymentApproval": boolean,
      "moveMoneyRequests": boolean,
      "subBalances": boolean,
      "autoCreditToFundsHeld": boolean,
      "dualAuthorise": boolean,
      "freeInternalTransfers": boolean,
      "createdAt": "string",
      "updatedAt": "string"
    }
  }
  ```
</CodeGroup>

#### Personal account

<CodeGroup>
  ```json Sample response theme={null}
  {
    "id": "F54321",
    "productId": "d926625b-5e11-4ec1-b4cd-0af2a8021efc",
    "marketId": "091505ff-55e1-11ed-9dd3-06e3d0fbf8b0",
    "bankEntity": "BARC",
    "type": "Personal",
    "status": "active",
    "primaryOwnerPersonaId": "5f663cf7-ee33-4f44-b9b7-cfaa5aecce1d",
    "termsAccepted": true,
    "privacyAccepted": true,
    "salesperson": "Equals",
    "accountManager": "Equals",
    "solutions": false,
    "tier": "NotTraded",
    "currentRiskLevel": "Low",
    "createdAt": "2024-02-02T12:49:59.000Z",
    "updatedAt": "2024-02-02T12:54:19.000Z",
    "business": null,
    "personal": {
      "logo": {
        "url": "",
        "fileName": ""
      },
      "accountId": "F54321",
      "name": "George Grant",
      "countryOfRegistration": null,
      "companyType": null,
      "companiesHouseId": null,
      "telephoneNumber": "+447111222333",
      "timezone": "Europe/London",
      "registeredName": null,
      "tradingName": "George Grant",
      "website": null,
      "industry": null,
      "createdAt": "2024-02-02T12:49:59.000Z",
      "updatedAt": "2024-02-02T12:49:59.000Z"
    },
    "features": {
      "id": "51a50b73-4523-4607-9495-f020bc25a1c6",
      "cards": false,
      "physicalCards": "inactive",
      "virtualCards": "inactive",
      "microCorp": false,
      "payments": true,
      "sharedCardProductId": "23ada04b-5b3b-4b73-8343-da3f14d8d96f",
      "individualVirtualCardProductId": "23ada04b-5b3b-4b73-8343-da3f14d8d96f",
      "individualPhysicalCardProductId": "4ac7a04a-da92-4785-add0-5168abf05683",
      "useBalanceName": false,
      "forwardContracts": false,
      "sourceOfBalance": "boxes",
      "cardsIndividualType": "prepaid",
      "cardsSharedType": "prepaid",
      "statementsFrom": "2024-02-02T12:53:16.000Z",
      "selfApprove": false,
      "apiIgnorePaymentApproval": true,
      "moveMoneyRequests": false,
      "subBalances": false,
      "autoCreditToFundsHeld": false,
      "dualAuthorise": false,
      "freeInternalTransfers": false,
      "createdAt": "2024-01-31T11:05:04.000Z",
      "updatedAt": "2024-01-31T11:05:04.000Z"
    }
  }
  ```

  ```json Response structure theme={null}
  {
    "id": "string",
    "productId": "string",
    "marketId": "string",
    "bankEntity": "string",
    "type": "string",
    "status": "string",
    "primaryOwnerPersonaId": "string",
    "termsAccepted": boolean,
    "privacyAccepted": boolean,
    "salesperson": "string",
    "accountManager": "string",
    "solutions": boolean,
    "tier": "string",
    "currentRiskLevel": "string",
    "createdAt": "string",
    "updatedAt": "string",
    "business": null,
    "personal": {
      "logo": {
        "url": "string",
        "fileName": "string"
      },
      "accountId": "string",
      "name": "string",
      "countryOfRegistration": null,
      "companyType": null,
      "companiesHouseId": null,
      "telephoneNumber": "string",
      "timezone": "string",
      "registeredName": null,
      "tradingName": "string",
      "website": null,
      "industry": null,
      "createdAt": "string",
      "updatedAt": "string"
    },
    "features": {
      "id": "string",
      "cards": boolean,
      "physicalCards": "string",
      "virtualCards": "string",
      "microCorp": boolean,
      "payments": boolean,
      "sharedCardProductId": "string",
      "individualVirtualCardProductId": "string",
      "individualPhysicalCardProductId": "string",
      "useBalanceName": boolean,
      "forwardContracts": boolean,
      "sourceOfBalance": "string",
      "cardsIndividualType": "string",
      "cardsSharedType": "string",
      "statementsFrom": "string",
      "selfApprove": boolean,
      "apiIgnorePaymentApproval": boolean,
      "moveMoneyRequests": boolean,
      "subBalances": boolean,
      "autoCreditToFundsHeld": boolean,
      "dualAuthorise": boolean,
      "freeInternalTransfers": boolean,
      "createdAt": "string",
      "updatedAt": "string"
    }
  }
  ```
</CodeGroup>

For more detailed information about this request and its response, [see the API reference](/api-reference/accounts/retrieve-an-accounts-details).

## List all accounts

<Note>
  **GET** `/v2/accounts`
</Note>

### Request

Use this request to get a list of all the accounts that you can access. Results are ordered chronologically, by creation date.

```bash theme={null}
curl -i -X GET \
  'https://api.equalsmoney.com/v2/accounts' \
  -H 'Authorization: ApiKey YOUR_API_KEY_HERE'
```

#### Query parameters

<ParamField body="limit" type="integer">
  The maximum number of items to return. For example, `limit=25`. By default, this is set to `100`.

  Allowable values: `[ 1 .. 100000 ]`
</ParamField>

<ParamField body="offset" type="integer">
  The number of items to skip before returning the results. For example, `offset=200`. By default, this is set to `0`.

  Allowable values: A valid integer
</ParamField>

<ParamField body="primaryEmailAddress" type="string">
  Filter results by primary email address.

  Allowable values: A valid string
</ParamField>

### Response

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

<CodeGroup>
  ```json Sample response theme={null}
  {
    "count": 2,
    "limit": 100,
    "offset": 0,
    "rows": [
      {
        "id": "F54321",
        "productId": "d926625b-5e11-4ec1-b4cd-0af2a8021efc",
        "marketId": "091505ff-55e1-11ed-9dd3-06e3d0fbf8b0",
        "bankEntity": "BARC",
        "type": "Personal",
        "status": "active",
        "primaryOwnerPersonaId": "5f663cf7-ee33-4f44-b9b7-cfaa5aecce1d",
        "termsAccepted": true,
        "privacyAccepted": true,
        "salesperson": "Equals",
        "accountManager": "Equals",
        "solutions": false,
        "tier": "NotTraded",
        "currentRiskLevel": "Low",
        "createdAt": "2024-02-02T12:49:59.000Z",
        "updatedAt": "2024-02-02T12:54:19.000Z",
        "business": null,
        "personal": {
          "logo": {
            "url": "",
            "fileName": ""
          },
          "accountId": "F54321",
          "name": "George Grant",
          "countryOfRegistration": null,
          "companyType": null,
          "companiesHouseId": null,
          "telephoneNumber": "+447111222333",
          "timezone": "Europe/London",
          "registeredName": null,
          "tradingName": "George Grant",
          "website": null,
          "industry": null,
          "createdAt": "2024-02-02T12:49:59.000Z",
          "updatedAt": "2024-02-02T12:49:59.000Z"
        },
        "features": {
          "id": "51a50b73-4523-4607-9495-f020bc25a1c6",
          "cards": false,
          "physicalCards": "inactive",
          "virtualCards": "inactive",
          "microCorp": false,
          "payments": true,
          "sharedCardProductId": "23ada04b-5b3b-4b73-8343-da3f14d8d96f",
          "individualVirtualCardProductId": "23ada04b-5b3b-4b73-8343-da3f14d8d96f",
          "individualPhysicalCardProductId": "4ac7a04a-da92-4785-add0-5168abf05683",
          "useBalanceName": false,
          "forwardContracts": false,
          "sourceOfBalance": "boxes",
          "cardsIndividualType": "prepaid",
          "cardsSharedType": "prepaid",
          "statementsFrom": "2024-02-02T12:53:16.000Z",
          "selfApprove": false,
          "apiIgnorePaymentApproval": true,
          "moveMoneyRequests": false,
          "subBalances": false,
          "autoCreditToFundsHeld": false,
          "dualAuthorise": false,
          "freeInternalTransfers": false,
          "createdAt": "2024-01-31T11:05:04.000Z",
          "updatedAt": "2024-01-31T11:05:04.000Z"
        }
      },
      {
        "id": "F12345",
        "productId": "d926625b-5e11-4ec1-b4cd-0af2a8021efc",
        "marketId": "091505ff-55e1-11ed-9dd3-06e3d0fbf8b0",
        "bankEntity": "ACME",
        "type": "Business",
        "status": "active",
        "primaryOwnerPersonaId": "4d7685cf-7f3e-4e8a-add9-2a13fc36c13e",
        "termsAccepted": true,
        "privacyAccepted": true,
        "salesperson": "Equals",
        "accountManager": "Equals",
        "solutions": false,
        "tier": "NotTraded",
        "currentRiskLevel": "Low",
        "createdAt": "2024-02-02T12:45:48.000Z",
        "updatedAt": "2024-02-02T12:48:04.000Z",
        "business": {
          "logo": {
            "url": "",
            "fileName": ""
          },
          "accountId": "F12345",
          "name": "ACME & SONS",
          "countryOfRegistration": "",
          "companyType": "ltd",
          "companiesHouseId": " ",
          "telephoneNumber": "+447111222333",
          "timezone": "Europe/London",
            "registeredName": "ACME & SONS",
          "fourthLine": "",
          "tradingName": "ACME & SONS",
          "website": "",
          "industry": "",
          "createdAt": "2024-02-02T12:45:48.000Z",
          "updatedAt": "2024-02-02T12:45:48.000Z"
        },
        "personal": null,
        "features": {
          "id": "3e3bd241-e853-4830-98ce-216b0586d6cc",
          "cards": false,
          "physicalCards": "inactive",
          "virtualCards": "inactive",
          "microCorp": false,
          "payments": true,
          "sharedCardProductId": "23ada04b-5b3b-4b73-8343-da3f14d8d96f",
          "individualVirtualCardProductId": "23ada04b-5b3b-4b73-8343-da3f14d8d96f",
          "individualPhysicalCardProductId": "4ac7a04a-da92-4785-add0-5168abf05683",
          "useBalanceName": false,
          "forwardContracts": false,
          "sourceOfBalance": "boxes",
          "cardsIndividualType": "prepaid",
          "cardsSharedType": "prepaid",
          "statementsFrom": "2024-02-02T12:47:01.000Z",
          "selfApprove": false,
          "apiIgnorePaymentApproval": true,
          "moveMoneyRequests": false,
          "subBalances": false,
          "autoCreditToFundsHeld": false,
          "dualAuthorise": false,
          "freeInternalTransfers": false,
          "createdAt": "2024-01-31T11:05:04.000Z",
          "updatedAt": "2024-01-31T11:05:04.000Z"
        }
      }
    ]
  }
  ```

  ```json Response structure theme={null}
  {
    "count": 2,
    "limit": 100,
    "offset": 0,
    "rows": [
      {
        "id": "string",
        "productId": "string",
        "marketId": "string",
        "bankEntity": "string",
        "type": "string",
        "status": "string",
        "primaryOwnerPersonaId": "string",
        "termsAccepted": boolean,
        "privacyAccepted": boolean,
        "salesperson": "string",
        "accountManager": "string",
        "solutions": boolean,
        "tier": "string",
        "currentRiskLevel": "string",
        "createdAt": "string",
        "updatedAt": "string",
        "business": null,
        "personal": {
          "logo": {
            "url": "string",
            "fileName": "string"
          },
          "accountId": "string",
          "name": "string",
          "countryOfRegistration": null,
          "companyType": null,
          "companiesHouseId": null,
          "telephoneNumber": "string",
          "timezone": "string",
          "registeredName": null,
          "tradingName": "string",
          "website": null,
          "industry": null,
          "createdAt": "string",
          "updatedAt": "string"
        },
        "features": {
          "id": "string",
          "cards": boolean,
          "physicalCards": "string",
          "virtualCards": "string",
          "microCorp": boolean,
          "payments": boolean,
          "sharedCardProductId": "string",
          "individualVirtualCardProductId": "string",
          "individualPhysicalCardProductId": "string",
          "useBalanceName": boolean,
          "forwardContracts": boolean,
          "sourceOfBalance": "string",
          "cardsIndividualType": "string",
          "cardsSharedType": "string",
          "statementsFrom": "string",
          "selfApprove": boolean,
          "apiIgnorePaymentApproval": boolean,
          "moveMoneyRequests": boolean,
          "subBalances": boolean,
          "autoCreditToFundsHeld": boolean,
          "dualAuthorise": boolean,
          "freeInternalTransfers": boolean,
          "createdAt": "string",
          "updatedAt": "string"
        }
      },
      {
        "id": "string",
        "productId": "string",
        "marketId": "string",
        "bankEntity": "string",
        "type": "string",
        "status": "string",
        "primaryOwnerPersonaId": "string",
        "termsAccepted": boolean,
        "privacyAccepted": boolean,
        "salesperson": "string",
        "accountManager": "string",
        "solutions": boolean,
        "tier": "string",
        "currentRiskLevel": "string",
        "createdAt": "string",
        "updatedAt": "string",
        "business": {
          "logo": {
            "url": "string",
            "fileName": "string"
          },
          "accountId": "string",
          "name": "string",
          "countryOfRegistration": "string",
          "companyType": "string",
          "companiesHouseId": "string",
          "telephoneNumber": "string",
          "timezone": "string",
          "registeredName": "string",
          "fourthLine": "string",
          "tradingName": "string",
          "website": "string",
          "industry": "",
          "createdAt": "string",
          "updatedAt": "string"
        },
        "personal": null,
        "features": {
          "id": "string",
          "cards": boolean,
          "physicalCards": "string",
          "virtualCards": "string",
          "microCorp": boolean,
          "payments": boolean,
          "sharedCardProductId": "string",
          "individualVirtualCardProductId": "string",
          "individualPhysicalCardProductId": "string",
          "useBalanceName": boolean,
          "forwardContracts": boolean,
          "sourceOfBalance": "string",
          "cardsIndividualType": "string",
          "cardsSharedType": "string",
          "statementsFrom": "string",
          "selfApprove": boolean,
          "apiIgnorePaymentApproval": boolean,
          "moveMoneyRequests": boolean,
          "subBalances": boolean,
          "autoCreditToFundsHeld": boolean,
          "dualAuthorise": boolean,
          "freeInternalTransfers": boolean,
          "createdAt": "string",
          "updatedAt": "string"
        }
      }
    ]
  }
  ```
</CodeGroup>

For more detailed information about this request and its response, [see the API reference](/api-reference/accounts/list-all-accounts).