---
title: "Cancel credential for person API."
method: POST
path: "/api/persons/{personId}/credentials/cancel"
tags: ["person-controller"]
---

# Cancel credential for person API.

`POST /api/persons/{personId}/credentials/cancel`

Cancel credential for person API.

## Path parameters

- `personId` string, required

## Query parameters

- `tokenValue` string

## Request body

- CancellationRequest
  - `jwt` string, required

## Response `200`

OK

- Credential
  - `cancelledDtm` TimestampRes
    - `date` integer
    - `day` integer
    - `hours` integer
    - `minutes` integer
    - `month` integer
    - `nanos` integer
    - `seconds` integer
    - `time` integer
    - `timezoneOffset` integer
    - `year` integer
  - `correlationId` string
  - `createdDtm` TimestampRes
    - `date` integer
    - `day` integer
    - `hours` integer
    - `minutes` integer
    - `month` integer
    - `nanos` integer
    - `seconds` integer
    - `time` integer
    - `timezoneOffset` integer
    - `year` integer
  - `credentialProviderId` string
  - `credentialProviderName` string
  - `credentialTypeId` string
  - `credentialTypeName` string
  - `extId` string
  - `href` string
  - `id` string
  - `issueStatus` string
  - `jwt` string
  - `permittedOperations` string[]
  - `revokedDtm` TimestampRes
    - `date` integer
    - `day` integer
    - `hours` integer
    - `minutes` integer
    - `month` integer
    - `nanos` integer
    - `seconds` integer
    - `time` integer
    - `timezoneOffset` integer
    - `year` integer
  - `statusCheckCount` integer
  - `usageRecord` UsageRecord
    - `checkpointPresentations` object
    - `checkpointTypePresentations` object
    - `presentations` integer
  - `usePolicy` CredentialUsePolicy
    - `checkpointPolicy` 'TIME_BASED' | 'VALIDATION_COUNT_BASED'
    - `checkpointTypePolicy` 'TIME_BASED' | 'VALIDATION_COUNT_BASED'
    - `numberOfCheckpointTypeValidations` integer
    - `numberOfCheckpointValidations` integer
    - `numberOfValidations` integer
    - `policy` 'TIME_BASED' | 'VALIDATION_COUNT_BASED'

## Other responses

- `201` — Created
- `401` — Unauthorized
- `403` — Forbidden
- `404` — Not Found
- `500` — Unexpected error in processing the request.

---

[API](https://skmtc.dev/myverifly/apis/api-documentation.md) · [All operations](https://skmtc.dev/myverifly/apis/api-documentation/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/myverifly/api-documentation/revisions/03f300608c33/schema)