> ## Documentation Index > Fetch the complete documentation index at: https://docs.trio.com.br/llms.txt > Use this file to discover all available pages before exploring further. # Get Transfer > Gets a transfer document ## OpenAPI ````yaml v2/api-reference/openapi.json GET /v2/documents/transfer/{id} openapi: 3.0.0 info: title: Trio API v2 version: 2026-10-19.v2 servers: - url: https://api.sandbox.trio.com.br variables: {} - url: https://api.qa.trio.com.br variables: {} - url: https://api.trio.com.br variables: {} security: [] tags: [] paths: /v2/documents/transfer/{id}: parameters: - description: >- Version of the v2 contract the client is written against. Each breaking change publishes a new version. example: 2026-10-19.v2 in: header name: Trio-Version required: true schema: enum: - 2026-10-19.v2 type: string x-struct: null x-validate: null - description: >- ID of another org to act on instead of the API key's own org. The key's org must have been granted access to it, and the request is refused with 403 FORBIDDEN otherwise. When that access or the API key is read-only, only GET and HEAD requests may carry it. When the target org requires mTLS, so does the request. Leave it out to act on the key's own org. in: header name: Trio-Target-Org-Id required: false schema: format: uuid type: string x-struct: null x-validate: null get: tags: - Documents - Transfer summary: Get a transfer document description: Gets a transfer document operationId: TrioFoundationWeb.V2.Documents.TransferController.show parameters: - description: Document UUID in: path name: id required: true schema: $ref: '#/components/schemas/UUID' responses: '200': content: application/json: schema: $ref: '#/components/schemas/V2_transfer_document_response' description: Document '400': content: application/json: schema: $ref: '#/components/schemas/V2_error' description: >- Malformed request: a body that is not valid JSON (MALFORMED_REQUEST), or a Trio-Version header that is missing or not the current one (INVALID_TRIO_VERSION). '401': content: application/json: schema: $ref: '#/components/schemas/V2_error' description: Missing or invalid API key credentials (INVALID_CREDENTIALS). '403': content: application/json: schema: $ref: '#/components/schemas/V2_error' description: >- The API key may not do this (FORBIDDEN): for instance Trio-Target-Org-Id names an org it has no access to, or writes through a read-only access. '404': content: application/json: schema: $ref: '#/components/schemas/V2_error' description: No resource with this ID (NOT_FOUND_RESOURCE). '422': content: application/json: schema: $ref: '#/components/schemas/V2_error' description: >- Invalid input (INVALID_PARAMETER, REQUIRED_PARAMETER, or the code of the rule the request breaks). A request outside the operation's schema lists the offending fields in `errors`. '503': content: application/json: schema: $ref: '#/components/schemas/V2_error' description: >- A service needed to answer is unavailable (TRIO_SERVICE_UNAVAILABLE). callbacks: {} security: - authorization: [] components: schemas: UUID: description: Unique identifier format: uuid title: UUID type: string x-struct: null x-validate: null V2_transfer_document_response: description: Transfer document response example: data: amount: amount: 1 currency: BRL description: Transferência interna external_id: 01M4H104PKKZ0CGC013Y8FE4G2 from_bank_account_id: 019ddfe9-e64b-b642-36fd-efdaef77d05e id: 01a12210-33a8-ae95-5333-213dfa0bda47 inserted_at: '2026-10-09T19:07:29.576442Z' origin: id: d4abaabe-5ebf-4628-ba34-5a1b17da4c6b type: console_user reconciliation_id: 01a12210-33a8-2e7e-1d38-9e7eb34e6946 stages: - error_code: null error_message: null id: 01a12210-33a8-5cca-32f5-c8662a1e8c40 inserted_at: '2026-10-09T19:07:29.576442Z' status: created - error_code: null error_message: null id: 01a12210-33a8-b520-e507-7f570c825c11 inserted_at: '2026-10-09T19:07:29.576442Z' status: settled status: settled to_bank_account_id: 01a1220f-79cc-5e5d-4342-b78b9dacd592 transaction_date: '2026-10-09T19:07:29.778267Z' updated_at: '2026-10-09T19:07:29.778267Z' properties: data: $ref: '#/components/schemas/V2_transfer_document' title: V2 transfer document response type: object x-struct: Elixir.TrioFoundationWeb.Schemas.Banking.V2.Transfer.Response x-validate: null V2_error: example: error: error_code: INVALID_PARAMETER error_message: 'Invalid parameters: /amount: Invalid integer. Got: string' errors: - field: /amount message: 'Invalid integer. Got: string' properties: error: properties: error_code: description: >- Stable UPPER_SNAKE identifier of the error, for programs and logs. Branch on this, not on the message. type: string x-struct: null x-validate: null error_message: description: Human readable explanation of the error. type: string x-struct: null x-validate: null errors: description: >- Only on INVALID_PARAMETER for a request outside the operation's schema: one entry per offending field. items: properties: field: description: JSON pointer to the field, e.g. /amount. type: string x-struct: null x-validate: null message: description: What is wrong with it. type: string x-struct: null x-validate: null required: - field - message type: object x-struct: null x-validate: null type: array x-struct: null x-validate: null required: - error_code - error_message type: object x-struct: null x-validate: null required: - error title: V2 error type: object x-struct: Elixir.TrioFoundationWeb.Schemas.HTTP.V2Error x-validate: null V2_transfer_document: description: >- Transfer document, as returned by the listing and show. `from_bank_account_id` and `to_bank_account_id` are the accounts it moves money between. example: amount: amount: 1 currency: BRL description: Transferência interna external_id: 01M4H104PKKZ0CGC013Y8FE4G2 from_bank_account_id: 019ddfe9-e64b-b642-36fd-efdaef77d05e id: 01a12210-33a8-ae95-5333-213dfa0bda47 inserted_at: '2026-10-09T19:07:29.576442Z' origin: id: d4abaabe-5ebf-4628-ba34-5a1b17da4c6b type: console_user reconciliation_id: 01a12210-33a8-2e7e-1d38-9e7eb34e6946 stages: - error_code: null error_message: null id: 01a12210-33a8-5cca-32f5-c8662a1e8c40 inserted_at: '2026-10-09T19:07:29.576442Z' status: created - error_code: null error_message: null id: 01a12210-33a8-b520-e507-7f570c825c11 inserted_at: '2026-10-09T19:07:29.576442Z' status: settled status: settled to_bank_account_id: 01a1220f-79cc-5e5d-4342-b78b9dacd592 transaction_date: '2026-10-09T19:07:29.778267Z' updated_at: '2026-10-09T19:07:29.778267Z' properties: amount: description: Amount properties: amount: description: Amount integer minimum: 1 type: integer x-struct: null x-validate: null currency: description: Amount currency string type: string x-struct: null x-validate: null type: object x-struct: null x-validate: null description: description: Description type: string x-struct: null x-validate: null external_id: description: External ID nullable: true type: string x-struct: null x-validate: null from_bank_account_id: description: From bank account ID format: uuid type: string x-struct: null x-validate: null id: description: Unique identifier format: uuid type: string x-struct: null x-validate: null inserted_at: description: When the transfer was created format: date-time type: string x-struct: null x-validate: null origin: description: Who or what originated the transfer properties: id: description: Origin ID format: uuid nullable: true type: string x-struct: null x-validate: null type: description: Origin type enum: - none - api_client - console_user - billing - reconciliation - checkout - bridge type: string x-struct: null x-validate: null type: object x-struct: null x-validate: null reconciliation_id: description: Reconciliation UUID format: uuid nullable: true type: string x-struct: null x-validate: null stages: description: Transfer document stages items: $ref: '#/components/schemas/V2_stage_of_a_transfer_document' type: array x-struct: null x-validate: null status: $ref: '#/components/schemas/V2_transfer_document_status' to_bank_account_id: description: To bank account ID format: uuid type: string x-struct: null x-validate: null transaction_date: description: Transfer document transaction date format: date-time nullable: true type: string x-struct: null x-validate: null updated_at: description: When the transfer was last updated format: date-time type: string x-struct: null x-validate: null title: V2 transfer document type: object x-struct: Elixir.TrioFoundationWeb.Schemas.Banking.V2.Transfer.TransferData x-validate: null V2_stage_of_a_transfer_document: description: Stage of a transfer document example: error_code: null error_message: null id: 01a12210-33a8-b520-e507-7f570c825c11 inserted_at: '2026-10-09T19:07:29.576442Z' status: settled properties: error_code: description: Error code when stage represents an error nullable: true type: string x-struct: null x-validate: null error_message: description: Error message detail when stage represents an error nullable: true type: string x-struct: null x-validate: null id: description: Stage ID format: uuid type: string x-struct: null x-validate: null inserted_at: description: When the stage was recorded format: date-time type: string x-struct: null x-validate: null status: description: Status the transfer reached at this stage enum: - created - confirmed - settled - failed - refund_link type: string x-struct: null x-validate: null title: V2 stage of a transfer document type: object x-struct: Elixir.TrioFoundationWeb.Schemas.Banking.V2.Transfer.StageResponse x-validate: null V2_transfer_document_status: description: Status of the transfer document enum: - created - confirmed - settled - refunded - reversed - failed title: V2 transfer document status type: string x-struct: null x-validate: null securitySchemes: authorization: scheme: basic type: http ```` This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.