> ## Documentation Index > Fetch the complete documentation index at: https://docs.pushcash.com/llms.txt > Use this file to discover all available pages before exploring further. # Retrieve a transfer > Retrieves a specific transfer by its ID. ## OpenAPI ````yaml /openapi.yaml get /transfer/{id} openapi: 3.0.1 info: title: Push API version: 0.0.1 servers: - url: https://api.pushcash.com description: Production API - url: https://sandbox.pushcash.com description: Sandbox API used for developing an integration with Push security: - bearer: [] tags: - name: user - name: tokenization - name: authorization - name: intent - name: dispute - name: refund - name: ledger description: >- Accounts, transactions, and transfers — the records that make up the Push ledger. - name: simulation paths: /transfer/{id}: get: tags: - ledger summary: Retrieve a transfer description: Retrieves a specific transfer by its ID. operationId: getTransfer parameters: - in: path name: id description: The ID of the transfer to retrieve. required: true schema: type: string responses: '200': description: Successful operation content: application/json: schema: $ref: '#/components/schemas/Transfer' default: description: Error content: application/json: schema: $ref: '#/components/schemas/error' components: schemas: Transfer: type: object example: id: transfer_xle830ef8djeoiu amount: 700284 currency: USD direction: disbursement created_at: '2023-05-24T20:15:18.158Z' date: '2023-05-24' transactions: - id: txn_230vjroij4985uefjoiu9 amount: 700284 direction: cash_in currency: USD status: settled type: intent source_id: intent_sandbox_dMggQ93ZYH6DH9LBhVeijE account_id: account_WsELzpJOvU6fNafvzWbF6K created_at: '2023-05-24T20:15:18.158Z' date: '2023-05-23' account: id: account_WsELzpJOvU6fNafvzWbF6K type: settlement name: Settlement Account created_at: '2023-05-24T20:15:18.158Z' properties: id: type: string description: The unique identifier assigned by Push, prefixed with "transfer_". amount: type: integer minimum: 0 description: > Net amount of the transfer in the smallest currency unit (for USD, integer cents). Equal to the net of its constituent transactions. Use `direction` to determine whether the funds moved to or from your operational account. currency: $ref: '#/components/schemas/Currency' direction: $ref: '#/components/schemas/TransferDirection' created_at: type: string format: date-time description: When the transfer was created (ISO 8601 timestamp). date: type: string format: date description: The settlement date of the transfer. transactions: type: array description: > The exact set of transactions settled by this transfer. Their amounts net to the transfer `amount` — each settled transaction belongs to exactly one transfer. items: $ref: '#/components/schemas/Transaction' account: $ref: '#/components/schemas/Account' required: - id - amount - currency - direction - created_at - date - transactions - account error: description: Description of the error encountered from the API request type: object Currency: type: string description: Currency associated with the amount enum: - USD TransferDirection: type: string description: > The direction of the net movement of funds between Push and your operational account. - `disbursement`: a net payout to your operational account (occurs when cash_in exceeds cash_out) - `collection`: a net withdrawal from your operational account (occurs when cash_out exceeds cash_in) enum: - disbursement - collection Transaction: type: object example: id: txn_CpiSd1bptYB5P55ysTDHg amount: 11000 direction: cash_out currency: USD status: settled type: intent source_id: intent_sandbox_dMggQ93ZYH6DH9LBhVeijE account_id: account_WsELzpJOvU6fNafvzWbF6K created_at: '2023-05-24T20:15:18.158Z' date: '2023-05-24' transfer: id: transfer_xle830ef8djeoiu amount: 123000 currency: USD direction: collection created_at: '2023-05-24T20:15:18.158Z' date: '2023-05-24' properties: id: type: string description: The unique identifier assigned by Push, prefixed with "txn_". amount: type: integer minimum: 0 description: > Amount of the transaction in the smallest currency unit (for USD, integer cents). Always non-negative — use `direction` to determine which way the money moved. direction: $ref: '#/components/schemas/Direction' currency: $ref: '#/components/schemas/Currency' status: $ref: '#/components/schemas/TransactionStatus' type: $ref: '#/components/schemas/TransactionType' source_id: type: string nullable: true description: >- The ID of the intent, refund, or dispute that created this transaction. Read together with `type` to locate the source object. account_id: type: string description: The ID of the account the transaction settles against. created_at: type: string format: date-time description: When the transaction was recorded (ISO 8601 timestamp). date: type: string format: date description: >- The settlement window (the Eastern-time day) in which the transaction was submitted to Push. See the [Ledger guide](https://docs.pushcash.com/ledger#settlement-schedule) for how windows map to settlement dates. transfer: nullable: true allOf: - $ref: '#/components/schemas/TransferSummary' description: >- The transfer that settles this transaction. Populated once the transaction reaches `in_transfer` or `settled`; `null` beforehand. required: - id - amount - direction - currency - status - type - source_id - account_id - created_at - date Account: type: object example: id: account_WsELzpJOvU6fNafvzWbF6K type: settlement name: Settlement Account created_at: '2023-05-24T20:15:18.158Z' properties: id: type: string description: The unique identifier assigned by Push type: type: string description: The type of account. name: type: string description: The name of the account created_at: type: string format: date-time description: When the account was created (ISO 8061 date string) required: - id - type - name - created_at Direction: type: string description: | Direction of the payment. - Submit `cash_in` for deposits - Submit `cash_out` for withdrawals enum: - cash_in - cash_out TransactionStatus: type: string description: > The stage of the transaction in its settlement lifecycle. The set of stages a transaction moves through depends on its `direction`: - `cash_in`: pending → available → settled (`available` is cash_in only) - `cash_out`: pending → in_transfer → settled (`in_transfer` is cash_out only) enum: - pending - available - in_transfer - settled x-enumDescriptions: pending: >- The transaction has been recorded but the funds have not yet been confirmed by the network. For cash_in, the funds have not yet arrived; for cash_out, the payment has been recorded but not yet included in a transfer. available: >- cash_in only. The funds have been confirmed by the network and are eligible for settlement, but have not yet been placed into a transfer. in_transfer: >- cash_out only. The transaction has been batched into a transfer that is being settled — the funds are being collected from your operational account. settled: >- Final status. The transfer containing the transaction has settled with the network — for cash_in the funds have been transmitted, and for cash_out the network has confirmed the counterparty received the funds. TransactionType: type: string description: The type of activity that created the transaction. enum: - intent - refund - dispute x-enumDescriptions: intent: A transaction created when Push approves a payment intent. refund: A transaction created when a refund is issued. dispute: A transaction created to record a dispute, such as a returned payment. TransferSummary: type: object description: > A summary of the transfer that settles a transaction. This is the shape embedded on a transaction's `transfer` field. Retrieve the full transfer, including its constituent transactions, from the transfer endpoints. example: id: transfer_xle830ef8djeoiu amount: 123000 currency: USD direction: collection created_at: '2023-05-24T20:15:18.158Z' date: '2023-05-24' properties: id: type: string description: The unique identifier assigned by Push, prefixed with "transfer_". amount: type: integer minimum: 0 description: >- Net amount of the transfer in the smallest currency unit (for USD, integer cents). currency: $ref: '#/components/schemas/Currency' direction: $ref: '#/components/schemas/TransferDirection' created_at: type: string format: date-time description: When the transfer was created (ISO 8601 timestamp). date: type: string format: date description: The settlement date of the transfer. required: - id - amount - currency - direction - created_at - date securitySchemes: bearer: type: http scheme: bearer ````