---
title: "Verify a legal entity"
method: PATCH
path: "/api/v1/admin/legal-entities/{id}/verify"
tags: ["Legal Entities", "Admin"]
---

# Verify a legal entity

`PATCH /api/v1/admin/legal-entities/{id}/verify`

Verify a legal entity

## Path parameters

- `id` string, uuid, required — The unique identifier of the legal entity

## Request body

- object
  - `verification_status` union, required — The new verification status for the legal entity
    - 'verified'
    - 'rejected'
    - 'pending_verification'
    - 'more_information_required'

## Response `200`

Success

- LegalEntityResponse
  - `success` boolean, required — Indicates if the request was successful
  - `data` union, required — Legal entity information - either company or individual
    - object — Company legal entity information
      - `id` string, uuid, required — The unique identifier of the legal entity
      - `verification_required` boolean, required — Whether verification is required for this legal entity
      - `verification_link` string — The link to verify the legal entity
      - `verification_status` union, required — The verification status of the legal entity
        - 'pending_verification'
        - 'in_review'
        - 'more_information_required'
        - 'verified'
        - 'rejected'
      - `type` 'company', required — The type of legal entity
      - `company_name` string, required — The name of the company
      - `company_number` string, required — The registration number of the company
      - `vat_number` string — The VAT number of the company
      - `tax_id` string — The tax identifier of the company (e.g. ABN for Australian companies, EIN for US companies). For US companies this mirrors the company number.
      - `company_structure` union, required — The legal structure of the company
        - 'limited_liability_company'
        - 'private_limited_company'
        - 'public_limited_company'
        - 'general_partnership'
        - 'limited_liability_partnership'
        - 'limited_partnership'
        - 'limited_liability_entrep_company'
        - 'joint_stock_company'
        - 'single_member_llc'
        - 'multi_member_llc'
        - 'private_partnership'
        - 'private_corporation'
        - 'public_company'
      - `country_of_incorporation` string, required — The country where the company is incorporated - ISO Format
      - `incorporation_date` string, date — The date when the company was incorporated
      - `registered_office_address` object, required — A physical address
        - `address_line1` string, required — The first line of the address
        - `address_line2` string — The second line of the address
        - `apartment` string — The apartment, unit, or suite number
        - `city` string, required — The city
        - `state_province` string — The state or province
        - `country` string, required — ISO 3166-1 alpha-2 country code
        - `postal_code` string, required — The postal code
        - `company_name` string — The company name (if applicable)
      - `company_operating_address` object — A physical address
        - `address_line1` string, required — The first line of the address
        - `address_line2` string — The second line of the address
        - `apartment` string — The apartment, unit, or suite number
        - `city` string, required — The city
        - `state_province` string — The state or province
        - `country` string, required — ISO 3166-1 alpha-2 country code
        - `postal_code` string, required — The postal code
        - `company_name` string — The company name (if applicable)
      - `contact_name` string, required — The name of the primary contact
      - `contact_email` string, email, required — The email of the primary contact
      - `contact_phone_number` string, required — The phone number in format: country_code;number (e.g., 44;7395236209)
      - `annual_revenue_amount` number — The annual revenue amount
      - `annual_revenue_currency` string — The currency of the annual revenue
      - `employees_number` union — The number of employees category
        - 'small'
        - 'medium'
        - 'large'
        - 'enterprise'
    - object — Individual legal entity information
      - `id` string, uuid, required — The unique identifier of the legal entity
      - `verification_required` boolean, required — Whether verification is required for this legal entity
      - `verification_link` string — The link to verify the legal entity
      - `verification_status` union, required — The verification status of the legal entity
        - 'pending_verification'
        - 'in_review'
        - 'more_information_required'
        - 'verified'
        - 'rejected'
      - `type` 'individual', required — The type of legal entity
      - `first_name` string, required — The first name of the individual
      - `last_name` string, required — The last name of the individual
      - `email` string, email, required — The email of the individual
      - `phone_number` string, required — The phone number in E.164 format (+447395236209) or country_code;number (44;7395236209)
      - `dob` string, date, required — The date of birth of the individual
      - `citizenship` string, required — The Country of citizenship of the individual in ISO Format
      - `residency_address` object, required — A physical address
        - `address_line1` string, required — The first line of the address
        - `address_line2` string — The second line of the address
        - `apartment` string — The apartment, unit, or suite number
        - `city` string, required — The city
        - `state_province` string — The state or province
        - `country` string, required — ISO 3166-1 alpha-2 country code
        - `postal_code` string, required — The postal code
        - `company_name` string — The company name (if applicable)

## Other responses

- `400` — Bad Request
- `401` — Unauthorized

---

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