> ## Documentation Index > Fetch the complete documentation index at: https://docs.orqex.com/llms.txt > Use this file to discover all available pages before exploring further. # Retrieve a payout > The stored state of a payout. ## OpenAPI ````yaml /api-reference/openapi.json get /payouts/{payoutId} openapi: 3.1.0 info: title: Orqex Orchestrate API version: 1.0.0 description: >- The Orqex Orchestrate API for collecting payments and sending payouts. Authenticate with a secret key as a bearer token; the key also selects the environment. Amounts are in major units everywhere: `50` means 50.00. Writes accept an `X-Idempotency-Key` header. Lists are cursor-paginated. Which countries, currencies and payment methods are available depends on your project configuration: read them from the discovery endpoints at payment time, or look them up in your dashboard. contact: name: Orqex Orchestrate url: https://orqex.com servers: - url: https://api.orqex.com/v1 description: Production security: - bearerAuth: [] tags: - name: Checkout description: Hosted checkout sessions. - name: Payment intents description: Payments, discovery and reconciliation. - name: Payment attempts description: Collecting a payment and confirming it. - name: Refunds description: Returning money to a payer. - name: Payouts description: Sending money out. - name: Utilities description: Exchange rates and method status. paths: /payouts/{payoutId}: get: tags: - Payouts summary: Retrieve a payout description: The stored state of a payout. operationId: getPayout parameters: - name: payoutId in: path required: true description: The payout id. schema: type: string responses: '200': description: The payout. content: application/json: schema: type: object properties: data: $ref: '#/components/schemas/Payout' '401': description: Missing, invalid, inactive or expired API key. content: application/json: schema: $ref: '#/components/schemas/Error' '403': description: The request address is not on the API key's allowlist. content: application/json: schema: $ref: '#/components/schemas/Error' '404': description: Resource not found. content: application/json: schema: $ref: '#/components/schemas/Error' '429': description: Rate limit exceeded (100 requests per minute per key). content: application/json: schema: $ref: '#/components/schemas/Error' components: schemas: Payout: type: object properties: id: type: string example: po_6Cw1Rh amount: $ref: '#/components/schemas/Amount' method: $ref: '#/components/schemas/PaymentMethod' status: type: string enum: - pending - processing - completed - failed reference: type: - string - 'null' example: batch-42-line-7 description: type: - string - 'null' webhook_url: type: - string - 'null' description: The notification URL supplied at creation. customer: $ref: '#/components/schemas/Customer' instrument: $ref: '#/components/schemas/PayoutInstrument' gateway: $ref: '#/components/schemas/GatewayTransaction' fee_amount: type: - integer - 'null' description: >- Provider fee as a plain integer in minor units. Unlike `amount`, this is not an Amount object. failure: $ref: '#/components/schemas/Failure' metadata: type: - object - 'null' additionalProperties: true initiated_at: type: - string - 'null' format: date-time completed_at: type: - string - 'null' format: date-time failed_at: type: - string - 'null' format: date-time created_at: type: - string - 'null' format: date-time Error: type: object properties: message: type: string Amount: type: object properties: value: type: - number - 'null' example: 50 formatted: type: - string - 'null' example: $50.00 short: type: - string - 'null' example: $50 currency: type: - string - 'null' example: USD PaymentMethod: type: object description: >- A payment method available for this payment. Method codes are discovered at runtime and must not be hard-coded. properties: value: type: string description: The code to send as `method_code`. example: test label: type: string description: type: - string - 'null' icon_url: type: - string - 'null' category: type: - string - 'null' description: Broad family the method belongs to. requires_phone: type: boolean description: Whether a payer phone number must be supplied. Customer: type: - object - 'null' properties: id: type: string example: cus_2f8Kd1 first_name: type: - string - 'null' example: Ada last_name: type: - string - 'null' example: Lovelace email: type: - string - 'null' example: ada@example.com avatar_url: type: - string - 'null' PayoutInstrument: type: - object - 'null' description: The destination as stored. Keys depend on `type`. properties: id: type: string example: pin_5Yt2Wc type: type: string enum: - phone - bank_account - crypto_address phone_number: type: - string - 'null' account_name: type: - string - 'null' account_number: type: - string - 'null' bank_code: type: - string - 'null' swift_bic: type: - string - 'null' country: oneOf: - $ref: '#/components/schemas/Country' - type: 'null' description: Returned as an object, although it is sent as a plain code. address: type: - string - 'null' network: type: - string - 'null' memo_tag: type: - string - 'null' GatewayTransaction: type: object properties: transaction: type: object properties: id: type: - string - 'null' reference: type: - string - 'null' external_id: type: - string - 'null' status: type: - string - 'null' Failure: type: object properties: code: type: - object - 'null' properties: value: type: string description: Stable identifier for the failure. category: type: string description: Branch on this rather than on `value`. enum: - CUSTOMER_ERROR - GATEWAY_ERROR - TELCO_ERROR - MERCHANT_CONFIG_ERROR - PLATFORM_ERROR - SECURITY_ERROR message: type: - string - 'null' description: Message written for the payer. message: type: - string - 'null' Country: type: object properties: code: type: string example: US name: type: string example: United States flag: type: - string - 'null' securitySchemes: bearerAuth: type: http scheme: bearer description: Your secret key, e.g. `sk_live_...` or `sk_sandbox_...`. ````