Read the FINMA identification record of a finished verification

GET/v1/verifications/{id}/finma-record

For workflows with the FINMA online identification profile (Circular 2016/7). Lists each requirement with its margin number (Rz), the evidence secuveri recorded and an outcome, the randomly selected security features with their seed and results, the beneficial owner declaration, timestamps and reviewer actions. signature is a compact ES256 JWS over the same record (check it with /.well-known/jwks.json) so an archived copy can be verified. Needs the results:read scope. Archive it yourself: secuveri deletes personal data and media on its retention clocks.

Send your API key in the x-api-key header.

Path parameters

idstringrequired
The verification id (VRF-…) or the session id.

Responses

200The record.
- recordobjectrequired
  services/shared/finma-record.ts. Outcomes: MET, NOT_MET, REVIEW, NOT_APPLICABLE, NOT_SUPPORTED, INFORMATION.
  Show 9 child propertiesHide child properties
  record_versioninteger
  One of1
  kindstring
  One offinma-2016-7-identification-record
  generated_atstringdate-time
  verification_idstring | null
  statusstring | null
  requirementsarray of object
  Show 4 child propertiesHide child properties
  rzstring
  requirementstring
  evidencestring
  outcomestring
  One ofMETNOT_METREVIEWNOT_APPLICABLENOT_SUPPORTEDINFORMATION
  security_feature_selectionobject | null
  reviewer_actionsarray of object
  limitationsarray of string
- signaturestring | null
  Compact JWS; payload is { iss, aud, record }.
401Missing, unknown or expired API key.
403The key lacks the scope this call needs, or its IP allowlist refuses the caller.
404No such verification for this key, or it did not use the FINMA profile.
409The verification has not finished yet.

curl https://api-verify.secuveri.com/v1/verifications/VRF-7KQ2M9XA/finma-record \
  -H "x-api-key: $SECUVERI_API_KEY"

Response · 200

{
  "record": {
    "record_version": 1,
    "kind": "finma-2016-7-identification-record",
    "generated_at": "2026-10-23T09:12:44.120Z",
    "verification_id": "VRF-7KQ2M9XA",
    "status": "COMPLETE",
    "requirements": [
      {
        "rz": "<rz>",
        "requirement": "<requirement>",
        "evidence": "<evidence>",
        "outcome": "MET"
      }
    ],
    "security_feature_selection": null,
    "reviewer_actions": [
      {}
    ],
    "limitations": [
      "string"
    ]
  },
  "signature": "<signature>"
}