---
title: "Verification flow"
method: POST
path: "/organisations/{organisationId}/verify"
tags: ["Organisations", "KYC", "Organisations"]
---

# Verification flow

`POST /organisations/{organisationId}/verify`

Calling this endpoint with a valid organisation ID will return a url to redirect the customer to that allows a user to manage the full verification process, your customer can return to the flow at any point through an additional request to this endpoint.

You must provide `returnUrl` in the request body which will be used to redirect the user back to your system on completion of the current process.

The verification process is asynchronous - a customer can supply information then return to your application while other checks are conducted.

If the organisation has already completed the verification process, this endpoint will return a 204 No Content response. This is not a final state and a 200 with a URL may be returned at a later date.

## Path parameters

- `organisationId` string, uuid, required

## Headers

- `Crezco-Version` string

## Request body

- VerificationParametersVersion3
  - `returnUrl` string, required — Url that Crezco will redirect the customer to after completing verification in the Crezco system.

## Response `200`

OK

- VerificationResourceVersion3
  - `url` string — Url hosted by Crezco that you should redirect the customer to in order to complete the verification process.

## Other responses

- `204` — No Content
- `400` — Bad Request
- `401` — You do not have access. Check your API key is correct.
- `403` — You do not have access to this organisation.
- `406` — The version of the API that you requested is not available. Check your Crezco-Version header. If you omit this header you will use the latest version of the API.
- `409` — Conflict
- `429` — You have made too many requests to the API in too short a period. Wait a while and try again.

---

[API](https://skmtc.net/crezco/apis/payables-api.md) · [All operations](https://skmtc.net/crezco/apis/payables-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/crezco/payables-api/versions/4427e79fba09/schema)