ApiK Y B Industry

Select the business's industry and apply the industry policy

Record the industry and re-evaluate the application. A restricted industry flags the application `requires_underwriting` and opens an underwriting case record in the same transaction; an allowed industry leaves the application where it stands. The evaluation is idempotent: re-selecting the same industry does not stack cases.

POST
/api/b/v1/kyb/industry

Record the industry and re-evaluate the application.

A restricted industry flags the application requires_underwriting and opens an underwriting case record in the same transaction; an allowed industry leaves the application where it stands. The evaluation is idempotent: re-selecting the same industry does not stack cases.

Authorization

OAuth2PasswordBearer
AuthorizationBearer <token>

In: header

admin_access_token?string|null

Request Body

application/json

TypeScript Definitions

Use the request body type in TypeScript.

What the Owner picks on the onboarding "What you do" step.

Selecting an industry is not the same as clearing it: the DB-driven policy is evaluated the moment this is saved, so a restricted industry flags the application requires_underwriting right here.

Response Body

application/json

application/json

curl -X POST "https://example.com/api/b/v1/kyb/industry" \  -H "Content-Type: application/json" \  -d '{    "industry": "agriculture"  }'
{  "industry": "agriculture",  "restricted": true,  "policy_action": "allow",  "verification": {    "status": "created",    "tier": "tier_0",    "person_count": 0,    "persons_verified": 0,    "persons_clean": 0,    "open_cases": 0  }}