---
title: "Initiate risk verification for an organization"
method: POST
path: "/v3/risk-verifications"
tags: ["risk-verifications"]
---

# Initiate risk verification for an organization

`POST /v3/risk-verifications`

Initiate risk verification for an organization. The currently signed-in user must have the `ADMINISTRATOR` user role in the BILL organization to perform this operation.

**Note**: You must add a phone number for the signed-in user (with `POST /v3/risk-verifications/phone`) before you can initiate risk verification. BILL partners must add a phone number for a created user with `POST /v3/partner/risk-verifications/{userId}/phone`.

As a BILL partner, when you create an organization and then create a user for that organization, it is important that you initiate risk verification with `POST /v3/risk-verifications`.

BILL performs a KYC/KYB (Know You Customer/Know Your Business) check based on the provided organization information. BILL sends an email notification for risk verification. When the check is complete, BILL approves the organization for BILL AP and AR operations.

## Headers

- `sessionId` string, nullable — API session ID generated with `/v3/login`
- `devKey` string, nullable — Developer key generated with your BILL developer account

## Response `200`

Initiate risk verification for an organization response

- VerificationResponseDto — Risk verification response.
  - `processingStatus` 'IN_PROGRESS' | 'COMPLETED' — Risk verification processing status.
  - `decision` 'APPROVE' | 'REVIEW' | 'HOLD' | 'DECLINE' | 'PENDING' | 'IN_PROGRESS' — Risk verification decision. See [Users for BILL partners](https://developer.bill.com/docs/partner-users) to learn more about the `decision` values.
  - `referenceId` string — BILL-generated ID to uniquely identify the risk verification request for the organization

## Other responses

- `4XX` — List of errors.
- `5XX` — List of errors.

---

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