API Reference
KYC

Upload a document

POST
/v1/kyc/profiles/{id}/documents

Uploads one document as multipart/form-data with a doc_type field and a file field: a PDF, JPEG or PNG of at most 5 MB.

What each account type needs:

  • Individual: id_front and id_back (photos of the national ID, passport or alien ID).
  • Business: cr12, plus the director's id_front and id_back.
  • Reseller: as a business, plus the signed reseller_agreement (download it from sautikit.com/legal/sautikit-reseller-agreement.pdf).

Uploading again replaces the document of that type for the review. A profile waiting for review can't take new documents (409 kyc.pending_review).

Authorization

personalKeyAuth
AuthorizationBearer <token>

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

id*string

The KYC profile id.

Formatuuid

Request Body

multipart/form-data

TypeScript Definitions

Use the request body type in TypeScript.

Response Body

application/json

application/json

application/json

curl -X POST "https://example.com/v1/kyc/profiles/497f6eca-6276-4993-bfeb-53cbbbba6f08/documents" \  -F doc_type="id_front" \  -F file="string"
{  "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",  "profile_id": "bfcb6779-b1f9-41fc-92d7-88f8bc1d12e8",  "doc_type": "id_front",  "filename": "string",  "content_type": "application/pdf",  "size_bytes": 5242880,  "created_at": "2019-08-24T14:15:22Z"}
{  "error": {    "code": "validation.bad_request",    "message": "string",    "request_id": "string",    "details": [      "string"    ],    "resolution": "string",    "reason": "invalid_characters",    "suggested_e164": "+254727524723"  }}
{  "error": {    "code": "validation.bad_request",    "message": "string",    "request_id": "string",    "details": [      "string"    ],    "resolution": "string",    "reason": "invalid_characters",    "suggested_e164": "+254727524723"  }}