---
title: "Get a hosted KYC link for an Organization (v2)"
method: GET
path: "/api/organizations/{id}/kyc-link/v2"
tags: ["Organizations"]
---

# Get a hosted KYC link for an Organization (v2)

`GET /api/organizations/{id}/kyc-link/v2`

Returns a new KYC link with token expiry information. A fresh token is generated on each call. The token is valid for 24 hours. The organization must have accepted the Terms of Service before a KYC link can be generated.

## Path parameters

- `id` string, uuid, required

## Response `200`

KYC link with expiry information

- KycLinkResponse
  - `expiresAt` string, date-time, required — ISO 8601 timestamp when this KYC link will expire. After expiration, call this endpoint again to generate a new link.
  - `kycLink` string, url, required — URL to the KYC verification page for the organization. This link should be provided to the organization to complete their KYC verification.

## Other responses

- `401` — Unauthorized
- `403` — SignedAgreementRequiredException
- `404` — Organization not found or does not belong to the authenticated parent organization
- `412` — Precondition failed. Either KYB Delegation is enabled for the parent organization, or the organization has not accepted the Terms of Service.

---

[API](https://skmtc.net/muralpay/apis/mural-api.md) · [All operations](https://skmtc.net/muralpay/apis/mural-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/muralpay/mural-api/versions/437d277f5948/schema)