---
title: "Retrieve an individual signature request on an existing file"
method: GET
path: "/v1/org/{orgId}/signature-request/file/{fileId}"
tags: ["signature-request"]
---

# Retrieve an individual signature request on an existing file

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

## Request

- Base URL: `https://localhost`
- URL: `https://localhost/v1/org/{orgId}/signature-request/file/{fileId}`
- Auth: none declared
- TypeScript: <https://skmtc.dev/charthop/apis/charthop-api/docs/v1/org/:orgId/signature-request/file/:fileId/get.ts> (a function with typed inputs; its response is checked against the schema)

## Path parameters

- `orgId` string, required
- `fileId` string, required

## Response `200`

successful operation

- SignatureRequest
  - `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': the type of entity that stores the signed file, when it is a recognized signature target (person/user/org); null for other file types such as templates
  - `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

## Other responses

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

---

[API](https://skmtc.dev/charthop/apis/charthop-api.md) - [All operations](https://skmtc.dev/charthop/apis/charthop-api/llms.txt) - [OpenAPI document](https://skmtc.dev/charthop/apis/charthop-api/revisions/c4ab2e4f2575?raw)