---
title: "Retrieve Signer-Uploaded File"
method: GET
path: "/signing-requests/{id}/signers/{signer_id}/files/{field_id}"
tags: ["Signing Requests"]
---

# Retrieve Signer-Uploaded File

`GET /signing-requests/{id}/signers/{signer_id}/files/{field_id}`

## Request

- Base URL: `https://api.firma.dev/functions/v1/signing-request-api`
- URL: `https://api.firma.dev/functions/v1/signing-request-api/signing-requests/{id}/signers/{signer_id}/files/{field_id}`
- Auth: API key in header `Authorization`
- TypeScript: <https://skmtc.dev/firma/apis/firma-partner-api/docs/signing-requests/:id/signers/:signer_id/files/:field_id/get.ts> (a function with typed inputs; its response is checked against the schema)

Retrieve a file a signer uploaded to a file field. Returns a short-lived (300s) pre-signed download URL, not the bytes. `field_id` is required (from GET /signing-requests/{id}/fields, filtering type=file). Every retrieval is audit-logged; 60/min limit. Download promptly server-side before the URL expires.

## Path parameters

- `id` string, uuid, required
- `signer_id` string, uuid, required
- `field_id` string, uuid, required

## Response `200`

A short-lived pre-signed URL for the signer-uploaded file.

- object
  - `signer_id` string, uuid
  - `kind` string
  - `file_name` string, nullable
  - `file_type` string, nullable
  - `file_size` integer, nullable
  - `url` string: Pre-signed download URL.
  - `expires_in` integer: Seconds until the URL expires.

## Other responses

- `400`: Field is not a file field (INVALID_FIELD_TYPE).
- `401`: Missing or invalid API key.
- `404`: Not found / not in your workspace (NOT_FOUND) or no file uploaded (SIGNATURE_NOT_AVAILABLE).
- `429`: Rate limit exceeded (60/min).
- `500`: The signed-URL generation failed (INTERNAL_ERROR, answered by serverErrorResponse) or the required access-audit write failed (AUDIT_WRITE_FAILED); no URL is returned.

---

[API](https://skmtc.dev/firma/apis/firma-partner-api.md) - [All operations](https://skmtc.dev/firma/apis/firma-partner-api/llms.txt) - [OpenAPI document](https://skmtc.dev/firma/apis/firma-partner-api/revisions/2febac792e66?raw)