# A receipt's signed copy

`GET https://api.kapiworks.com/v1/signed-copy`

The signed copy of one receipt of the company, as a PDF: the version as signed, the signature in place, and a signing record page with the document fingerprint and the receipt ID. Kapi draws it on each call and keeps no copy. Requires `acknowledgements:read` and `people:read`, because it names the person who signed. A receipt of another company, or of a person Kapi erased, answers `not_found`.

Scope: `acknowledgements:read`.

## Query parameters

| Name | Type | Required | Description |
| --- | --- | --- | --- |
| `receipt` | string (uuid) | Yes | The receipt's `receipt_id`. |

## Responses

| Status | Description |
| --- | --- |
| 200 | The signed copy, as a PDF download. |
| 400 | RFC 9457 problem details. Codes: invalid_request, invalid_cursor, key_in_url. Act on `code` or `type`; never parse `detail`. |
| 401 | RFC 9457 problem details. Codes: invalid_token. Act on `code` or `type`; never parse `detail`. |
| 403 | RFC 9457 problem details. Codes: insufficient_scope, ip_not_allowed. Act on `code` or `type`; never parse `detail`. |
| 404 | RFC 9457 problem details. Codes: not_found. Act on `code` or `type`; never parse `detail`. |
| 405 | RFC 9457 problem details. Codes: method_not_allowed. Act on `code` or `type`; never parse `detail`. |
| 429 | RFC 9457 problem details. Codes: rate_limited, concurrent_limit. Act on `code` or `type`; never parse `detail`. |
| 502 | RFC 9457 problem details. Codes: read_failed. Act on `code` or `type`; never parse `detail`. |
| 503 | RFC 9457 problem details. Codes: unavailable, upstream_unavailable, writer_unavailable. Act on `code` or `type`; never parse `detail`. |
| 504 | RFC 9457 problem details. Codes: read_timeout. Act on `code` or `type`; never parse `detail`. |

The full contract, with every schema, is at https://api.kapiworks.com/v1/openapi.json.