---
title: "Get ID-verification artifacts"
method: GET
path: "/api/v1/me/natural-person/id-verification"
tags: ["Authenticated person"]
---

# Get ID-verification artifacts

`GET /api/v1/me/natural-person/id-verification`

## Request

- Base URL: `https://portal.eprospera.com`
- URL: `https://portal.eprospera.com/api/v1/me/natural-person/id-verification`
- Auth: one of:
  - OAuth 2
    - Authorization code: `https://portal.eprospera.com/api/oauth/authorize`
    - Token URL: `https://portal.eprospera.com/api/oauth/token` scopes: `eprospera:person.id_verification.read`
  - HTTP bearer
- TypeScript: <https://skmtc.dev/eprospera/apis/e-pro-spera-api/docs/api/v1/me/natural-person/id-verification/get.ts> (a function with typed inputs; its response is checked against the schema)

Account deactivation revokes personal API keys, including Agent Keys, and OAuth authorizations. Account reactivation requires new API keys, including new Agent Keys, and consent; previously issued credentials remain invalid.

## Response `200`

ID-verification details and signed artifact URLs.

- IdVerification
  - `id` string, uuid, nullable, required
  - `type` 'veriff', nullable, required
  - `documentType` 'passport' | 'national_id' | 'drivers_license' | 'residence_permit' | 'visa' | 'other' | 'null', nullable, required
  - `date` string, date-time, nullable, required
  - `status` 'approved', nullable, required
  - `documents` object, required
    - `documentFront` string, uri, nullable, required
    - `documentBack` string, uri, nullable, required
    - `face` string, uri, nullable, required

## Other responses

- `400`: Validation error or precondition failure.
- `401`: Missing or invalid credential.
- `403`: Credential lacks the required scope (Agent Key) or insufficient OAuth scope.
- `404`: Resource does not exist or is invisible to the caller. The two are intentionally indistinguishable.
- `409`: Conflicting state (e.g. legal-entity name already taken).
- `429`: Rate limit exceeded. No `Retry-After` header is currently emitted; back off exponentially.
- `500`: Server error.

## Changes

- **2026-09-22** `d2c5a5cda002`: 7 info
  - added the optional property `code` to the response with the `400` status
  - added the optional property `code` to the response with the `401` status
  - added the optional property `code` to the response with the `403` status
  - added the optional property `code` to the response with the `404` status
  - …3 more

[Operation history](https://skmtc.dev/eprospera/apis/e-pro-spera-api/changes/api/v1/me/natural-person/id-verification/get.md)

---

[API](https://skmtc.dev/eprospera/apis/e-pro-spera-api.md) - [All operations](https://skmtc.dev/eprospera/apis/e-pro-spera-api/llms.txt) - [OpenAPI document](https://skmtc.dev/eprospera/apis/e-pro-spera-api/revisions/271098460337?raw)