Skip to main content
GET
/
api
/
kyc
/
id-verification
/
verifications
/
{id}
/
document-front-image
Get ID Verification images
curl --request GET \
  --url http://api.gu1.ai/api/kyc/id-verification/verifications/{id}/document-front-image \
  --header 'Authorization: Bearer <token>'

​
Overview

After ID Verification (POST), you can download the front (and, when applicable, back) document images using the GET endpoints below. Put the verification id in the path—the same UUID as verificationId in the POST response or id from list / GET one. No extra query parameters. Same Authorization: Bearer and read KYC permission as the other ID Verification routes. Use the back endpoint only when that verification actually included a back image; otherwise you may get 404.

​
Endpoints

​
Document front

GET https://api.gu1.ai/api/kyc/id-verification/verifications/{verificationId}/document-front-image

​
Document back

GET https://api.gu1.ai/api/kyc/id-verification/verifications/{verificationId}/document-back-image

​
Path parameters

​
verificationId
string
required
UUID of the ID verification (same as verificationId from POST or id from list/GET one).

​
Headers

  • Authorization: Bearer YOUR_API_KEY (required)
Include X-Organization-Id if your account is organization-scoped.

​
Responses

HTTPDescription
200Raw image bytes (Content-Type e.g. image/jpeg).
404Verification not found, not in your organization, or that image is not available for download.

​
Examples

curl -sS -o front.jpg \
  -H "Authorization: Bearer YOUR_API_KEY" \
  "https://api.gu1.ai/api/kyc/id-verification/verifications/VERIFICATION_UUID/document-front-image"

curl -sS -o back.jpg \
  -H "Authorization: Bearer YOUR_API_KEY" \
  "https://api.gu1.ai/api/kyc/id-verification/verifications/VERIFICATION_UUID/document-back-image"