---
title: "List Signature Requests"
method: GET
path: "/signature_requests"
tags: ["Signature Request"]
---

# List Signature Requests

`GET /signature_requests`

Returns the list of all Signatures Requests in your organization. You can limit the number of items returned by using filters and pagination. Consult our guide for more details and examples.

## Query parameters

- `after` string
- `limit` integer
- `status` object — Filter by status.
- `created_at` object — Filter by date of creation.
- `activated_at` object — Filter by activation date.
- `completed_at` object — Filter by completion date.
- `approved_at` object — Filter by approval date.
- `rejected_at` object — Filter by rejection date.
- `declined_at` object — Filter by decline date.
- `workspace_id` object — Filter by workspace_id.
- `external_id` object — Filter by external_id.
- `source` object — Filter by source.
- `q` string
- `label.name` object — Case sensitive filter by Label's name.

## Response `200`

OK

- GetSignatureRequests200Response
  - `meta` Pagination — Metadata about the response.
    - `next_cursor` string, nullable, required — Token to get the next page of results. If `null`, there are no more pages.
  - `data` SignatureRequestInList[]
    - `id` string, required
    - `status` 'draft' | 'ongoing' | 'done' | 'deleted' | 'expired' | 'canceled' | 'approval' | 'rejected' | 'declined' | 'paused', required
    - `name` string, required
    - `delivery_mode` 'email' | 'none', required
    - `created_at` string, date-time, required
    - `activated_at` string, date-time, nullable, 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, nullable, 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, nullable, 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.
    - `ordered_signers` boolean, required — Enable an ordered workflow, each Signer will be requested to sign in a sequential order
    - `ordered_approvers` boolean, required — Enable an ordered workflow, each Approver will be requested to approve in a sequential order
    - `reminder_settings` SignatureRequestInListReminderSettings, nullable, required
      - `interval_in_days` 1 | 2 | 7 | 14, required
      - `max_occurrences` integer, required
    - `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, nullable, required
    - `expiration_date` string, date-time, required
    - `source` 'app' | 'public_api' | 'hubspot_integration' | 'connector_salesforce_api' | 'connector_google_api' | 'connector_zapier_api', required
    - `signers` SignatureRequestInListSignersInner[], required
      - `id` string, required
      - `status` 'initiated' | 'declined' | 'notified' | 'verified' | 'processing' | 'consent_given' | 'signed' | 'aborted' | 'error', required
    - `approvers` SignatureRequestInListApproversInner[]
      - `id` string, required
      - `status` 'initiated' | 'notified' | 'approved' | 'rejected', required
    - `labels` SignatureRequestLabel[] — Labels associated to the Signature Request
      - `id` string, uuid, required — Unique identifier of the Label.
      - `name` string, required — Name of the Label.
    - `documents` SignatureRequestInListDocumentsInner[], required
      - `id` string, required
      - `nature` 'attachment' | 'signable_document', required
    - `sender` SignatureRequestInListSender, nullable, required
      - `id` string
      - `email` string
    - `external_id` string, nullable, required
    - `branding_id` string, uuid, nullable, required
    - `custom_experience_id` string, uuid, nullable, required
    - `signers_allowed_to_decline` boolean, required
    - `workspace_id` string, uuid
    - `audit_trail_locale` 'de' | 'en' | 'es' | 'fr' | 'it' | 'pt' | 'ro', required
    - `bulk_send_batch_id` string, uuid, nullable, required
    - `workflow_session_id` string, uuid, nullable, required — Unique identifier of a Workflow Session. When provided, an Action is created in the Workflow Session, and this resource is associated with that Action.
    - `previous_attempt_id` string, uuid, nullable, required — ID of the previous attempt within the same `workflow_session_id`. Allows continuity between multiple attempts of the same Action. Null if this is the first attempt.
    - `custom_recipient_order` boolean, required — Enable a custom recipients order
    - `custom_properties` CustomPropertyInList[] — Custom properties associated with the Signature Request.
      - `id` string, uuid, required — Unique identifier of the custom property.
      - `name` string, required — Display name of the property.
      - `type` 'text' | 'list', required
      - `required` boolean — Whether users must fill this property before sending the SR via the application (not enforced via API).
      - `multiple_answer_allowed` boolean, nullable — For list type only — whether multiple options can be selected. Null for text type.
      - `workspace_ids` UUID[], nullable — List of workspace IDs where this property is applicable. Null means org-wide.
      - `default_value` string, nullable — For text type only — default text pre-filled on new signature requests. Null for list type.
      - `options` CustomPropertyOption[], nullable — For list type only: selectable options. Null for text type.
        - `id` string, uuid, required — Unique identifier of the option
        - `value` string, required — Display text of the option
        - `is_default` boolean, required — Whether this option is pre-selected on new SRs
        - `position` integer, required — Sort order

## Other responses

- `400` — Bad request
- `401` — Access unauthorized
- `403` — Access forbidden
- `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/revisions/8d258c0b45d6/schema)