API referenceK Y B Screening

Send a rejected application back for review

Put a rejected application back in the compliance review queue — IN-367. Refiling a document resets that document only; the application stays rejected, and out of the reviewer's queue, until this is called. It moves the verification to `in_review` and the business to `pending`, the state a reviewer's request for more information leaves, and records when it came back. The tier stays where rejection left it until a reviewer approves. Answers with the verification record, as `GET /kyb/verification` does.

POST
/api/b/v1/kyb/resubmit

Put a rejected application back in the compliance review queue — IN-367.

Refiling a document resets that document only; the application stays rejected, and out of the reviewer's queue, until this is called. It moves the verification to in_review and the business to pending, the state a reviewer's request for more information leaves, and records when it came back. The tier stays where rejection left it until a reviewer approves.

Answers with the verification record, as GET /kyb/verification does.

Authorization

OAuth2PasswordBearer
AuthorizationBearer <token>

In: header

admin_access_token?string|null

Response Body

application/json

application/json

application/json

curl -X POST "https://example.com/api/b/v1/kyb/resubmit"
{  "verification": {    "status": "created",    "tier": "tier_0",    "person_count": 0,    "persons_verified": 0,    "persons_clean": 0,    "open_cases": 0  },  "persons": [    {      "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",      "role": "owner",      "full_name": "string",      "date_of_birth": "2019-08-24",      "nationality": "string",      "ownership_percentage": 0,      "email": "string",      "shares_allocated": 0,      "identity_status": "pending",      "aml_status": "pending",      "identity_result_code": "string",      "identity_result_text": "string",      "aml_check_id": "febfacf1-571a-4358-b002-e0c8b906c2cf",      "created_at": "2019-08-24T14:15:22Z"    }  ],  "readiness": {    "met": true,    "documents_required": [      "string"    ],    "documents_approved": [      "string"    ],    "documents_missing": [      "string"    ],    "stakeholders": 0,    "stakeholders_verified": 0,    "stakeholders_flagged": 0,    "open_cases": 0,    "regulated_industry": false,    "unmet_reasons": [      "string"    ]  }}