---
title: "List capability requests"
method: GET
path: "/v1/requests"
tags: ["Capability Requests"]
---

# List capability requests

`GET /v1/requests`

## Request

- Base URL: `https://api.paymongo.com`
- URL: `https://api.paymongo.com/v1/requests`
- Auth: one of:
  - HTTP basic
  - HTTP bearer

Lists the capability requests of the account the credentials belong to, newest first by default. Filter by status and product code; paginate with `cursor` and `limit`.

## Query parameters

- `status` string
- `statuses` string[]
- `product_code` string
- `product_codes` string[]
- `sort_by` string
- `sort_dir` string
- `cursor` string
- `limit` integer

## Headers

- `Account-ID` string

## Response `200`

OK

- object: Standard response containing data and its metadata if any
  - `data` MerchantListRequestsResDTO
    - `cursor` string
    - `data` MerchantRequestResDTO[]
      - `account_id` string
      - `cancelled_at` string, date-time
      - `completed_at` string, date-time
      - `created_at` string
      - `declined_at` string, date-time
      - `id` string: ID is the unique identifier of this request.
      - `kyb_data` object: KybData is the KYC/KYB details submitted for this request, as a JSON object.
      - `merchant_note` MerchantNoteDTO
        - `note` string
        - `requested_custom_files` string[]: RequestedCustomFiles are reviewer-typed names for documents outside the purpose list.
        - `requested_fields` string[]: RequestedFields are kyb_data field keys the merchant must resupply.
        - `requested_files` string[]: RequestedFiles are document purposes the merchant must re-upload, without the `files_` prefix.
        - `set_at` string
      - `organization_data` object
      - `pending_clarification_at` string, date-time
      - `processed_at` string, date-time
      - `product_code` string: ProductCode is the product the request was opened for.
      - `request_type` 'account_update' | 'onboarding'
      - `status` 'draft' | 'submitted' | 'under_review' | 'pending_clarification' | 'processing' | 'completed' | 'declined' | 'cancelled'
      - `submitted_at` string, date-time
      - `under_review_at` string, date-time
      - `updated_at` string
    - `has_more` boolean
    - `meta` MerchantListRequestsMetaDTO
      - `total_requests` integer
  - `has_more` boolean

## Other responses

- `400`: Bad Request
- `401`: Unauthorized
- `500`: Internal Server Error

---

[API](https://skmtc.dev/paymongo/apis/onboarding-api.md) - [All operations](https://skmtc.dev/paymongo/apis/onboarding-api/llms.txt) - [OpenAPI document](https://skmtc.dev/paymongo/apis/onboarding-api/revisions/36885f98768f?raw)