Recipients
Get a recipient
Retrieve a recipient by its ID to read its type, status, ceremony details and completion time while the envelope moves through signing.
Retrieves the details of a recipient, including their current status, ceremony information, and completion timestamp.
Use this endpoint to check a recipient’s progress through the signing workflow. The response includes the full recipient object for the recipient’s type: signer, approver, preparer, automatic signer, or qualified signer. The type property tells you which one.
Path Parameters
The unique identifier of the recipient. Recipient IDs use the re_ prefix.
Returns
Returns a 200 OK status code along with a recipient object if successful, or an error otherwise.
GET /v1/recipients/re_4VP9v4uPj6jwZzQ14CG2O8 HTTP/1.1
Host: api.signatureapi.com
X-API-Key: YOUR_API_KEY{
"id": "re_4VP9v4uPj6jwZzQ14CG2O8",
"envelope_id": "eb4cf433-a8af-4161-b37b-7ef57d423e56",
"type": "signer",
"key": "provider",
"name": "John Smith",
"email": "john.smith@example.com",
"status": "completed",
"ceremony": {
"authentication": [
{
"type": "email_link",
"subject_override": null,
"message_override": null
}
],
"redirect_url": null,
"redirect_delay": 3,
"embeddable_in": [],
"url_variant": "standard",
"url": null
},
"delivery_type": "email",
"ceremony_creation": "automatic",
"signature_options": [
"typed",
"drawn"
],
"completed_at": "2026-11-02T15:21:40.000Z",
"status_updated_at": "2026-11-02T15:21:40.000Z"
}{
"type": "https://signatureapi.com/docs/v1/errors/not-found",
"title": "Not Found",
"status": 404,
"detail": "The recipient was not found."
}Errors every call can return are in Errors and Authentication.