---
title: "Get a recipient"
description: "Retrieve a recipient by its ID to read its type, status, ceremony details and completion time while the envelope moves through signing."
canonical: "https://signatureapi.com/docs/api/resources/recipients/get"
source: "https://signatureapi.com/docs/api/resources/recipients/get.md"
last_verified_api_version: "1.18.0"
last_modified: "2026-11-18T12:07:52Z"
---

# 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.

_Last verified against API version 1.18.0._

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](https://signatureapi.com/docs/api/resources/recipients/signer), [approver](https://signatureapi.com/docs/api/resources/recipients/approver), [preparer](https://signatureapi.com/docs/api/resources/recipients/preparer), [automatic signer](https://signatureapi.com/docs/api/resources/recipients/automatic-signer), or [qualified signer](https://signatureapi.com/docs/api/resources/recipients/qualified-signer). The `type` property tells you which one.

### Path Parameters

#### `recipient_id` (string, path, required)

The unique identifier of the recipient. Recipient IDs use the `re_` prefix.

### Returns

Returns a `200 OK` status code along with [a recipient object](https://signatureapi.com/docs/api/resources/recipients/object) if successful, or an [error](https://signatureapi.com/docs/api/errors) otherwise.

### Example: Signer

```http
GET /v1/recipients/re_4VP9v4uPj6jwZzQ14CG2O8 HTTP/1.1
Host: api.signatureapi.com
X-API-Key: YOUR_API_KEY
```

Response 200 OK:

```json
{
  "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"
}
```

Response 404 Not Found:

```json
{
  "type": "https://signatureapi.com/docs/v1/errors/not-found",
  "title": "Not Found",
  "status": 404,
  "detail": "The recipient was not found."
}
```

Errors that any request can return (authentication, rate limits, server errors) are on the [Errors](https://signatureapi.com/docs/api/errors) and [Authentication](https://signatureapi.com/docs/api/authentication) pages.
