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

# List Envelopes

> The **List Envelopes** endpoint returns all envelopes associated with an application in an account.



## OpenAPI

````yaml https://api.gonitro.dev/openapi.json get /sign/envelopes
openapi: 3.1.0
info:
  title: Nitro Sign Public API
  description: REST API for Nitro Sign
  version: '0.1'
servers:
  - url: https://api.gonitro.dev
security:
  - bearerAuth: []
paths:
  /sign/envelopes:
    get:
      tags:
        - Sign
      summary: List Envelopes
      description: >-
        The **List Envelopes** endpoint returns all envelopes associated with an
        application in an account.
      operationId: listEnvelopes
      parameters:
        - name: pageAfter
          in: query
          description: >
            An optional cursor token that instructs the endpoint to return items
            following the last item from the previous response.


            To use this field, include the token value from the `nextPage` field
            of the previous response in the `pageAfter` query parameter to
            retrieve the next batch of envelopes.


            Example:

            ``` shell
              curl --location 'https://api.gonitro.dev/sign/envelopes?pageAfter=<next_page_token>'   --header 'Authorization: Bearer <your_jwt_token>'
            ```


            **Note:** Cannot be used together with `pageBefore`.
          required: false
          schema:
            type: string
        - name: pageBefore
          in: query
          description: >
            An optional cursor token that instructs the endpoint to return items
            preceding the last item from the previous response.


            To use this field, include the token from the `nextPage` field of
            the previous response in the `pageBefore` query parameter to
            retrieve envelopes before the cursor position.


            Example:

            ``` shell

            curl --location
            'https://api.gonitro.dev/sign/envelopes?pageBefore=<next_page_token>'
            --header 'Authorization: Bearer <your_jwt_token>'

            ```

            **Note:** Cannot be used together with `pageAfter`.
          required: false
          schema:
            type: string
      responses:
        '200':
          description: >
            The List Envelopes endpoint returns all envelopes associated with
            your account. Envelopes are returned in an `items` array within the
            JSON response.


            If additional envelopes are available, the initial response will
            include a `nextPage` field containing a string token. If there are
            no more envelopes, this field will be omitted. The token serves as a
            marker for the last item returned and can be used as the starting
            point for your next request.


            The List Envelopes endpoint uses cursor-based pagination for optimal
            performance and consistency when handling large numbers of envelopes
            and frequent data updates.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/EnvelopeList'
        '401':
          description: Unauthorized - Invalid or missing JWT token
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/UnauthorizedProblemDetail'
components:
  schemas:
    EnvelopeList:
      type: object
      description: '#### Fields'
      properties:
        items:
          type: array
          description: An array of envelopes associated with the client's account.
          items:
            $ref: '#/components/schemas/Envelope'
        nextPage:
          type: string
          description: >-
            A cursor token indicating the position of the last item in the
            `items` array, used to retrieve the next page of results.
    UnauthorizedProblemDetail:
      type: object
      description: Unauthorized error details
      example:
        type: >-
          https://developers.gonitro.com/docs/build-nitro/errors#401-unauthorized
        title: Unauthorized
        status: 401
        detail: Missing or invalid Authorization header
        instance: /sign/envelopes
      properties:
        type:
          type: string
          description: A URI reference that identifies the problem type
        title:
          type: string
          description: A short, human-readable summary of the problem type
        status:
          type: integer
          format: int32
          description: The HTTP status code
        detail:
          type: string
          description: A human-readable explanation specific to this occurrence
        instance:
          type: string
          description: A URI reference that identifies the specific occurrence
        extensions:
          type: object
          additionalProperties: {}
          description: Additional problem-specific properties
    Envelope:
      type: object
      properties:
        ID:
          type: string
          format: uuid
          description: >-
            A unique UUIDv4 string that identifies the envelope in the Nitro
            system.
        createdAt:
          type: string
          format: date-time
          description: UTC timestamp indicating when the envelope was created.
        lastModifiedAt:
          type: string
          format: date-time
          description: >-
            UTC timestamp indicating the last time the envelope was updated.
            Matches `createdAt` at the time of creation.
        name:
          type: string
          description: The name of the envelope.
        status:
          type: string
          description: >-
            The internal status of the envelope. Defaults to drafted on
            creation.
          enum:
            - drafted
            - sent
            - processing
            - sealed
            - rejected
            - cancelled
            - deleted
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer
      bearerFormat: JWT

````