---
title: "Perform verification of a legal person"
method: POST
path: "/v0/legal-persons/{legal-person-id}/verifications"
tags: ["Verifications"]
---

# Perform verification of a legal person

`POST /v0/legal-persons/{legal-person-id}/verifications`

Initiates verification of the subject legal person.

The request body must include a `workflow-url` to determine checks to be
performed by the verification. The workflow specified determines which claims
must exist for the subject legal person, as identified in the request URL, and any
associated legal persons (i.e. directors and people with significant control of a
corporation).

These claims can be found in the `required-claim-types` field on a [Workflow](#tag/Workflows/paths/~1v0~1workflows~1{workflow-id}/get).

---

Once a verification is created, the system will perform checks on the claim details.
The status of check processing is indicated by the `verification-status` in the response body.
Initially it will be `pending`, and will transition through `in-progress` to a final status of `checks-complete`.

A `verification-status` of `failed` indicates something went wrong during check processing.
You can initiate another verification to retry the check processing.

## Path parameters

- `legal-person-id` string, required

## Request body

- object
  - `workflow-url` string, required — A link to the [workflow](/docs/terms/workflow).

## Response `201`

The created verification

- object
  - `verification-profiles-url` union — Get claims used in this [verification](#tag/Verifications) for all associated [legal persons](/docs/terms/legal-person).
    - string
    - string
  - `verification-url` string, required — A link to the [verification](#tag/Verifications).
  - `verification-resources-url` string — A link to the resources of a [verification](#tag/Verifications).
  - `updated-at` string, date-time — ISO 8601 formatted date-time.
  - `legal-person-url` union, required — A contextual link to the [legal person](#tag/Legal-persons).
    - string
    - string
  - `workflow-url` string — A link to the [workflow](/docs/terms/workflow).
  - `created-at` string, date-time, required — ISO 8601 formatted date-time.
  - `verification-checks-url` string, required
  - `risk-rating` 'high-risk' | 'prohibited-risk' | 'medium-risk' | 'low-risk'
  - `verification-status` 'in-progress' | 'pending' | 'checks-declined' | 'checks-complete' | 'failed', required
  - `verification-risk-assessments-url` string

## Other responses

- `400` — Bad Request: specific error details will be provided, if available
- `401` — Requires an API key to continue
- `404` — Not Found: An associated legal person or workflow does not exist
- `409` — Conflict: An existing verification is in-flight
- `422` — Unprocessable Entity: specific error details will be provided, if available
- `500` — Internal Server Error: please contact support@griffin.com
- `502` — Bad Gateway: An error occurred with an external service integration

---

[API](https://skmtc.net/griffin/apis/the-griffin-api.md) · [All operations](https://skmtc.net/griffin/apis/the-griffin-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/griffin/the-griffin-api/revisions/7da510b95492/schema)