> ## Documentation Index > Fetch the complete documentation index at: https://docs.useroutr.com/llms.txt > Use this file to discover all available pages before exploring further. # Retrieve a settlement ## OpenAPI ````yaml /api-reference/openapi.json get /v1/settlements/{id} openapi: 3.1.0 info: title: Useroutr API version: '1' description: >- Application funding infrastructure. Two authentication layers exist and are never interchangeable: developer backends authenticate with an application API key (`apiKey`), and the Useroutr dashboard authenticates a human with a Useroutr account session (`userSession`, obtained from `/v1/auth/sign-in`). Platform operations use the operator platform key. Every response carries an `X-Request-ID` header that also appears in error envelopes. servers: - url: https://api.sandbox.useroutr.com description: 'Sandbox: ur_test_ keys, Stellar testnet' - url: https://api.useroutr.com description: 'Production: ur_live_ keys' security: [] tags: - name: Funding Intents description: Funding intent lifecycle - name: Quotes description: 'Route quotes: what a payer must send from a chosen source asset' - name: Checkout description: Public, token-addressed payer view - name: Payments description: Observed payments - name: Settlements description: Settlement state and protocol evidence - name: Refunds description: Refund requests for payments that did not satisfy an intent - name: Ledger description: Application balances and ledger entries - name: Webhooks description: Webhook endpoints, events and deliveries - name: Assets description: Supported assets - name: Applications description: Application registration and credentials - name: Request logs description: Requests made with the application's API keys, kept for 30 days paths: /v1/settlements/{id}: get: tags: - Settlements summary: Retrieve a settlement parameters: - schema: type: string minLength: 1 maxLength: 64 in: path name: id required: true responses: '200': description: Default Response content: application/json: schema: type: object properties: id: type: string object: type: string enum: - settlement funding_intent_id: type: string application_id: type: string payment_id: type: string network: type: string enum: - stellar stellar_network: type: string enum: - testnet - mainnet - local route: type: string enum: - direct - stellar_swap - cross_chain - composed source: type: object properties: asset: type: string amount: type: string required: - asset - amount additionalProperties: false destination: type: object properties: network: type: string asset: type: string address: type: string amount: type: string required: - network - asset - address - amount additionalProperties: false transaction_hash: type: string transfer_transaction_hash: type: - string - 'null' protocol: type: object properties: settlement_id: type: string contract_id: type: string create_transaction_hash: type: - string - 'null' confirm_transaction_hash: type: - string - 'null' required: - settlement_id - contract_id - create_transaction_hash - confirm_transaction_hash additionalProperties: false status: type: string enum: - PENDING - SUBMITTED - CONFIRMING - CONFIRMED - FAILED reconciliation_status: type: string enum: - UNRECONCILED - VERIFYING - MATCHED - EXCEPTION failure: anyOf: - type: object properties: code: type: string message: type: string required: - code - message additionalProperties: false - type: 'null' submitted_at: type: - string - 'null' confirmed_at: type: - string - 'null' created_at: type: string updated_at: type: string required: - id - object - funding_intent_id - application_id - payment_id - network - stellar_network - route - source - destination - transaction_hash - transfer_transaction_hash - protocol - status - reconciliation_status - failure - submitted_at - confirmed_at - created_at - updated_at additionalProperties: false '401': description: Default Response content: application/json: schema: type: object properties: error: type: object properties: code: type: string enum: - BAD_REQUEST - VALIDATION_ERROR - UNAUTHORIZED - FORBIDDEN - NOT_FOUND - CONFLICT - IDEMPOTENCY_KEY_REQUIRED - IDEMPOTENCY_KEY_REUSED - IDEMPOTENCY_REQUEST_IN_PROGRESS - APPLICATION_INACTIVE - INVALID_AMOUNT - UNSUPPORTED_ASSET - INVALID_DESTINATION - INVALID_EXPIRATION - PROTOCOL_REJECTED - PROTOCOL_UNAVAILABLE - NO_ROUTE_AVAILABLE - INSUFFICIENT_INPUT - QUOTE_EXPIRED - QUOTE_NOT_SELECTABLE - QUOTE_NOT_LOCKED - EXECUTION_NOT_FAILED - EXECUTION_NOT_RESUMABLE - LOGO_FORMAT_UNSUPPORTED - LOGO_DIMENSIONS_INVALID - LOGO_STORAGE_UNAVAILABLE - ROUTE_UNAVAILABLE - RATE_LIMITED - INVALID_CREDENTIALS - EMAIL_NOT_VERIFIED - EMAIL_ALREADY_REGISTERED - SESSION_EXPIRED - INVALID_TOKEN - INTERNAL_ERROR message: type: string requestId: type: string retryable: type: boolean details: type: array items: type: object properties: path: type: string message: type: string required: - path - message additionalProperties: false required: - code - message - requestId additionalProperties: false required: - error additionalProperties: false '404': description: Default Response content: application/json: schema: type: object properties: error: type: object properties: code: type: string enum: - BAD_REQUEST - VALIDATION_ERROR - UNAUTHORIZED - FORBIDDEN - NOT_FOUND - CONFLICT - IDEMPOTENCY_KEY_REQUIRED - IDEMPOTENCY_KEY_REUSED - IDEMPOTENCY_REQUEST_IN_PROGRESS - APPLICATION_INACTIVE - INVALID_AMOUNT - UNSUPPORTED_ASSET - INVALID_DESTINATION - INVALID_EXPIRATION - PROTOCOL_REJECTED - PROTOCOL_UNAVAILABLE - NO_ROUTE_AVAILABLE - INSUFFICIENT_INPUT - QUOTE_EXPIRED - QUOTE_NOT_SELECTABLE - QUOTE_NOT_LOCKED - EXECUTION_NOT_FAILED - EXECUTION_NOT_RESUMABLE - LOGO_FORMAT_UNSUPPORTED - LOGO_DIMENSIONS_INVALID - LOGO_STORAGE_UNAVAILABLE - ROUTE_UNAVAILABLE - RATE_LIMITED - INVALID_CREDENTIALS - EMAIL_NOT_VERIFIED - EMAIL_ALREADY_REGISTERED - SESSION_EXPIRED - INVALID_TOKEN - INTERNAL_ERROR message: type: string requestId: type: string retryable: type: boolean details: type: array items: type: object properties: path: type: string message: type: string required: - path - message additionalProperties: false required: - code - message - requestId additionalProperties: false required: - error additionalProperties: false security: - apiKey: [] x-codeSamples: - lang: typescript label: Node.js SDK source: >- import { Useroutr } from "@useroutr/sdk"; const useroutr = new Useroutr({ apiKey: process.env.USEROUTR_API_KEY }); const settlement = await useroutr.settlements.retrieve("stl_1a8f6b3e"); - lang: bash label: cURL source: >- curl -X GET "https://api.sandbox.useroutr.com/v1/settlements/stl_1a8f6b3e" \ -H "Authorization: Bearer $USEROUTR_API_KEY" components: securitySchemes: apiKey: type: http scheme: bearer description: >- Application API authentication for developer backends: `Authorization: Bearer ur_test_...` or `ur_live_...`. Resolves the application, its environment and the key's status. Never a dashboard login. ```` This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.