---
title: "Retrieve a list of SignRequests"
method: GET
path: "/signrequests/"
tags: ["signrequests"]
---

# Retrieve a list of SignRequests

`GET /signrequests/`

## Query parameters

- `who` string
- `from_email` string
- `page` integer
- `limit` integer

## Response `200`

OK

- object
  - `count` integer, required
  - `next` string, uri, nullable
  - `previous` string, uri, nullable
  - `results` SignRequest[], required
    - `from_email` string, email — Email of user sending the SignRequest (must be a validated email)
    - `from_email_name` string, nullable — Name to be used in the `From` email header, e.g. `{from_email_name} <no-reply@signrequest.com>`
    - `is_being_prepared` boolean, nullable — Have the sender of a SignRequest prepare the document before sending the request out, see: [prepare using the web interface](#section/Preparing-a-document/Prepare-using-the-web-interface)
    - `prepare_url` string, uri
    - `redirect_url` string, uri, nullable — URL at which SignRequest will redirect to when a document is signed
    - `redirect_url_declined` string, uri, nullable — URL at which SignRequest will redirect to when a document is declined
    - `required_attachments` RequiredAttachment[] — Attachments that signers are required to upload
      - `name` string, required
      - `uuid` string
    - `disable_attachments` boolean — Disable uploading/adding of attachments
    - `disable_text_signatures` boolean — Disable usage of signatures generated by typing (text)
    - `disable_text` boolean — Disable adding of text
    - `disable_date` boolean — Disable adding of dates
    - `disable_emails` boolean — Disable all SignRequest status emails as well as the email that contains the signed documents
    - `disable_upload_signatures` boolean — Disable usage of uploaded signatures (images)
    - `force_signature_color` string, nullable — Force specific color for the signature
    - `disable_blockchain_proof` boolean, nullable — Disables storing timestamp proof hashes in blockchain integrations.
    - `text_message_verification_locked` boolean, nullable — When true a text message verification is needed before the signer can see the document
    - `subject` string, nullable — Subject of SignRequest email
    - `message` string, nullable — Message to include in SignRequest email, may contain the following html tags: `a`, `abbr`, `acronym`, `b`, `blockquote`, `code`, `em`, `i`, `ul`, `li`, `ol`, and `strong`
    - `who` 'm' | 'mo' | 'o', nullable — `m`: only me, `mo`: me and others, `o`: only others
    - `send_reminders` boolean — Automatically remind signers to sign a document, see: [automatic reminders](#section/Working-with-a-SignRequest/Automatic-reminders)
    - `signers` Signer[], required
      - `email` string, email, required
      - `display_name` string
      - `first_name` string
      - `last_name` string
      - `email_viewed` boolean
      - `viewed` boolean
      - `signed` boolean
      - `downloaded` boolean
      - `signed_on` string, date-time, nullable
      - `needs_to_sign` boolean — When `false` user does not need to sign, but will receive a copy of the signed document and signing log, see: [Copy only](#section/Additional-signing-methods/Copy-only)
      - `approve_only` boolean — Require user to approve the document (without adding a signature), see: [Approve only](#section/Additional-signing-methods/Approve-only)
      - `notify_only` boolean — Send notifications about the document and a copy of the signed document and signing log, but don't require them to take any action, see: [Notify only](#section/Additional-signing-methods/Notify-only)
      - `in_person` boolean — When used in combination with an embed url on the sender, after sender has signed, they will be redirected to the next `in_person` signer, see: [In person signing](#section/Additional-signing-methods/In-person-signing)
      - `order` integer
      - `language` 'en' | 'en-gb' | 'nl' | 'fr' | 'de' | 'he' | 'da' | 'fi' | 'hu' | 'it' | 'no' | 'pl' | 'pt' | 'es' | 'sv' | 'ru' | 'ja', nullable
      - `force_language` boolean
      - `emailed` boolean
      - `verify_phone_number` string, nullable
      - `verify_bank_account` string, nullable
      - `declined` boolean
      - `declined_on` string, date-time, nullable
      - `forwarded` boolean
      - `forwarded_on` string, date-time, nullable
      - `forwarded_to_email` string, email, nullable
      - `forwarded_reason` string, nullable
      - `message` string, nullable
      - `embed_url_user_id` string, nullable
      - `inputs` SignerInputs[]
        - `type` 's' | 'i' | 'n' | 'd' | 't' | 'c', nullable
        - `page_index` integer, required
        - `text` string
        - `checkbox_value` boolean, nullable
        - `date_value` string, date, nullable
        - `external_id` string, nullable
        - `placeholder_uuid` string, nullable
      - `use_stamp_for_approve_only` boolean, nullable — Place an approval stamp on a document when a signer approves a document
      - `embed_url` string, uri
      - `attachments` SignerAttachment[]
        - `uuid` string
        - `name` string — Defaults to filename
        - `file` string, uri, nullable
        - `for_attachment` RequiredAttachment
          - `name` string, required
          - `uuid` string
      - `redirect_url` string, uri, nullable
      - `redirect_url_declined` string, uri, nullable
      - `after_document` string, uri
      - `integrations` InlineDocumentSignerIntegrationData[]
        - `integration` 'mfiles' | 'salesforce' | 'formdesk' | 'zapier' | 'microsoft-flow', nullable
        - `integration_data` object
      - `password` string — Require the signer to enter this password before signing a document. This field is write only.
    - `uuid` string
    - `url` string, uri
    - `document` string, uri, required
    - `integration` 'mfiles' | 'salesforce' | 'formdesk' | 'zapier' | 'microsoft-flow', nullable
    - `integration_data` object, nullable

---

[API](https://skmtc.net/signrequest/apis/signrequest-api.md) · [All operations](https://skmtc.net/signrequest/apis/signrequest-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/signrequest/signrequest-api/versions/6bbe20e3fe44/schema)