---
title: "List verifications for a legal person"
method: GET
path: "/v0/legal-persons/{legal-person-id}/verifications"
tags: ["Verifications"]
---

# List verifications for a legal person

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

List verifications for the given legal person.

## Path parameters

- `legal-person-id` string, required

## Query parameters

- `sort` '-created-at' | 'created-at'
- `page[size]` integer
- `page[after]` string, byte
- `page[before]` string, byte

## Response `200`

OK

- object
  - `verifications` object[], required
    - `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
  - `links` object, required
    - `prev` string, nullable, required
    - `next` string, nullable, required
  - `meta` object
    - `page` object
      - `total` integer — Total number of items. Present when the total number of items in the full result set is less than 10,000.
      - `estimated-total` object
        - `at-least` 10000 — Present when the total number of items in the full result set exceeds 10,000. This indicates that the actual number of items is at least 10,000, but the exact total is not provided due to performance considerations.

## Other responses

- `400` — Bad Request
- `401` — Requires an API key to continue

---

[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/e56cd4bb9677/schema)