---
title: "POST /recipients/{recipient_id}/onboardings/{onboarding_id}/transfer"
method: POST
path: "/recipients/{recipient_id}/onboardings/{onboarding_id}/transfer"
---

# POST /recipients/{recipient_id}/onboardings/{onboarding_id}/transfer

`POST /recipients/{recipient_id}/onboardings/{onboarding_id}/transfer`

## Path parameters

- `recipient_id` string, required
- `onboarding_id` string, required

## Headers

- `X-organization-code` string, required
- `X-Idempotency-Key` string, required

## Response `201`

Created

- object
  - `id` string
  - `origin_onboarding` object
    - `id` string
    - `type` string
    - `workflow` string
    - `description` string
    - `status` string
    - `response_message` unknown
    - `callback_url` string
    - `provider` object
      - `id` string
      - `connection_id` string
      - `recipient_id` string
      - `redirect_url` unknown
      - `onboarding_url` string
      - `legal_entity` unknown
      - `recipient_additional_id` unknown
      - `balance_account_id` string
      - `recipient_type` unknown
      - `raw_notification` unknown
      - `raw_response` unknown
      - `response_code` unknown
      - `response_message` unknown
    - `documentation` object[]
      - `file_name` string
      - `content_type` string
      - `content_category` string
      - `content` string
    - `legal_representatives` object[]
      - `merchant_reference` string
      - `first_name` string
      - `last_name` string
      - `email` string
      - `date_of_birth` string
      - `country` string
      - `nationality` string
      - `title` string
      - `publicly_exposed_person` boolean
      - `ultimate_beneficial_owner` boolean
      - `document` object
        - `document_type` string
        - `document_number` string
      - `phone` object
        - `number` string
        - `country_code` string
      - `address` object
        - `address_line_1` string
        - `address_line_2` string
        - `country` string
        - `state` string
        - `city` string
        - `zip_code` string
        - `neighborhood` string
    - `metadata` object[]
      - `key` string
      - `value` string
    - `withdrawal_methods` object
      - `bank` object
        - `code` string
        - `branch` string
        - `branch_digit` string
        - `account` string
        - `account_digit` string
        - `account_type` string
        - `routing` string
        - `country` string
        - `currency` string
        - `payout_schedule` string
    - `terms_of_service` object
      - `acceptance` boolean
      - `date` string
      - `ip` string
    - `created_at` string
    - `updated_at` string
  - `destination_onboarding` object
    - `id` string
    - `type` string
    - `workflow` string
    - `description` string
    - `status` string
    - `response_message` unknown
    - `callback_url` string
    - `provider` object
      - `id` string
      - `connection_id` string
      - `recipient_id` string
      - `redirect_url` unknown
      - `onboarding_url` string
      - `legal_entity` unknown
      - `recipient_additional_id` unknown
      - `balance_account_id` string
      - `recipient_type` unknown
      - `raw_notification` unknown
      - `raw_response` unknown
      - `response_code` unknown
      - `response_message` unknown
    - `documentation` object[]
      - `file_name` string
      - `content_type` string
      - `content_category` string
      - `content` string
    - `legal_representatives` object[]
      - `merchant_reference` string
      - `first_name` string
      - `last_name` string
      - `email` string
      - `date_of_birth` string
      - `country` string
      - `nationality` string
      - `title` string
      - `publicly_exposed_person` boolean
      - `ultimate_beneficial_owner` boolean
      - `document` object
        - `document_type` string
        - `document_number` string
      - `phone` object
        - `number` string
        - `country_code` string
      - `address` object
        - `address_line_1` string
        - `address_line_2` string
        - `country` string
        - `state` string
        - `city` string
        - `zip_code` string
        - `neighborhood` string
    - `metadata` object[]
      - `key` string
      - `value` string
    - `withdrawal_methods` object
      - `bank` object
        - `code` string
        - `branch` string
        - `branch_digit` string
        - `account` string
        - `account_digit` string
        - `account_type` string
        - `routing` string
        - `country` string
        - `currency` string
        - `payout_schedule` string
    - `terms_of_service` object
      - `acceptance` boolean
      - `date` string
      - `ip` string
    - `created_at` string
    - `updated_at` string
  - `created_at` string
  - `updated_at` string

## Other responses

- `400` — Bad Request
- `401` — Unauthorized
- `403` — Forbidden

---

[API](https://skmtc.net/y/apis/ai-caller.md) · [All operations](https://skmtc.net/y/apis/ai-caller/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/y/ai-caller/revisions/05b629819b49/schema)