> ## Documentation Index > Fetch the complete documentation index at: https://docs.payluk.ng/llms.txt > Use this file to discover all available pages before exploring further. # List escrow transactions > Paginated list of the authenticated user's escrows, filtered by `type` (sales or buy). ## OpenAPI ````yaml openapi.json GET /v1/escrow/transactions openapi: 3.0.3 info: title: Payluk ThirdParty API version: 1.0.0 description: >- Merchant / Business API for the Payluk escrow and payments platform. All routes are mounted under `/v1` and authenticated with a secret key. Every response uses the standard envelope `{ status, message, data }`. contact: name: Payluk Developer Support email: support@payluk.ng url: https://payluk.ng servers: - url: https://staging.api.payluk.ng description: 'Staging: use sk_test_ keys here for safe testing' - url: https://api.payluk.ng description: 'Production: use sk_live_ keys' security: - bearerAuth: [] tags: - name: Escrow description: Create and manage standard escrow payment links. - name: Milestone Escrow description: Escrows that release funds in parts as milestones are confirmed. - name: Vault Escrow description: >- Merchant-only pooled-stake escrows: customers stake from their wallets and the merchant declares the winner. - name: Categories description: Organise escrows into merchant-defined categories. - name: Merchant Customers description: Manage the buyers and sellers that transact under your merchant account. - name: Disputes description: Confirm deliveries, raise disputes and resolve them. - name: Payments description: Fund wallets and escrows, verify references and manage payout details. - name: Debit Cards description: List and remove customers' saved debit cards. - name: Crypto Whitelist description: Manage whitelisted crypto withdrawal addresses. - name: Misc description: Supporting reference data. paths: /v1/escrow/transactions: get: tags: - Escrow summary: List escrow transactions description: >- Paginated list of the authenticated user's escrows, filtered by `type` (sales or buy). operationId: getEscrowTransactions parameters: - $ref: '#/components/parameters/CustomerIdHeader' - name: type in: query required: true schema: type: string enum: - sales - buy description: Whether to return escrows you are selling or buying. - $ref: '#/components/parameters/Page' - $ref: '#/components/parameters/Limit' - name: categoryId in: query required: false schema: type: string - name: status in: query required: false schema: $ref: '#/components/schemas/EscrowStatus' responses: '200': description: Paginated escrows. content: application/json: example: status: 200 message: Transaction fetched successfully data: data: - id: 6a3cdafc734e96016b227367 amount: 1000 purpose: multi-purpose escrow item description: details whoPays: buyer imageUrl: null fee: 30 paymentToken: PY_TIrNY1CD3836 paidAt: '1782373118' status: ONGOING state: OPENED logs: [] channel: API isSeller: true dispute: null paymentDetails: id: 6a3cdafd734e96016b22736b amount: 1030 status: success reference: rthyjyutj fee: 0 transactionType: escrow currency: NGN createdAt: '2026-06-25T07:38:38.003Z' category: null completedAt: null approvedClaimBy: null refundedBy: null maxDelivery: 1 deliveryTimeline: hours totalQuantity: 1 settlementType: STANDARD milestones: [] createdAt: '2026-06-25T07:38:37.283Z' updatedAt: '2026-06-25T07:38:38.922Z' - id: 6a3cd9b1734e96016b22732e amount: 1000 purpose: multi-purpose escrow item description: details whoPays: buyer imageUrl: null fee: 30 paymentToken: PY_V2bRgyPJ3305 paidAt: null status: PENDING state: AWAITING_PAYMENT logs: [] channel: API isSeller: true dispute: null paymentDetails: null category: null completedAt: null approvedClaimBy: null refundedBy: null maxDelivery: 1 deliveryTimeline: hours totalQuantity: 2 settlementType: STANDARD milestones: [] createdAt: '2026-06-25T07:33:05.400Z' updatedAt: '2026-06-25T07:38:39.619Z' - id: 6a2d53ebfa797d3af379de94 amount: 1000 purpose: test description: details whoPays: seller imageUrl: null fee: 30 paymentToken: PY_unETaAQs5819 paidAt: null status: PENDING state: AWAITING_PAYMENT logs: [] channel: API isSeller: true dispute: null paymentDetails: null category: null completedAt: null approvedClaimBy: null refundedBy: null maxDelivery: 1 deliveryTimeline: hours totalQuantity: 2 milestones: null createdAt: '2026-06-13T12:58:19.206Z' updatedAt: '2026-06-13T12:58:19.206Z' pagination: count: 3 pages: 1 isLastPage: true nextPage: null previousPage: null report: total: 0 completed: 0 ongoing: 0 dispute: 0 amount: total: 3000 completed: 0 ongoing: 1000 dispute: 0 '401': description: '`type` missing or invalid.' content: application/json: schema: $ref: '#/components/schemas/ApiError' examples: required: summary: Type required value: status: 401 message: Type is required data: {} invalid: summary: Invalid type value: status: 401 message: 'Invalid type provider, allowed types: sales | buy' data: {} components: parameters: CustomerIdHeader: name: customer-id in: header required: true description: The merchant customer this request acts on behalf of. schema: type: string example: 665f1b2c9a1e4d0012ab3c01 Page: name: page in: query required: false description: Page number (1-based). schema: type: integer default: 1 example: 1 Limit: name: limit in: query required: false description: Items per page. schema: type: integer default: 10 example: 10 schemas: EscrowStatus: type: string description: High-level escrow status. enum: - PENDING - ONGOING - COMPLETED - REFUNDED - CLAIMED - DISPUTED - INVESTIGATING ApiError: type: object description: Standard error envelope. properties: status: type: integer example: 400 message: type: string example: Action not allowed data: type: object example: {} securitySchemes: bearerAuth: type: http scheme: bearer description: >- Your secret key as a Bearer token. The key prefix selects the environment: `sk_test_...` (test) or `sk_live_...` (live). ````