> ## Documentation Index > Fetch the complete documentation index at: https://developer.fin.com/llms.txt > Use this file to discover all available pages before exploring further. # Fetch a Transfer V2 > Retrieve a transfer payout and its current status by `transfer_id`. Use this endpoint to check where a transfer stands after you create it. ## Status values | `status` | Meaning | | :- | :- | | `CREATED` | The transfer exists but has not been settled. There is no `transaction_id` yet. | | `PENDING` | The transfer was settled and the payout is processing. | | `COMPLETED` | The payout finished. | | `FAILED` | The settlement or payout failed. See `reason`. | > [!NOTE] > > A transfer that passes its `expire_at` without being settled keeps the `CREATED` status. The response does not change. ## Following the payout `transaction_id` appears once the transfer is settled. It is the same ID the settle endpoint returned, so you can pass it to [Fetch Transaction Details V3](https://developer.fin.com/api-reference/transactions/fetch-transaction-details-v3.md) for the full transaction. ## OpenAPI ````yaml GET /v2/transactions/transfer-payout/{transfer_id} openapi: 3.1.0 info: title: Fin.com API version: 1.0.0 description: >- A simple API specification for Fin.com, a financial services platform that provides a range of banking and payment solutions for businesses and individuals. This API allows developers to integrate Fin.com's services into their applications, enabling functionalities such as customer management, transaction processing, and access to financial data. servers: - url: https://sandbox.api.fin.com description: Sandbox server - url: https://api.fin.com description: Production server security: [] tags: - name: Authentication description: A modified OAuth 2.0 Client Credential Flow - name: Customers description: Customer management and document upload operations - name: Balances description: Retrieve wallet balance information - name: Catalogue description: | A set of endpoints to retrieve contextual data to assemble requests to fin.com's API - name: Beneficiaries description: Manage beneficiary accounts for payments and transfers - name: Transactions description: Transaction history and management for beneficiaries - name: Virtual Accounts description: Create and manage virtual accounts for USD to USDC conversions - name: Fees & FX Rates description: Retrieve fees and foreign exchange rates - name: Crypto Orchestration description: >- Accept crypto deposits from exchange and external wallets and settle them to a destination wallet paths: /v2/transactions/transfer-payout/{transfer_id}: get: tags: - Transactions summary: Fetch a Transfer V2 description: Retrieve a transfer payout and its current status by `transfer_id`. parameters: - name: transfer_id in: path required: true description: The `transfer_id` returned when the transfer was created. schema: type: string format: uuid example: c78dee10-7c46-4ad5-8ac8-070e39d87ff1 responses: '200': description: Transfer retrieved successfully content: application/json: schema: type: object properties: data: type: object properties: transfer_id: type: string format: uuid example: c78dee10-7c46-4ad5-8ac8-070e39d87ff1 beneficiary_id: type: string format: uuid example: e710eb60-f1cd-4e70-94df-6b99a7fcf58d source_amount: type: integer description: Amount to debit, in cents of the source currency. example: 2000 source_currency: type: string enum: - USD - USDC example: USD deduct_from: type: string enum: - PREFUNDED_BALANCE - LIQUIDATION_ADDRESS example: PREFUNDED_BALANCE status: type: string enum: - CREATED - PENDING - COMPLETED - FAILED description: >- `CREATED` until the transfer is settled, including after `expire_at`. `PENDING` while the payout is processing, then `COMPLETED` or `FAILED`. example: PENDING transaction_id: type: string format: uuid description: >- Present once the transfer has been settled. This is the same ID the settle endpoint returned. example: 5b0d7a51-2f7e-4c3b-9a1d-8e6f2c4b7a90 remarks: type: string example: Monthly payment for services reason: type: string description: >- Why the transfer failed. Present only when `status` is `FAILED`. example: 'v2 settlement failed: ' created_at: type: string format: date-time example: '2026-11-13T07:35:53Z' expire_at: type: string format: date-time example: '2026-11-13T07:45:53Z' examples: Created: summary: Created, not settled yet value: data: transfer_id: c78dee10-7c46-4ad5-8ac8-070e39d87ff1 beneficiary_id: e710eb60-f1cd-4e70-94df-6b99a7fcf58d source_amount: 2000 source_currency: USD deduct_from: PREFUNDED_BALANCE status: CREATED remarks: Monthly payment for services created_at: '2026-11-13T07:35:53Z' expire_at: '2026-11-13T07:45:53Z' Settled: summary: Settled value: data: transfer_id: c78dee10-7c46-4ad5-8ac8-070e39d87ff1 beneficiary_id: e710eb60-f1cd-4e70-94df-6b99a7fcf58d source_amount: 2000 source_currency: USD deduct_from: PREFUNDED_BALANCE status: PENDING transaction_id: 5b0d7a51-2f7e-4c3b-9a1d-8e6f2c4b7a90 remarks: Monthly payment for services created_at: '2026-11-13T07:35:53Z' expire_at: '2026-11-13T07:45:53Z' Settle failed: summary: Settle failed value: data: transfer_id: c78dee10-7c46-4ad5-8ac8-070e39d87ff1 beneficiary_id: e710eb60-f1cd-4e70-94df-6b99a7fcf58d source_amount: 2000 source_currency: USD deduct_from: PREFUNDED_BALANCE status: FAILED remarks: Monthly payment for services reason: 'v2 settlement failed: ' created_at: '2026-11-13T07:35:53Z' expire_at: '2026-11-13T07:45:53Z' '401': $ref: '#/components/responses/AuthenticationError' '404': $ref: '#/components/responses/NotFoundError' security: - bearerAuth: [] components: responses: AuthenticationError: description: Authentication failed due to invalid credentials content: application/json: schema: type: object properties: message: type: string example: Authentication failed NotFoundError: description: Resource not found content: application/json: schema: type: object properties: message: type: string example: Resource not found securitySchemes: bearerAuth: type: http scheme: bearer bearerFormat: JWT description: >- Bearer token authentication. Obtain token from [Issue a Token](https://developer.fin.com/api-reference/authentication/issue-a-token) endpoint ```` This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.