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

# Retrieve Signer Initials Image

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

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

Retrieve a signer's adopted initials as a base64 PNG data URI. One initials mark per signer (no field_id). Same response shape, framing, audit, and rate limit as the signature endpoint.

## 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/7326991ebc59?raw)
