# Get account by ID

Get recipient account info by ID.

{% admonition type="info" %}
V1 and v2 versions are cross compatible, but the v2 endpoint provides additional features.
{% /admonition %}

Endpoint: GET /v2/accounts/{accountId}
Security: UserToken

## Path parameters:

  - `accountId` (integer, required)
    Recipient account ID.

## Response 200 fields (application/json):

  - `id` (integer)
    ID of the recipient. Use the returned id as sourceAccount to specify the refund recipient when creating transfers.
    Example: 40000000

  - `creatorId` (integer)
    Account entity that owns the recipient account.
    Example: 41000000

  - `profileId` (integer)
    Specific profile that owns the recipient account.
    Example: 30000000

  - `name` (object)
    Recipient name details.

  - `name.fullName` (string)
    Recipient full name.
    Example: "John Doe"

  - `name.givenName` (string,null)
    Recipient first name.

  - `name.familyName` (string,null)
    Recipient surname.

  - `name.middleName` (string,null)
    Recipient middle name.

  - `name.patronymicName` (string,null)
    Recipient patronymic name (when applicable).

  - `name.cannotHavePatronymicName` (boolean,null)
    Indicates if the recipient cannot have a patronymic name (when applicable).

  - `currency` (string)
    3 character currency code.
    Example: "GBP"

  - `country` (string)
    2 character country code.
    Example: "GB"

  - `type` (string)
    Recipient type.
    Example: "SortCode"

  - `legalEntityType` (string)
    Entity type of recipient.
    Example: "PERSON"

  - `active` (boolean)
    Status of the recipient.
    Example: true

  - `details` (object)
    Account details (currency/type-specific). The keys present vary by currency route and recipient type (e.g., sort code, IBAN, SWIFT, email).

  - `details.reference` (string,null)
    Recipient reference (present for some routes).

  - `details.sortCode` (string)
    Recipient bank sort code (GBP example).
    Example: "040075"

  - `details.accountNumber` (string)
    Recipient bank account number (GBP example).
    Example: "37778842"

  - `details.hashedByLooseHashAlgorithm` (string)
    Recipient account hash.
    Example: "ad245621b974efa3ef870895c3wer419a3f01af18a8a5790b47645dba6304194"

  - `commonFieldMap` (object)
    Map of key lookup fields on the account.
    Example: {"accountNumberField":"accountNumber","bankCodeField":"sortCode"}

  - `hash` (string)
    Account hash for change tracking.
    Example: "666ef880f8aa6113fa112ba6531d3ed2c26dd9fgbd7de5136bfb827a6e800479"

  - `accountSummary` (string)
    Summary of account details for ease of lookup.
    Example: "(04-00-75) 37778842"

  - `longAccountSummary` (string)
    Account details summary.
    Example: "GBP account ending in 8842"

  - `displayFields` (array)
    Lookup fields (key/label/value) for rendering a UI.
    Example: [{"key":"details/sortCode","label":"UK sort code","value":"04-00-75"},{"key":"details/accountNumber","label":"Account number","value":"37778842"}]

  - `displayFields.key` (string)
    Account identifier key name.

  - `displayFields.label` (string)
    Account identifier display label.

  - `displayFields.value` (string)
    Account identifier value.

  - `isInternal` (boolean)
    Indicates whether recipient is internal.

  - `ownedByCustomer` (boolean)
    If recipient account belongs to profile owner.

  - `confirmations` (object)
    Verification results for the recipient's details. Only populated for currencies with recipient verification enabled (KRW, INR, IDR, EUR). See the [Verifying Recipient Details](/guides/developer/api-guides/recipient-verification) guide for how to handle these.

  - `confirmations.acceptedOutcomes` (boolean)
    Whether we've received an explicit customer acceptance.

  - `confirmations.acceptedAt` (string,null)
    Timestamp indicating time of outcome acceptance, null if has not been accepted.

  - `confirmations.quoteId` (string,null)
    If the confirmation check was run as part of a quote compatibility check, then the quoteId will be on the result. If quoteId is present, then the outcome acceptance will need the quoteId to be specified as well.

  - `confirmations.outcomes` (array)
    Array of confirmation outcomes. At the moment it is safe to assume that there is only one element in the outcomes list.

  - `confirmations.outcomes.type` (string)
    The type of confirmation. Possible values: ACCOUNT_EXISTENCE, NAME_MATCHING, NAME_RESOLUTION.
    Example: "NAME_MATCHING"

  - `confirmations.outcomes.timestamp` (string)
    Timestamp of when the confirmation check was performed.
    Example: "2024-11-11T23:58:11.105916743Z"

  - `confirmations.outcomes.outcome` (string)
    The actual outcome of the confirmation. Possible values: SUCCESS, PARTIAL_FAILURE, FAILURE, COULD_NOT_CHECK.
    Example: "PARTIAL_FAILURE"

  - `confirmations.outcomes.requiresCustomerAcceptance` (boolean)
    Whether we require customer acceptance. Whether this value is true or false is dependent on the currency and the nature of the confirmation.
    Example: true

  - `confirmations.outcomes.fieldsChecked` (array)
    Fields we used to confirm the account.
    Example: ["name/fullName","details/accountNumber"]

  - `confirmations.outcomes.providedName` (string)
    The name that the customer provided when creating the recipient account. Only populated for NAME_MATCHING and NAME_RESOLUTION types for certain outcomes.
    Example: "John Doe"

  - `confirmations.outcomes.resolvedName` (string)
    The name that we resolved during name matching or name resolution.
    Example: "Joe Doe"

  - `confirmations.outcomes.message` (string)
    Customer facing message about the outcome of the check.
    Example: "The name entered is slightly different to the name on the account."

  - `confirmations.outcomes.recommendedUpdates` (array)
    Shows what are the correct values for some of the fields we've checked.

  - `confirmations.outcomes.recommendedUpdates.path` (string)
    The field path to update.
    Example: "name/fullName"

  - `confirmations.outcomes.recommendedUpdates.value` (string)
    The recommended value for the field.
    Example: "Joe Doe"