v1

latestOpenAPI 3.0.12026-07-24310590875.6 KB
risk-verifications

Initiate risk verification for an organization

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.

post/v3/risk-verifications

Headers

sessionIdstring nullable

API session ID generated with /v3/login

Example:{{session_id}}
devKeystring nullable

Developer key generated with your BILL developer account

Example:{{developer_key}}

Response

Initiate risk verification for an organization 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 to learn more about the decision values.

referenceIdstring

BILL-generated ID to uniquely identify the risk verification request for the organization