---
title: "Get capability request by ID"
method: GET
path: "/v1/requests/{id}"
tags: ["Capability Requests"]
---

# Get capability request by ID

`GET /v1/requests/{id}`

## Request

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

Retrieves one of the account's capability requests.

## Path parameters

- `id` string, required

## Headers

- `Account-ID` string

## Response `200`

OK

- object: Standard response containing data and its metadata if any
  - `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

## Other responses

- `400`: Bad Request
- `404`: Not Found
- `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)