---
title: "Get compliance status"
method: GET
path: "/compliance/status"
tags: ["Compliance"]
---

# Get compliance status

`GET /compliance/status`

Returns the current compliance status for a given country, number type, and user type.
This is the single endpoint the frontend uses to determine which step to render
(form, submitted, accepted, rejected, expired, or suspended).

## Query parameters

- `countryIso` string, required
- `numberType` 'local' | 'mobile' | 'tollfree', required
- `userType` 'individual' | 'business', required

## Response `200`

Compliance status retrieved successfully

- object
  - `status` boolean
  - `data` object
    - `step` 'form' | 'submitted' | 'accepted' | 'rejected' | 'expired' | 'suspended' — The current compliance step: - `form` — no application exists, user should submit one - `submitted` — application is under review - `accepted` — approved, user can rent numbers - `rejected` — rejected, user can resubmit with corrected documents - `expired` — compliance expired - `suspended` — compliance suspended
    - `application` ComplianceApplication — A compliance application for a specific country, number type, and user type
      - `_id` string — Unique identifier
      - `organizationId` string — The organization this application belongs to
      - `plivoComplianceId` string — Plivo's compliance application identifier
      - `alias` string — Auto-generated alias (orgId-countryIso-env)
      - `status` 'draft' | 'submitted' | 'accepted' | 'rejected' | 'suspended' | 'expired' — Current status of the compliance application
      - `countryIso` string — ISO 3166-1 alpha-2 country code
      - `numberType` 'local' | 'mobile' | 'tollfree'
      - `userType` 'individual' | 'business'
      - `endUserName` string — Legal business or individual name
      - `endUserLastName` string, nullable
      - `endUserEmail` string, nullable
      - `endUserCountry` string, nullable
      - `documentFileNames` string[] — Names of uploaded document files
      - `rejectionReason` string, nullable — Reason for rejection, if applicable
      - `createdBy` string — User ID of the person who created this application
      - `createdAt` string, date-time
      - `updatedAt` string, date-time
    - `requiredDocuments` RequiredDocumentType[] — Document types required for this country/numberType/userType combination
      - `documentTypeId` string — Identifier to use when submitting this document type
      - `name` string — Human-readable name
      - `description` string — Description of what this document should contain
      - `proofRequired` boolean — Whether a file upload is required for this document type
      - `requiredFields` object[] — Data fields that must be provided alongside the document
        - `fieldName` string
        - `friendlyName` string
        - `helpText` string
        - `fieldType` string
        - `required` boolean

## Other responses

- `400` — Invalid input
- `401` — Unauthorized access
- `500` — Internal server error
- `502` — Bad gateway — Plivo's compliance API returned an error or is unavailable

---

[API](https://skmtc.net/smallest-inc/apis/agent-management-api.md) · [All operations](https://skmtc.net/smallest-inc/apis/agent-management-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/smallest-inc/agent-management-api/revisions/c2d0eb64b01a/schema)