---
title: "Get a compliance request"
method: GET
path: "/compliance-requests/{payment_id}"
tags: ["Compliance requests"]
---

# Get a compliance request

`GET /compliance-requests/{payment_id}`

## Request

- Base URL: `https://{prefix}.api.sandbox.checkout.com`
- URL: `https://{prefix}.api.sandbox.checkout.com/compliance-requests/{payment_id}`
- Auth: one of:
  - OAuth 2
    - Client credentials
    - Token URL: `string` scopes: `compliance-requests`, `compliance-requests:read`
  - API key in header `Authorization`
- TypeScript: <https://skmtc.dev/checkout/apis/checkout-com-api-reference/docs/compliance-requests/:payment_id/get.ts> (a function with typed inputs; its response is checked against the schema)

Retrieve an existing <a href="https://www.checkout.com/docs/business-operations/respond-to-compliance-requests">compliance request</a> by payment ID.

## Path parameters

- `payment_id` string, required

## Response `200`

Compliance request retrieved successfully.

- ComplianceRequestDetails: Represents a compliance request.
  - `payment_id` string, nullable: The compliance request's payment ID.
  - `client_id` string, nullable: The compliance request's client ID.
  - `entity_id` string, nullable: The compliance request's entity ID.
  - `segment_id` string, nullable: The compliance request's segment ID.
  - `amount` string, nullable: The payment's transaction amount.
  - `currency` string, nullable: The payment's transaction currency, as a three-letter <a href="https://www.checkout.com/docs/developer-resources/codes/currency-codes">ISO currency code</a>.
  - `recipient_name` string, nullable: The payment's recipient's name.
  - `requested_on` string, nullable: The date and time when the compliance request was initiated.
  - `status` string, nullable: The compliance request's status.
  - `fields` RequestedFields: Groups the requested fields by party (sender/recipient).
    - `sender` RequestedField[], nullable, required: The list of requested sender details.
      - `name` string, nullable, required: The requested field name.
      - `type` string, nullable, required: The requested field type. For example, "string" or "date".
      - `value` string, nullable: The current value for the requested field, if available.
    - `recipient` RequestedField[], nullable, required: The list of requested recipient details.
      - `name` string, nullable, required: The requested field name.
      - `type` string, nullable, required: The requested field type. For example, "string" or "date".
      - `value` string, nullable: The current value for the requested field, if available.
  - `transaction_reference` string, nullable: The payment's transaction reference.
  - `sender_reference` string, nullable: The payment sender's reference.
  - `last_updated` string, nullable: The date and time when the compliance request was last updated.
  - `sender_name` string, nullable: The payment sender's name.
  - `payment_type` string, nullable: The payment type.

## Other responses

- `400`: Compliance request could not be retrieved. See the response body for more information.
- `401`: Unauthorized request
- `403`: Forbidden
- `404`: Compliance request not found

---

[API](https://skmtc.dev/checkout/apis/checkout-com-api-reference.md) - [All operations](https://skmtc.dev/checkout/apis/checkout-com-api-reference/llms.txt) - [OpenAPI document](https://skmtc.dev/checkout/apis/checkout-com-api-reference/revisions/0f1abdb1c3e9?raw)