---
title: "Get Signature Request"
method: GET
path: "/signature_request/{signature_request_id}"
tags: ["Signature Request"]
---

# Get Signature Request

`GET /signature_request/{signature_request_id}`

Returns the status of the SignatureRequest specified by the `signature_request_id` parameter.

## Path parameters

- `signature_request_id` string, required

## Response `200`

successful operation

- SignatureRequestGetResponse
  - `signature_request` SignatureRequestResponse, required — Contains information about a signature request.
    - `test_mode` boolean — Whether this is a test signature request. Test requests have no legal value. Defaults to `false`.
    - `signature_request_id` string — The id of the SignatureRequest.
    - `requester_email_address` string, nullable — The email address of the initiator of the SignatureRequest.
    - `title` string — The title the specified Account uses for the SignatureRequest.
    - `original_title` string — Default Label for account.
    - `subject` string, nullable — The subject in the email that was initially sent to the signers.
    - `message` string, nullable — The custom message in the email that was initially sent to the signers.
    - `metadata` object — The metadata attached to the signature request.
    - `created_at` integer — Time the signature request was created.
    - `expires_at` integer, nullable — The time when the signature request will expire unsigned signatures. See [Signature Request Expiration Date](https://developers.hellosign.com/docs/signature-request/expiration/) for details.
    - `is_complete` boolean — Whether or not the SignatureRequest has been fully executed by all signers.
    - `is_declined` boolean — Whether or not the SignatureRequest has been declined by a signer.
    - `has_error` boolean — Whether or not an error occurred (either during the creation of the SignatureRequest or during one of the signings).
    - `files_url` string — The URL where a copy of the request's documents can be downloaded.
    - `signing_url` string, nullable — The URL where a signer, after authenticating, can sign the documents. This should only be used by users with existing Dropbox Sign accounts as they will be required to log in before signing.
    - `details_url` string — The URL where the requester and the signers can view the current status of the SignatureRequest.
    - `cc_email_addresses` string[] — A list of email addresses that were CCed on the SignatureRequest. They will receive a copy of the final PDF once all the signers have signed.
    - `signing_redirect_url` string, nullable — The URL you want the signer redirected to after they successfully sign.
    - `final_copy_uri` string, nullable — The path where the completed document can be downloaded
    - `template_ids` string[], nullable — Templates IDs used in this SignatureRequest (if any).
    - `custom_fields` SignatureRequestResponseCustomFieldBase[], nullable — An array of Custom Field objects containing the name and type of each custom field. * Text Field uses `SignatureRequestResponseCustomFieldText` * Checkbox Field uses `SignatureRequestResponseCustomFieldCheckbox`
      - `type` string, required — The type of this Custom Field. Only 'text' and 'checkbox' are currently supported.
      - `name` string, required — The name of the Custom Field.
      - `required` boolean — A boolean value denoting if this field is required.
      - `api_id` string — The unique ID for this field.
      - `editor` string, nullable — The name of the Role that is able to edit this field.
    - `attachments` SignatureRequestResponseAttachment[], nullable — Signer attachments.
      - `id` string, required — The unique ID for this attachment.
      - `signer` string, required — The Signer this attachment is assigned to.
      - `name` string, required — The name of this attachment.
      - `required` boolean, required — A boolean value denoting if this attachment is required.
      - `instructions` string, nullable — Instructions for Signer.
      - `uploaded_at` integer, nullable — Timestamp when attachment was uploaded by Signer.
    - `response_data` SignatureRequestResponseDataBase[], nullable — An array of form field objects containing the name, value, and type of each textbox or checkmark field filled in by the signers.
      - `api_id` string — The unique ID for this field.
      - `signature_id` string — The ID of the signature to which this response is linked.
      - `name` string — The name of the form field.
      - `required` boolean — A boolean value denoting if this field is required.
      - `type` string
    - `signatures` SignatureRequestResponseSignatures[] — An array of signature objects, 1 for each signer.
      - `signature_id` string — Signature identifier.
      - `signer_group_guid` string, nullable — Signer Group GUID
      - `signer_email_address` string — The email address of the signer.
      - `signer_name` string, nullable — The name of the signer.
      - `signer_role` string, nullable — The role of the signer.
      - `order` integer, nullable — If signer order is assigned this is the 0-based index for this signer.
      - `status_code` string — The current status of the signature. eg: awaiting_signature, signed, declined.
      - `decline_reason` string, nullable — The reason provided by the signer for declining the request.
      - `signed_at` integer, nullable — Time that the document was signed or null.
      - `last_viewed_at` integer, nullable — The time that the document was last viewed by this signer or null.
      - `last_reminded_at` integer, nullable — The time the last reminder email was sent to the signer or null.
      - `has_pin` boolean — Boolean to indicate whether this signature requires a PIN to access.
      - `has_sms_auth` boolean, nullable — Boolean to indicate whether this signature has SMS authentication enabled.
      - `has_sms_delivery` boolean, nullable — Boolean to indicate whether this signature has SMS delivery enabled.
      - `sms_phone_number` string, nullable — The SMS phone number used for authentication or signature request delivery.
      - `reassigned_by` string, nullable — Email address of original signer who reassigned to this signer.
      - `reassignment_reason` string, nullable — Reason provided by original signer who reassigned to this signer.
      - `reassigned_from` string, nullable — Previous signature identifier.
      - `error` string, nullable — Error message pertaining to this signer, or null.
    - `bulk_send_job_id` string, nullable — The ID of the Bulk Send job which sent the signature request, if applicable.
  - `warnings` WarningResponse[] — A list of warnings.
    - `warning_msg` string, required — Warning message
    - `warning_name` string, required — Warning name

## Other responses

- `4XX` — failed_operation

---

[API](https://skmtc.net/hellosign/apis/dropbox-sign-api.md) · [All operations](https://skmtc.net/hellosign/apis/dropbox-sign-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/hellosign/dropbox-sign-api/versions/2ea3f04008af/schema)