---
title: "Directors' and PSCs' ID verification for up to 50 companies"
method: POST
path: "/api/v1/idv-check"
---

# Directors' and PSCs' ID verification for up to 50 companies

`POST /api/v1/idv-check`

## Request

- Base URL: `https://meetkatalis.com`
- URL: `https://meetkatalis.com/api/v1/idv-check`
- Auth: API key in header `x-api-key`

One credit per company. Returns each company's read plus the count of companies with people not showing on the register. Companies the register couldn't (fully) give us are credited back, and creditsRefunded says how many.

## Request body

- object
  - `companies` string[], required

## Response `200`

checked, companiesWithPeopleNotShowing, results[]

## Other responses

- `400`: No valid company numbers, or more than 50
- `401`: Missing or wrong x-api-key
- `429`: Monthly quota reached OR burst brake (60/min)

---

[API](https://skmtc.dev/meetkatalis/apis/katalis-uk-business-intelligence-apis.md) · [All operations](https://skmtc.dev/meetkatalis/apis/katalis-uk-business-intelligence-apis/llms.txt) · [OpenAPI document](https://skmtc.dev/meetkatalis/apis/katalis-uk-business-intelligence-apis/revisions/214b13088f95?raw)