Business and transactions

Business verification (KYB)

Verify companies, their officers and their owners.

#Registries

Registry	Coverage
`gb`	UK Companies House
`fr`	France (INSEE and INPI)
`no`	Norway (Brønnøysund)
`fi`	Finland (PRH and YTJ)
`pl`	Poland KRS (by KRS number)
`dk`	Denmark (CVR)
`gleif`	Global LEI index, all countries

Check what is enabled: GET /v1/kyb/registries.

#Flow

Search the registry by name and country.
Create a case with the registry ID and what the business told you.
We pull the company, its officers and owners, screen everyone against sanctions and PEP lists, and compare with what was declared.
Each director and owner gets a KYC link (emailed if you include their email).
The case is decided automatically, or goes to review, and you get kyb.approved, kyb.in_review or kyb.declined.

bash

curl "https://{{HOST}}/v1/kyb/search?name=Acme%20Payments&country=GB" -H "x-api-key: sk_live_..."

curl -X POST https://{{HOST}}/v1/kyb/cases -H "x-api-key: sk_live_..." -H "Content-Type: application/json" -d '{
  "registry": "gb", "registry_id": "12345678", "external_ref": "merchant_77",
  "declared": { "name": "Acme Payments Ltd", "owners": [{ "name": "Jane Doe", "ownership": 100, "email": "[email protected]" }] }
}'

curl -X POST https://{{HOST}}/v1/kyb/cases/kyb_.../documents -H "x-api-key: sk_live_..." \
  -F kind=certificate_of_incorporation -F [email protected]

The case response lists people[], each with a kyc_url. See the KYB API.