Submit a locked-field change (forces re-verification)
File a change to `legal_name` or `registration_number`. When the business is verified the fields are locked: the change is recorded as a pending request, the application moves `in_review`, and live limits drop to the configured safe mode (AC1). The new value is not written to the business - applying it is a compliance operator's decision. When the business is not yet verified the field is not locked and the edit is applied immediately.
File a change to legal_name or registration_number.
When the business is verified the fields are locked: the change is
recorded as a pending request, the application moves in_review, and
live limits drop to the configured safe mode (AC1). The new value is not
written to the business - applying it is a compliance operator's decision.
When the business is not yet verified the field is not locked and the edit
is applied immediately.
Authorization
OAuth2PasswordBearer In: header
Cookie Parameters
Request Body
application/json
TypeScript Definitions
Use the request body type in TypeScript.
What the Owner asks to change on a locked field.
Only legal_name and registration_number are locked after verification
(Figma "locked after KYB"); anything else is a normal profile edit and
does not belong here. The new value is a proposal, not an update: applying
it is a compliance operator's decision, and this request is what parks the
application in_review in the meantime.
Response Body
application/json
application/json
curl -X POST "https://example.com/api/b/v1/kyb/field-change-requests" \ -H "Content-Type: application/json" \ -d '{ "field": "legal_name", "new_value": "string" }'{ "applied": true, "request": { "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08", "field": "legal_name", "old_value": "string", "new_value": "string", "status": "pending", "requested_by": "cda0f200-65cd-4343-aedd-9c936b908826", "created_at": "2019-08-24T14:15:22Z" }, "verification": { "status": "created", "tier": "tier_0", "person_count": 0, "persons_verified": 0, "persons_clean": 0, "open_cases": 0 }}The business's locked-field change requests GET
Previous Page
List the business's API keys GET
Every key for this business, revoked ones included. Revoked keys stay visible: after an incident the question is which keys existed and when each stopped working, and hiding them answers neither. Secrets are absent from this response shape entirely.