> ## Documentation Index > Fetch the complete documentation index at: https://docs.cadanapay.com/llms.txt > Use this file to discover all available pages before exploring further. # Create Transfer > Move money between your own business accounts — your main business and its child businesses — internally and same-currency only. Settles immediately with no fee. Set `sourceTenantKey` to the business funds move from (omit it to send from your main business) and `destinationTenantKey` to the business they move to. Allowed movements are main → child, child → child, and child → main. There is no `GET` for a transfer — track it via the [platform disbursements endpoint](/api-reference/workforce/platform/list-disbursements) filtered to `type=TRANSFER`, matching the returned `id` or your `reference`. ## OpenAPI ````yaml /openapi/workforce-management.yaml post /v1/platform/transfers openapi: 3.0.0 info: description: APIs for interacting with Cadana Payroll Platform version: 1.0.0 title: Business Workforce Management termsOfService: https://cadanapay.com/terms-and-conditions contact: email: api@cadanapay.com license: name: Apache 2.0 url: http://www.apache.org/licenses/LICENSE-2.0.html servers: - url: https://api.cadanapay.com description: Prod Server - url: https://dev-api.cadanapay.com description: Dev Server security: - Authorization: [] tags: - name: Custom Auth description: APIs for interacting with Custom Authentication - name: Persons description: APIs for interacting with the HR module - name: Milestones description: APIs for milestone-based contractor pay - name: Instant Pay description: APIs for interacting with Instant Pay functionality - name: Users description: APIs for interacting with employee/contractor Cadana accounts - name: Files description: APIs for interacting with file uploads - name: Payrolls description: APIs for interacting with Payroll - name: Platform description: Platform APIs for interacting with businesses - name: Businesses description: APIs for interacting with Business - name: Treasury description: APIs for business balances, funding, and withdrawals - name: KYB description: APIs for business verification - name: Contracts description: APIs for interacting with contracts - name: Sandbox description: APIs for relevant sandbox simulations - name: Invoices description: APIs for interacting with invoices - name: Reimbursements description: APIs for interacting with reimbursements - name: Entities description: >- APIs for managing legal sub-entities (subsidiaries, branches) under a parent business paths: /v1/platform/transfers: post: tags: - Platform summary: Create Transfer description: > Move money between your own business accounts — your main business and its child businesses — internally and same-currency only. Settles immediately with no fee. Set `sourceTenantKey` to the business funds move from (omit it to send from your main business) and `destinationTenantKey` to the business they move to. Allowed movements are main → child, child → child, and child → main. There is no `GET` for a transfer — track it via the [platform disbursements endpoint](/api-reference/workforce/platform/list-disbursements) filtered to `type=TRANSFER`, matching the returned `id` or your `reference`. operationId: createPlatformTransfer requestBody: required: true content: application/json: schema: $ref: '#/components/schemas/CreateTransferRequest' examples: transferRequest: summary: Example transfer request value: sourceTenantKey: blm123456 destinationTenantKey: blm998877 amount: amount: 500000 currency: USD reference: transfer-123 responses: '200': $ref: '#/components/responses/CreatePlatformTransferResponse' '400': $ref: '#/components/responses/BadRequestError' '403': $ref: '#/components/responses/ForbiddenError' 5XX: $ref: '#/components/responses/InternalError' security: - Authorization: [] components: schemas: CreateTransferRequest: type: object required: - destinationTenantKey - amount - reference properties: sourceTenantKey: type: string description: >- The business funds move from. Omit to send from your main business, or pass a child business's tenant key. example: blm123456 destinationTenantKey: type: string description: >- The business funds move to — a child business or your main business. Cannot equal the source. example: blm998877 amount: type: object required: - amount - currency properties: amount: type: integer description: Value in the lowest denomination of the currency (e.g. cents) example: 500000 currency: type: string description: >- ISO 4217 code. Source and destination must match — cross-currency is not supported. example: USD reference: type: string description: >- Your client reference for the transfer. Stored on it so you can locate it later. example: transfer-123 BadRequestError: description: Bad input provided by client allOf: - $ref: '#/components/schemas/Error' - type: object properties: params: description: A map for meta data around the error that occurred type: object example: code: invalid_request_body message: The request body provided is not valid params: field: Value is invalid. ForbiddenError: description: Forbidden allOf: - $ref: '#/components/schemas/Error' example: code: forbidden message: Transfers are only available to platform businesses. InternalError: description: Internal server error allOf: - $ref: '#/components/schemas/Error' example: code: internal_error message: An unexpected error occurred. Please try again later. Error: type: object properties: code: description: A machine parsable error code type: string enum: - invalid_request_body - resource_not_found - forbidden - internal_error message: description: A human readable message describing the error type: string responses: CreatePlatformTransferResponse: description: Transfer created response content: application/json: schema: type: object properties: id: type: string format: uuid description: >- The transfer id. Track it via the platform disbursements endpoint filtered to `type=TRANSFER`. example: 9b2c1f47-8a0d-4e21-bf3c-2d6f1a9e74c5 examples: transfer: summary: Example transfer creation response value: id: 9b2c1f47-8a0d-4e21-bf3c-2d6f1a9e74c5 BadRequestError: description: Bad input provided by client content: application/json: schema: $ref: '#/components/schemas/BadRequestError' ForbiddenError: description: The caller is not permitted to perform this action content: application/json: schema: $ref: '#/components/schemas/ForbiddenError' InternalError: description: Internal error content: application/json: schema: $ref: '#/components/schemas/InternalError' securitySchemes: Authorization: type: http scheme: bearer bearerFormat: API_SECRET_KEY ````