> ## Documentation Index
> Fetch the complete documentation index at: https://developers.myhero.so/llms.txt
> Use this file to discover all available pages before exploring further.

# List a document's signature requests

> The document's signature requests, newest first: who each went to, which signature blocks are theirs, and how far each recipient has got.

Link secrets and the copy sent are never returned.

Requires read access to the document.



## OpenAPI

````yaml get /signature/{documentId}/requests
openapi: 3.1.0
info:
  title: HERO API
  version: current
  description: |-
    The HERO REST API.

    See https://developers.myhero.so for the rendered docs.
servers:
  - url: https://app.myhero.so
security: []
paths:
  /signature/{documentId}/requests:
    get:
      tags:
        - Signatures
      summary: List a document's signature requests
      description: >-
        The document's signature requests, newest first: who each went to, which
        signature blocks are theirs, and how far each recipient has got.


        Link secrets and the copy sent are never returned.


        Requires read access to the document.
      operationId: listSignatureRequests
      parameters:
        - schema:
            type: string
            minLength: 1
          required: true
          name: documentId
          in: path
      responses:
        '200':
          description: 200 response
          content:
            application/json:
              schema:
                type: object
                properties:
                  data:
                    type: array
                    items:
                      type: object
                      properties: {}
                      additionalProperties: {}
                required:
                  - data
        '400':
          description: 400 response
          content:
            application/json:
              schema:
                type: object
                properties:
                  error:
                    type: string
                    description: |-
                      Error class name (e.g.

                      ValidationError, NotFound)
                  message:
                    type: string
                    description: Human-readable error message
                  details:
                    type: array
                    items: {}
                required:
                  - error
                  - message
        '403':
          description: 403 response
          content:
            application/json:
              schema:
                type: object
                properties:
                  error:
                    type: string
                    description: |-
                      Error class name (e.g.

                      ValidationError, NotFound)
                  message:
                    type: string
                    description: Human-readable error message
                  details:
                    type: array
                    items: {}
                required:
                  - error
                  - message
      security:
        - bearerAuth: []
components:
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer
      description: HERO personal access token

````

This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.