> ## Documentation Index > Fetch the complete documentation index at: https://docs.augustus.com/llms.txt > Use this file to discover all available pages before exploring further. > ## Agent Instructions > Treat the published Augustus OpenAPI specification (https://app.stainless.com/api/spec/documented/augustus/openapi.documented.yml) and the current API-reference pages as the source of truth for endpoints, request/response schemas, enum values, webhook event names, and required headers. > Prefer the 2026-05-01 Banking API and @augustusbank/typescript-sdk for all new integrations. The 2023-01-01 API is a separate, older surface covering two products — Open Banking (instant bank transfer) checkout and refunds, and Manual Bank Transfer (MBT); use it only when one of those products is specifically required. > Cite or link the relevant docs.augustus.com page when answering integration questions. > Do not infer support for currencies, networks, scopes, account types, or operations that are not present in the current documentation. > Use the sandbox base URL (https://api.sandbox.augustus.com) and placeholder credentials in examples. Never include or request a real API key. > The Augustus docs MCP server (https://docs.augustus.com/mcp) provides documentation search and retrieval only; it does not execute authenticated Augustus API actions. # List returns > Lists deposit returns for the merchant with cursor-based pagination. ## OpenAPI ````yaml https://app.stainless.com/api/spec/documented/augustus/openapi.documented.yml get /v1/returns openapi: 3.1.0 info: title: Augustus Banking API description: Augustus Banking API version: 0.1.0 contact: name: Augustus url: https://docs.augustus.com email: developer@augustus.com servers: - url: https://api.augustus.com description: Production - url: https://api.sandbox.augustus.com description: Sandbox security: - BearerAuth: [] tags: [] paths: /v1/returns: get: tags: - Returns summary: List returns description: Lists deposit returns for the merchant with cursor-based pagination. operationId: ReturnsController_list parameters: - name: limit required: false in: query description: Number of results per page (1-100). Defaults to 10. schema: minimum: 1 maximum: 100 exclusiveMaximum: false exclusiveMinimum: false default: 10 type: integer - name: cursor required: false in: query description: Opaque cursor from a previous next_cursor. schema: type: string - name: status required: false in: query description: Current status of the return. schema: type: string enum: - pending - paid - failed - returned - name: deposit_id required: false in: query description: Filter returns belonging to this deposit. schema: format: uuid type: string - name: created_at.gte required: false in: query description: >- Include returns whose created_at is greater than or equal to this ISO 8601 timestamp. schema: format: date-time type: string - name: created_at.lte required: false in: query description: >- Include returns whose created_at is less than or equal to this ISO 8601 timestamp. schema: format: date-time type: string responses: '200': description: Paginated list of returns content: application/json: schema: $ref: '#/components/schemas/ListReturnsResponseDto' x-codeSamples: - lang: JavaScript source: |- import Augustus from '@augustusbank/typescript-sdk'; const client = new Augustus({ apiKey: process.env['AUGUSTUS_API_KEY'], // This is the default and can be omitted }); // Automatically fetches more pages as needed. for await (const returnListResponse of client.returns.list()) { console.log(returnListResponse.id); } components: schemas: ListReturnsResponseDto: type: object properties: data: type: array items: type: object properties: id: description: Unique identifier of the return. type: string format: uuid type: description: Type of the resource. type: string enum: - return status: description: Current status of the return. type: string enum: - pending - paid - failed - returned deposit_id: description: ID of the parent deposit. type: string format: uuid amount: description: Amount as a string decimal (e.g. "100.50"). type: string currency: description: >- Currency code (ISO 4217 currency code or crypto currency code). type: string enum: - EUR - GBP - USD - USDC failure: description: Failure details when status is failed, otherwise null. type: object properties: code: description: Failure code. type: string enum: - account_closed - account_blocked - insufficient_funds - invalid_account_format - invalid_instruction - invalid_amount - invalid_time - duplicate_transaction - payee_verification_failed - system_error - provider_system_error - rejected_by_correspondent_bank - blocked_by_review - unknown x-enumNames: - ACCOUNT_CLOSED - ACCOUNT_BLOCKED - INSUFFICIENT_FUNDS - INVALID_ACCOUNT_FORMAT - INVALID_INSTRUCTION - INVALID_AMOUNT - INVALID_TIME - DUPLICATE_TRANSACTION - PAYEE_VERIFICATION_FAILED - SYSTEM_ERROR - PROVIDER_SYSTEM_ERROR - REJECTED_BY_CORRESPONDENT_BANK - BLOCKED_BY_REVIEW - UNKNOWN message: description: Human-readable description of the failure. type: string retry: description: Whether the return can be retried. type: boolean required: - code - message - retry nullable: true created_at: description: ISO 8601 UTC timestamp when the return was created. type: string format: date-time updated_at: description: ISO 8601 UTC timestamp when the return was last updated. type: string format: date-time required: - id - type - status - deposit_id - amount - currency - failure - created_at - updated_at has_more: type: boolean next_cursor: type: string nullable: true required: - data - has_more - next_cursor securitySchemes: BearerAuth: scheme: bearer bearerFormat: JWT type: http description: Bearer token for authentication with Augustus Banking API ````