---
title: "Refresh compliance application status"
method: POST
path: "/compliance/applications/{id}/refresh"
tags: ["Compliance"]
---

# Refresh compliance application status

`POST /compliance/applications/{id}/refresh`

Manually poll Plivo for the latest status of a compliance application.
Use this as a fallback when webhooks are delayed. The frontend enforces a
60-second cooldown between refreshes.

## Path parameters

- `id` string, required

## Response `200`

Application status refreshed

- object
  - `status` boolean
  - `data` 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

## Other responses

- `401` — Unauthorized access
- `404` — Application not found or does not belong to this organization
- `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)