Get a verification and the details saved on it
Returns the profile and the details typed into it so far (evidence),
including a draft that has not been sent for review.
A profile that isn't yours answers 404 kyc.not_found.
Authorization
personalKeyAuth Your personal API key, sent as Authorization: Bearer <key>. Generate
it in the SautiKit console under Account > API key. It acts as you,
not as a workspace, so it reaches what belongs to you as a person:
your KYC verification. Workspace API keys don't work here.
In: header
Path Parameters
The KYC profile id.
uuidResponse Body
application/json
application/json
curl -X GET "https://example.com/v1/kyc/profiles/497f6eca-6276-4993-bfeb-53cbbbba6f08"{ "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08", "kind": "individual", "display_name": "string", "level": "none", "status": "draft", "requested_level": "individual", "phone_e164": "+254712345678", "phone_verified_at": "2019-08-24T14:15:22Z", "review_note": "string", "daily_limit": 100, "number_limit": 20, "numbers_owned": 3, "used_today": 4, "workspace_count": 1, "suspended_at": "2019-08-24T14:15:22Z", "suspension_reason": "string", "created_at": "2019-08-24T14:15:22Z", "evidence": { "full_name": "string", "country": "Kenya", "id_type": "national_id", "id_number": "12345678", "birth_month": "1990-04", "address": "string", "business_name": "string", "entity_type": "Private limited company", "registration_number": "PVT-7LUQ8XZ", "kra_pin": "P051234567X", "director_on_cr12": true, "rep_phone": "712345678", "rep_email": "user@example.com", "intended_use": "string", "end_clients": "string", "end_client_count": "10 to 50", "monthly_volume": "250,000" }}{ "error": { "code": "validation.bad_request", "message": "string", "request_id": "string", "details": [ "string" ], "resolution": "string", "reason": "invalid_characters", "suggested_e164": "+254727524723" }}Start a new verification POST
Starts a draft profile. Most owners already have one: it is created when you verify your phone while setting up a workspace, so check `GET /v1/kyc/profiles` first. A new profile backs a workspace only once you link it there in the console.
Save details without sending them for review PUT
Saves the account type and the details typed so far. Nothing is checked or reviewed until you submit. Saving replaces the details stored before, so send every field you want kept. Only Kenya is supported for now: `country` must be `Kenya` or left out (`400 kyc.country_unsupported` otherwise). A profile waiting for review can't be changed (`409 kyc.pending_review`).