---
title: "Retrieve Signer Signature Image"
method: GET
path: "/signing-requests/{id}/signers/{signer_id}/signature"
tags: ["Signing Requests"]
---

# Retrieve Signer Signature Image

`GET /signing-requests/{id}/signers/{signer_id}/signature`

## 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}/signature`
- Auth: API key in header `Authorization`
- TypeScript: <https://skmtc.dev/firma/apis/firma-partner-api/docs/signing-requests/:id/signers/:signer_id/signature/get.ts> (a function with typed inputs; its response is checked against the schema)

Retrieve a signer's adopted signature as a base64 PNG data URI, separate from the signed PDF. A signer adopts one signature applied to all their signature fields, so no field_id is needed. Drawn signatures return the captured image; typed signatures are rendered to PNG server-side. The `image` is a `data:image/png;base64,...` URI usable directly in an `<img src>`. By default a signer-ID frame is overlaid (`include_frame=false` to omit). Every successful retrieval is audit-logged. Rate limited to 60/min. Legal validity rests on the sealed PDF and completion certificate, not this image.

## Path parameters

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

## Query parameters

- `include_frame` boolean

## Response `200`

The signer's mark as a base64 PNG data URI.

- object
  - `signer_id` string, uuid
  - `kind` 'signature' | 'initials' | 'stamp'
  - `format` string
  - `framed` boolean: Whether the signer-ID frame was overlaid.
  - `image` string: PNG as a data URI.

## Other responses

- `401`: Missing or invalid API key.
- `404`: Signing request/signer/field not found or not in your workspace (NOT_FOUND), or no mark captured (SIGNATURE_NOT_AVAILABLE).
- `429`: Rate limit exceeded (60/min for signature retrieval).
- `500`: Rendering failed (RENDER_FAILED) or the required access-audit write failed (AUDIT_WRITE_FAILED); no image 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)