---
title: "Retrieve Sign Step Status"
method: GET
path: "/workflows/{id}/sign-status"
tags: ["Workflows"]
---

# Retrieve Sign Step Status

`GET /workflows/{id}/sign-status`

Returns information about a workflow in the sign step. 

**OAuth Scope required:** `public.workflows.readSignStatus` 

**NOTE:** The workflow must be in the sign step to access this route.

## Path parameters

- `id` string, required

## Headers

- `x-as-user-email` string
- `x-as-user-id` string

## Response `200`

200

- SignStatusModel
  - `signers` union[] — All signers associated with the workflow.
    - union
      - SignStatusInternalSigner
        - `name` string, required — The signer's name.
        - `email` string, required — The signer's email.
        - `roleName` string, required — The role name associated with the signer.
        - `status` 'pending' | 'declined' | 'sent' | 'viewed' | 'signed', required — The status of the signer's action on the request.
        - `isWetSigned` boolean — Indicates if the document was physically signed by the signer and then uploaded.
        - `delegates` object[]
          - `name` string — The delegate's name.
          - `email` string — The delegate's email.
        - `routingOrder` integer — Indicates the order in which a signer signs when signing is sequential. NOTE: If a signer signs with wet signature, their routing order is denoted as -1.
        - `type` 'internal', required — Indicates an internal Ironclad user.
        - `userId` string — The user ID associated with the signer.
      - SignStatusExternalSigner
        - `name` string, required — The signer's name.
        - `email` string, required — The signer's email.
        - `roleName` string, required — The role name associated with the signer.
        - `status` 'pending' | 'declined' | 'sent' | 'viewed' | 'signed', required — The status of the signer's action on the request.
        - `isWetSigned` boolean — Indicates if the document was physically signed by the signer and then uploaded.
        - `delegates` object[]
          - `name` string — The delegate's name.
          - `email` string — The delegate's email.
        - `routingOrder` integer — Indicates the order in which a signer signs when signing is sequential. NOTE: If a signer signs with wet signature, their routing order is denoted as -1.
        - `type` 'external', required — Indicates an external signer.
  - `routing` 'sequential' | 'parallel' — Indicates if routing is sequential (signatures collected in order) or parallel (all signers receive request simultaneously).
  - `status` 'not_sent' | 'sent' | 'action_required' | 'complete' — Indicates the status of the signature request. NOTE: If status is 'action_required,' that means signature tags are missing for document.
  - `requireSignedDocumentUpload` boolean — Indicates if the document requires a signed document to be uploaded.
  - `provider` 'Ironclad Clickwrap' | 'Ironclad Signature' | 'Ironclad Signature (Legacy)' | 'DocuSign' | 'Adobe Sign' | 'DropboxSign' | 'Demo' | 'None' — Indicates the signature provider used for the signature request, if any.
  - `scheduledSend` object — Present when a signature request is scheduled. Only returned when status is not_sent.
    - `notifyAt` string, date-time, required — The ISO8601 timestamp for when the signature request is scheduled to be sent.
    - `reminder` object — Reminder configuration, if set.
      - `daysBefore` integer, required — Number of days before the scheduled send when the reminder email will be sent.
      - `reminderDate` string, date-time, required — The computed ISO8601 timestamp when the reminder email will be sent.

## Other responses

- `400` — 400
- `401` — 401
- `403` — 403
- `404` — 404 not found

---

[API](https://skmtc.net/ironcladapp/apis/ironclad-public-api.md) · [All operations](https://skmtc.net/ironcladapp/apis/ironclad-public-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/ironcladapp/ironclad-public-api/versions/9459b4cfc1e0/schema)