---
title: "Upload proof of address"
method: POST
path: "/api/v1/uploads/proof_of_address"
tags: ["Partner residency applications"]
---

# Upload proof of address

`POST /api/v1/uploads/proof_of_address`

## Headers

- `Idempotency-Key` string — Makes retried partner write requests safe.

## Response `200`

Upload metadata.

- object — Successful response.
  - `data` object, required
    - `id` string, uuid, required
    - `applicationId` string, uuid, required
    - `contentType` string, required
    - `size` integer, 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` — Partner API rate limit exceeded.
- `500` — Server error.

---

[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-service-production.skmtc.workers.dev/v1/apis/eprospera/e-pro-spera-api/revisions/9ecdd3ca5a8c/schema)