---
title: "Return signature requests"
method: GET
path: "/v1/org/{orgId}/signature-request"
tags: ["signature-request"]
---

# Return signature requests

`GET /v1/org/{orgId}/signature-request`

## Path parameters

- `orgId` string, required

## Query parameters

- `requestUserId` string
- `signUserId` string
- `fromCreateAt` string
- `untilCreateAt` string
- `from` string
- `limit` integer
- `returnAccess` string

## Response `200`

successful operation

- ResultsSignatureRequest
  - `data` SignatureRequest[], required
    - `id` string, required — globally unique id of signature request
    - `orgId` string, required — parent org id
    - `fileId` string, required — file id that is being signed
    - `fileVersionId` string — file version id that is being signed
    - `fileHash` string, required — SHA-256 hash of the contents of the file
    - `fileTemplateId` string — template id that was used to generate the file, if applicable
    - `externalId` string — external id, if an external signature service is used
    - `externalService` string — external signature service name (e.g. boldsign)
    - `standard` 'QES' — signature standard used, defaults to SES if not specified
    - `fileEntityId` string, required — the entity that stores the signed file
    - `fileEntityType` 'PERSON' | 'USER' | 'ORG', required — the entity that stores the signed file
    - `status` 'PENDING' | 'SIGNED' | 'DECLINED' | 'CANCELED', required — the overall status of this signature request
    - `signers` SignatureSigner[], required — the signers of this signature request
      - `userId` string, required
      - `status` 'PENDING' | 'SIGNED' | 'DECLINED' | 'CANCELED', required
      - `order` integer, required
    - `requestAt` string, required — the timestamp that the request was made
    - `requestUserId` string, required — the user who made the request to sign
    - `notifyUserIds` string[] — additional user ids to notify on signature events
    - `signAt` string — the timestamp that it was signed, if it was signed
    - `cancelAt` string — the timestamp that it was canceled, if it was canceled
    - `declineAt` string — the timestamp that it was declined, if it was declined
    - `createId` string — created by user id
    - `createBehalfId` string — created on behalf of user id
    - `createAttribution` Attribution
      - `principalUserId` string
      - `agentUserIds` string[]
      - `eventId` string
      - `aiChatId` string
      - `aiToolUseId` string
      - `channel` 'WEB' | 'MOBILE' | 'SLACK' | 'TEAMS' | 'MCP'
    - `createAt` string — created timestamp
    - `updateId` string — last updated by user id
    - `updateBehalfId` string — last updated on behalf of user id
    - `updateAttribution` Attribution
      - `principalUserId` string
      - `agentUserIds` string[]
      - `eventId` string
      - `aiChatId` string
      - `aiToolUseId` string
      - `channel` 'WEB' | 'MOBILE' | 'SLACK' | 'TEAMS' | 'MCP'
    - `updateAt` string — last updated timestamp
  - `next` string
  - `access` ResultsAccess[]
    - `ids` string[]
    - `allowed` AccessAction[], required
      - `action` string, required
      - `fields` string[]
      - `types` string[]

## Other responses

- `400` — bad request
- `401` — not authorized
- `404` — not found

---

[API](https://skmtc.net/charthop/apis/charthop-api.md) · [All operations](https://skmtc.net/charthop/apis/charthop-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/charthop/charthop-api/revisions/26da34ae934f/schema)