curl --request POST \
  --url https://api.verify.privue.ai/verifications/{verification_id}/documents \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: multipart/form-data' \
  --form 'step_key=<string>' \
  --form 'slot=<string>' \
  --form file=@example-file \
  --form 'kind=<string>'

import requests

url = "https://api.verify.privue.ai/verifications/{verification_id}/documents"

files = { "file": ("example-file", open("example-file", "rb")) }
payload = {
    "step_key": "<string>",
    "slot": "<string>",
    "kind": "<string>"
}
headers = {"Authorization": "Bearer <token>"}

response = requests.post(url, data=payload, files=files, headers=headers)

print(response.text)

const form = new FormData();
form.append('step_key', '<string>');
form.append('slot', '<string>');
form.append('file', '<string>');
form.append('kind', '<string>');

const options = {method: 'POST', headers: {Authorization: 'Bearer <token>'}};

options.body = form;

fetch('https://api.verify.privue.ai/verifications/{verification_id}/documents', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

{
  "id": "3b9c6e1f-8a24-4d57-b0e3-7f1a5c8d2e69",
  "slot": "pan-card",
  "kind": "pan-card",
  "label": "entity_pan",
  "filename": "avesco-pan.jpg",
  "content_type": "image/jpeg",
  "size_bytes": 87422,
  "sha256": "7a2d9c4e1f8b3a6d0e5c2b9f4a7d1e8c3b6a9d2f5e8c1b4a7d0e3f6c9b2a5d8e",
  "received_at": "2026-08-27T11:05:17+05:30"
}

{
  "code": "body-unreadable",
  "detail": "There was an error parsing the body"
}

{
  "code": "unauthenticated",
  "detail": "Missing or malformed Authorization header"
}

{
  "code": "credits-exhausted",
  "detail": "the credits for workflow 'merchant-onboarding' are gone; of 500 granted, 500 used"
}

{
  "code": "environment-mismatch",
  "detail": "workflow 'merchant-onboarding' is production and this request is for uat"
}

{
  "code": "step-not-found",
  "detail": "version 1 of workflow 'merchant-onboarding' declares no step 'pan_card'"
}

{
  "code": "run-in-progress",
  "detail": "the checks are running on this submission; reset the verification to change it"
}

{
  "code": "document-too-large",
  "detail": "the file exceeds the 20 MB limit"
}

{
  "code": "document-type-not-allowed",
  "detail": "'Storefront' does not take pdf files"
}

{
  "code": "step-invalid",
  "detail": "step 'pan' has no slot 'pan-card'"
}

{
  "code": "rate-limited",
  "detail": "Unauthorized: RATE_LIMITED"
}

{
  "code": "auth-unavailable",
  "detail": "Auth provider unavailable"
}