---
title: "aid_mgmnt_payout_destinations_get_by_id"
method: GET
path: "/accounts/{oid}/payout-destinations/{payout_destination_id}"
tags: ["payout-destinations"]
---

# aid_mgmnt_payout_destinations_get_by_id

`GET /accounts/{oid}/payout-destinations/{payout_destination_id}`

Get a payout destination by payout destination id

scopes:
- admin:accounts
- read:accounts

## Path parameters

- `oid` string, ^[PT]{1}(?=(?:.{3}|.{8})$)[0-9]*$, required
- `payout_destination_id` string, required

## Query parameters

- `includes` string[]

## Response `200`

Payout destination

- AuthPayoutDestination
  - `id` string, uuid, required — An UUID that uniquely identifies the resource
  - `created_at` string, date-time, required — The date-time when the resource was created
  - `created_by` string, required — The ID of the user/client created the resource
  - `updated_at` string, date-time, required — The date-time when the resource was last updated
  - `deleted_by` string — The ID of the user/client created the resource
  - `deleted_at` string, date-time
  - `payout_destination_id` string
  - `updated_by` string, required
  - `account_id` string, required
  - `case_status` 'ACTIVE' | 'DECLINED' | 'UNDER_MANUAL_REVIEW' | 'AUTOMATIC_REVIEW' | 'WAITING_FOR_SIGNATURE' | 'WAITING_FOR_DECLARATION' | 'ERROR' | 'ARCHIVED' | 'WAITING_FOR_DETAILS' | 'TERMINATED', required
  - `type` 'company' | 'individual', required — Type of legal entity
  - `merchant_category_code` string, mcc
  - `organization` object — Organization data for company type of payout destination
    - `organization_number` string, required
    - `name` string
    - `trade_name` string
  - `individual` Individual — Used only if `type` is `individual`.
    - `name` string
    - `birth_date` string, date
    - `phone_number` string
    - `email` string, email
    - `address_line` string
    - `address_line_2` string
    - `address_postal_code` string
    - `address_city` string
    - `address_country` string, iso-3166-1 — ISO 3166-1 country code
  - `address` Address
    - `address_line` string, required
    - `address_line_2` string
    - `postal_code` string
    - `postal_place` string, required
    - `country` string, iso-3166-1, required — ISO 3166-1 country code
  - `bank_accounts` PayoutDestinationBankAccount[] — Bank accounts associated with the payout destination.
    - `bank_name` string — Name of the Bank used
    - `bank_account_number` string — BBAN, national bank account number
    - `bank_account_number_type` 'IBAN' | 'BBAN' — The type of bank account number. Will default to BBAN in bank_country_code is norwegian. Will default to IBAN in all other countries.
    - `bank_account_country_code` string — Which country the bank account is registered in. Must be a two letter ISO 3166-1-alpha-2 country code. Supported bank account country codes: * `AT` (Austria) * `BE` (Belgium) * `HR` (Croatia) * `CY` (Cyprus) * `DK` (Denmark) * `EE` (Estonia) * `FI` (Finland) * `FR` (France) * `DE` (Germany) * `GR` (Greece) * `IE` (Ireland) * `IS` (Iceland) * `IT` (Italy) * `LV` (Latvia) * `LT` (Lithuania) * `LU` (Luxembourg) * `MT` (Malta) * `NL` (Netherlands) * `NO` (Norway) * `PT` (Portugal) * `SK` (Slovakia) * `SI` (Slovenia) * `ES` (Spain) * `SE` (Sweden) * `UK` (United Kingdoms) * `US` (United States of America)
    - `bank_account_currency` string, iso4217-code, required — The three-character ISO-4217 currency. https://en.wikipedia.org/wiki/ISO_4217
    - `bank_identification_code` string — A BIC code, or Bank Identifier Code also know as SWIFT code, consistin of 8 to 11 alphanumeric characters.
  - `payout_interval_type` 'day' | 'week' | 'month' | 'manual'
  - `payout_reference` string — Reference on transfers in bank statements
  - `email` string, email
  - `website` string, uri
  - `phone_number` string — ITU/E.123 format with international prefix (+PPNNNNNNNNN...)
  - `payout_destination_name` string — The name of the payout destination
  - `payout_destination_description` string — Description of the payout destination
  - `links` object[]
    - `href` string, uri — The URL of the link.
    - `rel` 'contract_url' | 'cdd_case_url' | 'dintero_cdd_case_url' | 'declaration_url' | 'signed_contract_file_url' — Specifies the type of link
  - `number_of_stores` integer — Number of stores associated with the payout destination
  - `number_of_terminals` integer — Number of terminals associated with the payout destination
  - `terminals` object[] — Terminals associated with the payout destination
    - `terminal_id` string, required
    - `device_serial_number` string, required
    - `status` 'DELETED' | 'PENDING' | 'ACTION_REQUIRED' | 'ACTIVE' | 'INACTIVE' | 'ERROR' — The status of the terminal
  - `stores` object[] — Stores associated with the payout destination
    - `store_id` string, required
    - `store_name` string
    - `address` Address
      - `address_line` string, required
      - `address_line_2` string
      - `postal_code` string
      - `postal_place` string, required
      - `country` string, iso-3166-1, required — ISO 3166-1 country code
    - `number_of_terminals` integer

## Other responses

- `400` — Bad / Invalid request
- `401` — Access forbidden, invalid JWT token was used
- `403` — Forbidden
- `404` — Resource was not found
- `500` — Unexpected Error

---

[API](https://skmtc.net/dintero/apis/account-management-api.md) · [All operations](https://skmtc.net/dintero/apis/account-management-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/dintero/account-management-api/revisions/9b83a4199008/schema)