---
title: "List the authenticated person’s documents"
method: GET
path: "/api/v1/me/natural-person/documents"
tags: ["Authenticated person"]
---

# List the authenticated person’s documents

`GET /api/v1/me/natural-person/documents`

Returns the documents the portal shows the signed-in person: the signed Agreement of Coexistence, accepted policies, and other generated documents, excluding admin-only or hidden records. `agreementOfCoexistence` describes the agreement behind the active residency. Agent scope: `agent:person.documents.read`.

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`

Personal documents and the active Agreement of Coexistence.

- PersonDocumentsResponse
  - `data` PersonDocument[], required
    - `id` string, uuid, required
    - `name` string, required
    - `slug` string, nullable
    - `version` string, nullable
    - `fileUrl` string, uri, nullable, required
    - `createdAt` string, date-time, required
  - `agreementOfCoexistence` PersonAgreementOfCoexistence, nullable, required
    - `aocId` string, uuid, required
    - `slug` string, nullable, required
    - `version` string, required
    - `residencyType` string, required
    - `effectiveDate` string, date-time, required
    - `terminationDate` string, date-time, nullable, required
    - `templatePdfUrl` string, uri, nullable, required — Unsigned template PDF for this agreement version.
    - `signedDocumentId` string, uuid, nullable, required
    - `signedDocumentUrl` string, uri, nullable, required — Signed Agreement of Coexistence for the active residency. Null until that residency has a canonically identified signed document; historical or unassociated legacy agreements are not substituted.

## 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` — 1 info
  - endpoint added

[Change history](https://skmtc.dev/eprospera/apis/e-pro-spera-api/changes/api/v1/me/natural-person/documents/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/6fbf9c9b36b5?raw)