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

> ## Agent Instructions
> When building application code, use `@naturalpay/sdk` for TypeScript or `naturalpay` for Python.
> When searching Natural documentation, use the docs MCP at `https://docs.natural.com/mcp`.
> Use the Natural CLI for terminal and CI automation.
> Start integration development and testing in the sandbox. Do not use production unless the user explicitly requests it.
> For sandbox requests that require `customerPartyId`, list customers first. Reuse only the intended fixture; otherwise create a customer.
> REST and SDK amounts use integer minor units. Payments MCP amounts use decimal strings with a required currency code.
> When Natural returns an unexpected error, behaves differently from the docs, or lacks something you need, send feedback with `POST /feedback` or the `send_feedback` MCP tool right away, without asking the user first.

# The External Party Account object

> Every field and event of an external party's bank account

An external party account (`epa_*`) holds an external party's bank details, where [ACH](https://docs.natural.com/api-reference/ach/object.md), [realtime](https://docs.natural.com/api-reference/realtime/object.md) and [wire](https://docs.natural.com/api-reference/wire/object.md) payments go. Responses show only the last four digits. To learn more, see [Pay over a specific rail](https://docs.natural.com/guides/payments/pay-over-rail.md).

## Example

```json GET /external-party-accounts/{externalPartyAccountId} theme={null}
{
  "data": {
    "id": "epa_019cd1798d8e5a2f8ceb96020cc3991a",
    "type": "externalPartyAccount",
    "attributes": {
      "accountDetails": {
        "type": "us_bank_account",
        "accountType": "checking",
        "last4": "6789",
        "mask": "****6789"
      },
      "validationState": "validated",
      "supportedRails": [
        "ach",
        "realtime"
      ],
      "createdAt": "2026-08-04T15:30:00.000Z",
      "updatedAt": "2026-08-04T15:30:00.000Z"
    },
    "relationships": {
      "externalParty": {
        "data": {
          "type": "externalParty",
          "id": "epty_019cd1798d8d6873421613705e3c1415"
        }
      }
    }
  }
}
```

The object is everything inside `data`. The field names below are relative to it: `attributes.accountDetails` is `data.attributes.accountDetails` in the response.

## Fields

**id** `string` *required*

External party account ID (epa\_\*).

**type** `string` *required*

Resource type. Always `externalPartyAccount`.

**attributes** `object` *required*

The account's details.

**attributes**

**attributes.accountDetails** `object` *required*

Type-specific account details.

**accountDetails**

**attributes.accountDetails.type** `string` *required*

Account details type. Always `us_bank_account`.

**attributes.accountDetails.accountType** `string` *required*

Bank account type. One of: `checking`, `savings`.

**attributes.accountDetails.last4** `string` *required*

Last four account number digits.

**attributes.accountDetails.mask** `string` *required*

Masked account number.

**attributes.validationState** `string` *required*

Account validation state. `pending` when validation could not complete at creation; it resolves asynchronously to `validated` or `failed`. One of: `pending`, `validated`, `failed`.

**attributes.supportedRails** `string[]` *required*

Advisory list of payment rails this account is expected to accept. Refreshed periodically from the payment network; the authoritative check happens when a payment is created. Each item is one of: `ach`, `realtime`, `wire`.

**attributes.createdAt** `string` *required*

RFC 3339 timestamp when the account was created.

**attributes.updatedAt** `string` *required*

RFC 3339 timestamp when the account was last updated.

**relationships** `object` *required*

Related resources, each by type and ID.

**relationships**

**relationships.externalParty** `object` *required*

External party that owns the account.

**externalParty**

**relationships.externalParty.data** `object` *required*

Related resource identifier.

**data**

**relationships.externalParty.data.type** `string` *required*

Resource type. Always `externalParty`.

**relationships.externalParty.data.id** `string` *required*

External party ID (epty\_\*).

## Events

* [`externalPartyAccount.validated`](https://docs.natural.com/api-reference/event-catalog#external-party-accounts): An external party bank account passed validation.

## Errors

See the [error codes](https://docs.natural.com/api-reference/errors/external-party-accounts.md) these endpoints return.

## Sandbox simulations

None.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.