---
title: "Fetch a Signature Request"
method: GET
path: "/signature_requests/{signatureRequestId}"
tags: ["Signature Request"]
---

# Fetch a Signature Request

`GET /signature_requests/{signatureRequestId}`

Retrieves a given Signature Request.

## Path parameters

- `signatureRequestId` string, uuid, required — The unique identifier for a resource.

## Response `200`

OK

- SignatureRequest — Signature Request that triggered the webhook event.
  - `id` string, uuid, required — Unique identifier of the Signature Request.
  - `status` 'draft' | 'ongoing' | 'done' | 'deleted' | 'expired' | 'canceled' | 'approval' | 'rejected' | 'declined' | 'paused', required — Status of the Signature Request.
  - `name` string, required — Name of the Signature Request.
  - `delivery_mode` 'email' | 'none', required — Specifies who is in charge to notify the Signature Request's participant when an event occurs. In Delivery Mode `email`, the Signer is notified by Youtrust that they have to sign a document. In Delivery Mode `none`, you will be in charge to notify the Signer that a document is ready to be signed.
  - `created_at` string, date-time, required — Signature Request creation date and time.
  - `activated_at` string, date-time, required — Timestamp indicating when the Signature Request was activated and made available to its recipients.\ Returns `null` if the Signature Request is still in `draft`.
  - `completed_at` string, date-time, required — Timestamp indicating when the Signature Request reached the `done` status, i.e. all required Signers have signed and all Approvers have approved.\ Returns `null` if the Signature Request is not yet complete.
  - `approved_at` string, date-time, required — Timestamp indicating when all Approvers have approved the Signature Request when custom recipient flow is not enabled.\ Returns `null` if no approvers are configured, or if at least one approver has not yet approved or when `custom_recipient_order` is enabled.
  - `deleted_at` string, date-time, required — Signature Request deletion date and time.
  - `timezone` string, required — Time zone of the dates and times displayed in emails, the Signature Request expiration date, and the PDF Audit Trail. Format: `tz database`. Default is set to `Europe/Paris`.
  - `email_custom_note` string, required — A custom note added to emails sent to signers. Deprecated.
  - `expiration_date` string, date-time, required — Due date of the Signature Request.
  - `source` 'app' | 'public_api' | 'hubspot_integration' | 'connector_zapier_api', required — Signature Request initialization source.
  - `ordered_signers` boolean, required — Specifies if each signer will be requested to sign in a sequential order.
  - `external_id` string, required — Custom identifier added to webhooks and appended to redirect urls.
  - `workspace_id` string, uuid, required — Specifies which Workspace the Signature Request is into.
  - `sender` UserEmbedded, required
    - `id` string, uuid, required — Unique identifier of the User.
    - `email` string, email, required — Email of the User.
  - `reminder_settings` ReminderSettings, required
    - `interval_in_days` unknown, required
    - `max_occurrences` integer, required — Total number of automatic reminders to send.
  - `signers` SignerEmbedded[], required — Array containing all Signers of the Signature Request.
    - `id` string, uuid, required — Unique identifier of the Signer.
    - `status` 'initiated' | 'notified' | 'consent_given' | 'verified' | 'processing' | 'signed' | 'error' | 'aborted' | 'declined', required — Current status of the Signer in the Signature Request process.
    - `delivery_mode` 'email' | 'none', required — Specifies who is in charge to notify the Signature Request's participant when an event occurs. In Delivery Mode `email`, the Signer is notified by Youtrust that they have to sign a document. In Delivery Mode `none`, you will be in charge to notify the Signer that a document is ready to be signed.
    - `answers` union[], required — The values entered by the Signer in the Fields.
      - union
        - FieldAnswerText — Value provided by the Signer.
          - `field_id` string, uuid, required — Unique identifier of the Field.
          - `field_type` unknown, required
          - `name` string, required — Name of the Field.
          - `question` string, required — Instruction or question shown to the Signer when filling out the Field.
          - `answer` string, required — Answer given by the Signer.
          - `default_value` string, required — Pre-filled value that appears in the field before the Signer provides an answer.
          - `read_only` boolean, required — Indicates whether the field is read-only and cannot be modified by the signer.
        - FieldAnswerCheckbox — Value provided by the Signer.
          - `field_id` string, uuid, required — Unique identifier of the Field.
          - `field_type` unknown, required
          - `name` string, required — Name of the Field.
          - `checked` boolean, required — Indicates whether the checkbox was checked by the Signer.
          - `optional` boolean, required — Indicates whether the field was optional.
          - `read_only` boolean, required — Indicates whether the field is read-only and cannot be modified by the signer.
          - `default_checked` boolean, required — Indicates whether the checkbox was checked by default.
        - FieldAnswerRadioGroup — Value provided by the Signer.
          - `field_id` string, uuid, required — Unique identifier of the Field.
          - `field_type` unknown, required
          - `name` string, required — Name for the radio button group.
          - `optional` boolean, required — Indicates whether the field was optional.
          - `read_only` boolean, required — Indicates whether the field is read-only and cannot be modified by the signer.
          - `radios` object[], required — List of radio button options within the group, including selected state and name for each option.
            - `id` string, uuid, required — Unique identifier of the radio option.
            - `name` string, required — Name of the radio option.
            - `x` integer, required — X-coordinate for positioning the radio option in the document.
            - `y` integer, required — Y-coordinate for positioning the radio option in the document.
            - `checked` boolean, required — Indicates whether this radio option was selected by the Signer.
    - `recipient_stage_index` integer, required — Position of the Signer in the signing flow. Signers with the same index are notified simultaneously.
  - `approvers` ApproverEmbedded[], required — Array containing all Approvers of the Signature Request.
    - `id` string, uuid, required — Unique identifier of the Approver.
    - `status` 'initiated' | 'notified' | 'approved' | 'rejected', required — Current status of the Approver in the Signature Request process.
    - `recipient_stage_index` integer, required — Position of the Approver in the approval flow. Approvers with the same index are notified simultaneously.
  - `labels` Label[], required — Array containing all Labels associated with the Signature Request.
    - `id` string, uuid, required — Unique identifier of the Label.
    - `name` string, required — Name of the Label.
  - `documents` DocumentEmbedded[], required — Array containing all Documents in the Signature Request.
    - `id` string, uuid, required — Unique identifier of the Document.
    - `nature` 'signable_document' | 'attachment', required — Specify if the document is a Signable Document or an Attachment.
  - `custom_properties` CustomProperty[], required — Array containing all Custom Properties associated with the Signature Request.
    - `id` string, uuid, required — ID of the Custom Property.
    - `name` string, required — Name of the Custom Property.
    - `type` 'text' | 'list', required — Type of the Custom Property.
    - `value` string, required — Text value for text properties.
    - `value_ids` string[], required — Array of option ids for list properties.
    - `values` string[], required — Array of option values for list properties.

## Other responses

- `400` — Bad request
- `401` — Access unauthorized
- `403` — Access forbidden
- `404` — Resource not found
- `405` — This method is not allowed
- `429` — Too Many Requests, please try again later.
- `500` — Internal Server Error

---

[API](https://skmtc.net/yousign/apis/public-api-v3.md) · [All operations](https://skmtc.net/yousign/apis/public-api-v3/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/yousign/public-api-v3/versions/8d258c0b45d6/schema)