---
title: "Create a verification link"
method: POST
path: "/gateway/businesses/{id}/verification-link"
tags: ["Businesses"]
---

# Create a verification link

`POST /gateway/businesses/{id}/verification-link`

## Request

- Base URL: `https://api.agentaos.ai/api/v1`
- URL: `https://api.agentaos.ai/api/v1/gateway/businesses/{id}/verification-link`
- Auth: API key in header `x-api-key`

The identity check link for your client. You send it; only your client can complete it. Needs a live key: a test key gets `403 live_key_required`. While a check is open, calling again returns the same check. `url` is `null` when the client is already verified. For another app of your own company it returns `409 identity_from_company`: its identity check is your company's.

## Path parameters

- `id` string, uuid, required

## Response `201`

The link, or `null` when already verified.

- VerificationLink
  - `url` string, nullable, required: The identity check link to send your client, or null when already verified.
  - `status` string, required: Where the identity check stands. These are the check's own states, not a business status: `Not Started`, `In Progress`, `Awaiting User`, `In Review`, `Approved`, `Declined`, `Resubmitted`, `Expired`, `Kyc Expired` or `Abandoned`. `Approved` means the check is done.

## Other responses

- `401`: Missing or invalid `x-api-key`.
- `403`: A business you do not manage (`You cannot act as this business.`), or a test key (`live_key_required`).
- `409`: Another app of your own company: its identity check is your company's.

---

[API](https://skmtc.dev/agentaos/apis/agentaos-gateway-api.md) · [All operations](https://skmtc.dev/agentaos/apis/agentaos-gateway-api/llms.txt) · [OpenAPI document](https://skmtc.dev/agentaos/apis/agentaos-gateway-api/revisions/3a8ad3c6b965?raw)