GET
/
v1
/
kyc
/
:userid
/
question-answers
curl https://v2.app-dev.zquence.com/v1/kyc/usr_01HX3ZAB.../question-answers \
  -H "x-api-key: $ZQUENCE_PUBLIC_KEY" \
  -H "x-api-secret: $ZQUENCE_SECRET_KEY" \
  -H "x-request-id: req_01J6V..."

{
  "data": {
    "id": "kyc_01HX3ZH...",
    "type": "kyc_submission",
    "subject": {
      "userId": "usr_01HX3ZAB...",
      "tenantId": "tnt_01HX3Z8MQW...",
      "environmentId": "env_01J6V...",
      "accountType": {
        "id": "real_estate"
      }
    },
    "form": {
      "id": "form_current",
      "version": 3,
      "schemaVersion": "1.0",
      "snapshotId": null
    },
    "submission": {
      "status": "submitted",
      "submittedAt": "2026-08-28T10:00:00.000Z",
      "updatedAt": "2026-08-28T10:03:00.000Z"
    },
    "verification": {
      "status": "submitted",
      "provider": {
        "code": "onfido",
        "status": "approved"
      }
    },
    "sections": [
      {
        "id": "identity",
        "title": "Identity",
        "description": "Identity details",
        "order": 1,
        "fields": [
          {
            "id": "full_name",
            "key": "full_name",
            "label": "Full name",
            "type": "text",
            "required": true,
            "order": 1,
            "answer": {
              "value": "Ada Lovelace",
              "displayValue": "Ada Lovelace"
            },
            "attributes": {
              "includeInDownloadableForm": true
            },
            "note": null
          },
          {
            "id": "passport_upload",
            "key": "passport_upload",
            "label": "Passport",
            "type": "file",
            "answer": {
              "value": {
                "documentId": "kyc_doc_...",
                "fileName": "passport.pdf",
                "mimeType": "application/pdf"
              },
              "displayValue": "passport.pdf"
            }
          }
        ]
      }
    ]
  },
  "meta": {
    "requestId": "req_01J6V...",
    "apiVersion": "2026-08-01",
    "generatedAt": "2026-08-28T10:04:00.000Z"
  }
}
Requires kyc.read. This endpoint returns the backend-authoritative KYC form submission in a canonical { data, meta } JSON shape. Use it when an integration needs the customer’s submitted KYC form details without downloading a PDF export. File uploads and signatures are returned as opaque document/signature references with display names. The response does not expose storage keys.

​
Path parameters

​
userid
string
required
The user ID whose submitted KYC form answers should be retrieved.

​
Returns

​
data.id
string | null
KYC submission record ID.
​
data.type
string
Always kyc_submission.
​
data.subject
object
User, tenant, environment, and account-type identifiers for the submission.
​
data.form
object
Runtime form identity, version, and schema version pinned to the submission.
​
data.submission
object
KYC submission status and timestamps.
​
data.verification
object
KYC verification status and provider status metadata.
​
data.sections
array
Submitted form sections. Each section contains ordered fields; grouped questions contain nested fields instead of flattening child answers into the top-level list.
​
meta
object
Request metadata including requestId, apiVersion, and generatedAt.

​
Error codes

StatusMeaning
401Missing or invalid API key pair.
403API key does not include kyc.read, or the caller cannot access the user.
404KYC record not found for this user in the caller’s tenant/environment.
curl https://v2.app-dev.zquence.com/v1/kyc/usr_01HX3ZAB.../question-answers \
  -H "x-api-key: $ZQUENCE_PUBLIC_KEY" \
  -H "x-api-secret: $ZQUENCE_SECRET_KEY" \
  -H "x-request-id: req_01J6V..."

{
  "data": {
    "id": "kyc_01HX3ZH...",
    "type": "kyc_submission",
    "subject": {
      "userId": "usr_01HX3ZAB...",
      "tenantId": "tnt_01HX3Z8MQW...",
      "environmentId": "env_01J6V...",
      "accountType": {
        "id": "real_estate"
      }
    },
    "form": {
      "id": "form_current",
      "version": 3,
      "schemaVersion": "1.0",
      "snapshotId": null
    },
    "submission": {
      "status": "submitted",
      "submittedAt": "2026-08-28T10:00:00.000Z",
      "updatedAt": "2026-08-28T10:03:00.000Z"
    },
    "verification": {
      "status": "submitted",
      "provider": {
        "code": "onfido",
        "status": "approved"
      }
    },
    "sections": [
      {
        "id": "identity",
        "title": "Identity",
        "description": "Identity details",
        "order": 1,
        "fields": [
          {
            "id": "full_name",
            "key": "full_name",
            "label": "Full name",
            "type": "text",
            "required": true,
            "order": 1,
            "answer": {
              "value": "Ada Lovelace",
              "displayValue": "Ada Lovelace"
            },
            "attributes": {
              "includeInDownloadableForm": true
            },
            "note": null
          },
          {
            "id": "passport_upload",
            "key": "passport_upload",
            "label": "Passport",
            "type": "file",
            "answer": {
              "value": {
                "documentId": "kyc_doc_...",
                "fileName": "passport.pdf",
                "mimeType": "application/pdf"
              },
              "displayValue": "passport.pdf"
            }
          }
        ]
      }
    ]
  },
  "meta": {
    "requestId": "req_01J6V...",
    "apiVersion": "2026-08-01",
    "generatedAt": "2026-08-28T10:04:00.000Z"
  }
}
KYC form answers can contain regulated PII. Store and transmit this JSON according to your tenant retention policy and regional data-residency obligations.