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

# aid_mgmnt_payout_destinations_get

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

Get list of payout destinations

scopes:
  - admin:accounts
  - read:accounts

## Path parameters

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

## Query parameters

- `starting_after` string
- `limit` integer
- `search` string
- `case_status` string[]
- `country` string[]
- `store_id` string[]
- `terminal_id` string[]

## Response `200`

List of payout destinations

- AuthPayoutDestinationCollection — Collection of payout destinations.
  - `starting_after` string
  - `payout_destinations` AuthPayoutDestinationCollectionEntity[], required
    - `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

## Other responses

- `400` — Bad / Invalid request
- `401` — Access forbidden, invalid JWT token was used
- `403` — Forbidden
- `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/versions/9b83a4199008/schema)