> ## Documentation Index > Fetch the complete documentation index at: https://partners.ladder.africa/llms.txt > Use this file to discover all available pages before exploring further. # List orders ## OpenAPI ````yaml /openapi.json get /partner/v1/orders openapi: 3.0.3 info: title: Ladder Partner API version: v1 description: >- Server-to-server API for licensed partner organisations: KYB, NGN/GHS/USD wallets, funding rails, investments and NGX market data, buy and sell orders, holdings and webhooks. Every request is HMAC-signed; see the Authentication guide. contact: email: partners@myladder.africa servers: - url: https://api.myladder.africa description: Production - url: https://api-dev.myladder.africa description: UAT (integration and acceptance testing) security: - LadderKey: [] LadderTimestamp: [] LadderSignature: [] tags: - name: Organisation description: The calling organisation and what KYB still needs. - name: KYB description: >- Business information, people, documents, settlement accounts and submission. - name: Wallets description: >- Balances, funding requests on every rail, direct-debit mandates and the ledger statement. - name: Investments description: What a partner can buy. - name: Market data description: >- Nigerian Exchange instruments, quotes, bars, indices, FX, calendar and disclosures. - name: Orders description: Buy and sell orders and their lifecycle. - name: Holdings description: Positions created by completed buys. - name: Webhooks description: Endpoints, deliveries and retries. - name: Sandbox description: Test-key only helpers. paths: /partner/v1/orders: parameters: [] get: tags: - Orders summary: List orders operationId: orders_list parameters: - name: limit in: query description: Page size, 1–200 (default 50). schema: type: integer - name: offset in: query description: Rows to skip (default 0). schema: type: integer - name: status in: query description: awaiting_payment, pending_fulfilment, completed, failed, cancelled schema: type: string - name: side in: query description: buy or sell schema: type: string - name: customer_reference in: query description: Your end-customer reference schema: type: string - name: client_reference in: query description: Your order reference schema: type: string responses: '200': description: '' content: application/json: schema: $ref: '#/components/schemas/PartnerOrderPageResponse' '401': description: Missing/invalid signature, stale timestamp, unknown or revoked key. content: application/json: schema: $ref: '#/components/schemas/PartnerError' '403': description: IP not allowlisted, or action not allowed for this key/environment. content: application/json: schema: $ref: '#/components/schemas/PartnerError' '429': description: Rate limited (120 requests/min per key). See `Retry-After`. content: application/json: schema: $ref: '#/components/schemas/PartnerError' components: schemas: PartnerOrderPageResponse: required: - data - pagination type: object properties: data: type: array items: $ref: '#/components/schemas/PartnerOrder' pagination: $ref: '#/components/schemas/PartnerPagination' PartnerError: required: - error type: object properties: error: $ref: '#/components/schemas/PartnerErrorBody' PartnerOrder: required: - investment_id - investment_name - amount - currency - payment_mode - status type: object properties: id: title: Id type: string format: uuid readOnly: true reference: title: Reference type: string maxLength: 64 minLength: 1 client_reference: title: Client reference type: string maxLength: 100 side: title: Side type: string enum: - buy - sell investment_id: title: Investment id type: string format: uuid investment_name: title: Investment name type: string minLength: 1 amount: title: Amount type: string format: decimal currency: title: Currency type: string enum: - GHS - USD - NGN units: title: Units type: string format: decimal nullable: true proceeds: title: Proceeds type: string format: decimal nullable: true payment_mode: title: Payment mode type: string enum: - wallet - checkout status: title: Status type: string enum: - awaiting_payment - pending_fulfilment - completed - failed - cancelled customer: title: Customer type: string readOnly: true metadata: title: Metadata type: object failure_reason: title: Failure reason type: string payment: title: Payment type: string readOnly: true holding_id: title: Holding id type: string readOnly: true paid_at: title: Paid at type: string format: date-time nullable: true completed_at: title: Completed at type: string format: date-time nullable: true cancelled_at: title: Cancelled at type: string format: date-time nullable: true created_at: title: Created_at type: string format: date-time readOnly: true updated_at: title: Updated at type: string format: date-time readOnly: true PartnerPagination: required: - limit - offset - count type: object properties: limit: title: Limit type: integer offset: title: Offset type: integer count: title: Count description: Total rows matching the filters. type: integer PartnerErrorBody: required: - code - message - details type: object properties: code: title: Code description: Stable machine-readable code, e.g. `insufficient_funds`. type: string minLength: 1 message: title: Message type: string minLength: 1 details: title: Details description: Code-specific context (validation errors, balances, …). type: object additionalProperties: type: string nullable: true securitySchemes: LadderKey: type: apiKey in: header name: X-Ladder-Key description: 'Your key id: `pk_test_…` (sandbox) or `pk_live_…` (live).' LadderTimestamp: type: apiKey in: header name: X-Ladder-Timestamp description: Unix seconds, as a string; must be within 5 minutes of server time. LadderSignature: type: apiKey in: header name: X-Ladder-Signature description: >- Lower-case hex HMAC-SHA512 over timestamp, method, path+query and the SHA-256 of the body. See Authentication. ```` This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.