---
title: "List collections"
method: GET
path: "/api/v1/bila/collections"
tags: ["Collections"]
---

# List collections

`GET /api/v1/bila/collections`

Retrieve a paginated list of payment collections for the authenticated merchant

## Query parameters

- `page` number
- `perPage` number
- `status` 'pending' | 'successful' | 'failed' | 'otp-required' | 'pay-offline' — Collection status
- `accountId` string
- `startDate` string
- `endDate` string

## Response `200`

Collections retrieved successfully

- object
  - `status` boolean, required — Request success status
  - `message` string, required — Response message
  - `data` PaginatedCollectionsResponseDto
    - `data` BilaCollectionResponseDto[], required — List of collections
      - `id` string, required — Collection ID
      - `reference` string, required — Client reference
      - `status` 'pending' | 'successful' | 'failed' | 'otp-required' | 'pay-offline', required — Collection status
      - `amount` number, required — Collection amount
      - `currency` string, required — Currency code
      - `feeBearer` 'merchant' | 'customer' — Who bears the transaction fee
      - `narration` string — Collection narration
      - `customer` BilaCollectionCustomerDto, required
        - `phone` string, required — Customer phone number
        - `name` string, required — Customer name
        - `operator` string, required — Mobile money operator
      - `createdAt` string, date-time, required — Collection creation timestamp
      - `completedAt` string, date-time — Collection completion timestamp
    - `meta` PaginationMetaDto, required
      - `total` number, required — Total number of records
      - `perPage` number, required — Items per page
      - `currentPage` number, required — Current page number
      - `pageCount` number, required — Total number of pages

## Other responses

- `400` — Bad request

---

[API](https://skmtc.net/bilasdk/apis/bila-payment-gateway-api.md) · [All operations](https://skmtc.net/bilasdk/apis/bila-payment-gateway-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/bilasdk/bila-payment-gateway-api/revisions/1e6976632889/schema)