---
title: "Get agreement documents for a partner residency application"
method: GET
path: "/api/v1/partner/residency_applications/{id}/documents"
tags: ["Partner residency applications"]
---

# Get agreement documents for a partner residency application

`GET /api/v1/partner/residency_applications/{id}/documents`

Returns the Agreement of Coexistence the applicant accepted for this application, including the template PDF for that version, and, once the residency exists, its signed agreement and the applicant’s policy documents. Signed agreements must match this application’s residency ID; agreements for other residencies, identity-verification artifacts, and tax documents are never returned. Requires `partner:person.application.read`.

## Path parameters

- `id` string, uuid, required

## Response `200`

Agreement documents for the application.

- PartnerApplicationDocumentsResponse
  - `data` PartnerApplicationDocument[], required — Visible signed agreement and policy documents generated for the applicant once the residency exists. Admin-only and hidden records are excluded. Empty before approval.
    - `id` string, uuid, required
    - `name` string, required
    - `slug` string, nullable, required
    - `version` string, nullable, required
    - `fileUrl` string, uri, required
    - `createdAt` string, date-time, required
  - `agreementOfCoexistence` PartnerAgreementOfCoexistence, nullable, required
    - `aocId` string, uuid, required
    - `slug` string, nullable, required
    - `version` string, required
    - `residencyType` string, required
    - `templatePdfUrl` string, uri, nullable, required — Unsigned template PDF for the accepted agreement version.
    - `accepted` boolean, required — False when a later legally relevant change invalidated the acceptance.
    - `acceptedAt` string, date-time, required
    - `signerName` string, required
    - `invalidatedAt` string, date-time, nullable, required
  - `residencyEffectiveDate` string, date-time, nullable, required

## Other responses

- `400` — Validation error or precondition failure.
- `401` — Missing or invalid credential.
- `403` — Partner Key lacks the required partner 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` — Partner API rate limit exceeded.
- `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/partner/residency_applications/:id/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)