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

# Get e-sign bundle

> Get metadata for an e-sign bundle including status, signers and documents. Returns URLs only (no file binaries). Returns 404 when the bundle is not found, belongs to another organization, or has visibility restrictions on the attachment group or any document (same opaque response in all cases). Documents are sorted by attachment order (ascending, same as in the Noux UI); signers by email (ascending). Authenticate using Bearer token with your Noux API key.



## OpenAPI

````yaml /openapi.json get /api/v1/esign/bundle/{id}
openapi: 3.0.0
info:
  title: Noux REST API
  version: 1.0.0
  description: This page contains the standard OpenAPI specification for the Noux REST API.
  contact:
    name: Noux Digital Oy
    url: https://nouxdigital.com/
servers:
  - url: https://api.noux.app
    description: Production API
  - url: http://localhost:4000
    description: Local development
security: []
paths:
  /api/v1/esign/bundle/{id}:
    get:
      tags:
        - E-sign
      summary: Get e-sign bundle
      description: >-
        Get metadata for an e-sign bundle including status, signers and
        documents. Returns URLs only (no file binaries). Returns 404 when the
        bundle is not found, belongs to another organization, or has visibility
        restrictions on the attachment group or any document (same opaque
        response in all cases). Documents are sorted by attachment order
        (ascending, same as in the Noux UI); signers by email (ascending).
        Authenticate using Bearer token with your Noux API key.
      parameters:
        - schema:
            type: string
            description: The e-sign bundle ID to retrieve
          required: true
          description: The e-sign bundle ID to retrieve
          name: id
          in: path
        - schema:
            type: string
            description: Bearer token with Noux API key
          required: true
          description: Bearer token with Noux API key
          name: authorization
          in: header
      responses:
        '200':
          description: E-sign bundle retrieved successfully
          content:
            application/json:
              schema:
                type: object
                properties:
                  bundleId:
                    type: string
                  status:
                    type: string
                    enum:
                      - Draft
                      - PendingSigners
                      - AllSigned
                      - Completed
                      - Voided
                  bundleName:
                    type: string
                  createdAt:
                    type: string
                    format: date-time
                  updatedAt:
                    type: string
                    format: date-time
                  roomId:
                    type: string
                    nullable: true
                  roomName:
                    type: string
                    nullable: true
                  owner:
                    type: object
                    properties:
                      id:
                        type: string
                      email:
                        type: string
                        nullable: true
                        format: email
                      firstName:
                        type: string
                        nullable: true
                      lastName:
                        type: string
                        nullable: true
                    required:
                      - id
                      - email
                      - firstName
                      - lastName
                  signers:
                    type: array
                    items:
                      type: object
                      properties:
                        id:
                          type: string
                        email:
                          type: string
                          format: email
                        firstName:
                          type: string
                        lastName:
                          type: string
                        signedAt:
                          type: string
                          nullable: true
                          format: date-time
                      required:
                        - id
                        - email
                        - firstName
                        - lastName
                        - signedAt
                  completion:
                    type: object
                    nullable: true
                    properties:
                      completionId:
                        type: string
                      completedAt:
                        type: string
                        format: date-time
                    required:
                      - completionId
                      - completedAt
                  documents:
                    type: array
                    items:
                      type: object
                      properties:
                        name:
                          type: string
                        createdAt:
                          type: string
                          format: date-time
                        signable:
                          type: boolean
                        isCompletionDocument:
                          type: boolean
                        source:
                          oneOf:
                            - type: object
                              properties:
                                kind:
                                  type: string
                                  enum:
                                    - file
                                originalUrl:
                                  type: string
                                  format: uri
                                mimeType:
                                  type: string
                                fileSize:
                                  type: integer
                              required:
                                - kind
                                - originalUrl
                                - mimeType
                                - fileSize
                            - type: object
                              properties:
                                kind:
                                  type: string
                                  enum:
                                    - link
                                url:
                                  type: string
                                  format: uri
                              required:
                                - kind
                                - url
                            - type: object
                              properties:
                                kind:
                                  type: string
                                  enum:
                                    - loom
                                embedUrl:
                                  type: string
                                  format: uri
                                thumbnailUrl:
                                  type: string
                                  format: uri
                              required:
                                - kind
                                - embedUrl
                                - thumbnailUrl
                            - type: object
                              properties:
                                kind:
                                  type: string
                                  enum:
                                    - reference
                                referenceId:
                                  type: string
                                originalUrl:
                                  type: string
                                  format: uri
                                mimeType:
                                  type: string
                              required:
                                - kind
                                - referenceId
                      required:
                        - name
                        - createdAt
                        - signable
                        - isCompletionDocument
                        - source
                required:
                  - bundleId
                  - status
                  - bundleName
                  - createdAt
                  - updatedAt
                  - roomId
                  - roomName
                  - owner
                  - signers
                  - completion
                  - documents
        '400':
          description: Bad request - invalid input
          content:
            application/json:
              schema:
                type: object
                properties:
                  error:
                    type: boolean
                    enum:
                      - true
                    description: Indicates this is an error response
                  code:
                    type: string
                    enum:
                      - PARSE_ERROR
                      - BAD_REQUEST
                      - INTERNAL_SERVER_ERROR
                      - NOT_IMPLEMENTED
                      - METHOD_NOT_SUPPORTED
                      - TIMEOUT
                      - CONFLICT
                      - PRECONDITION_FAILED
                      - PAYLOAD_TOO_LARGE
                      - UNPROCESSABLE_CONTENT
                      - TOO_MANY_REQUESTS
                      - CLIENT_CLOSED_REQUEST
                      - INVALID_INPUT
                      - UNAUTHORIZED
                      - NOT_FOUND
                      - FORBIDDEN
                      - INVALID_STATE
                      - SERVER_ERROR
                    description: Error code for programmatic handling
                  message:
                    type: string
                    description: Human-readable error message
                required:
                  - error
                  - code
                  - message
        '401':
          description: Unauthorized - invalid or missing API key
          content:
            application/json:
              schema:
                type: object
                properties:
                  error:
                    type: boolean
                    enum:
                      - true
                    description: Indicates this is an error response
                  code:
                    type: string
                    enum:
                      - PARSE_ERROR
                      - BAD_REQUEST
                      - INTERNAL_SERVER_ERROR
                      - NOT_IMPLEMENTED
                      - METHOD_NOT_SUPPORTED
                      - TIMEOUT
                      - CONFLICT
                      - PRECONDITION_FAILED
                      - PAYLOAD_TOO_LARGE
                      - UNPROCESSABLE_CONTENT
                      - TOO_MANY_REQUESTS
                      - CLIENT_CLOSED_REQUEST
                      - INVALID_INPUT
                      - UNAUTHORIZED
                      - NOT_FOUND
                      - FORBIDDEN
                      - INVALID_STATE
                      - SERVER_ERROR
                    description: Error code for programmatic handling
                  message:
                    type: string
                    description: Human-readable error message
                required:
                  - error
                  - code
                  - message
        '404':
          description: >-
            E-sign bundle not found, wrong organization, or visibility
            restricted
          content:
            application/json:
              schema:
                type: object
                properties:
                  error:
                    type: boolean
                    enum:
                      - true
                    description: Indicates this is an error response
                  code:
                    type: string
                    enum:
                      - PARSE_ERROR
                      - BAD_REQUEST
                      - INTERNAL_SERVER_ERROR
                      - NOT_IMPLEMENTED
                      - METHOD_NOT_SUPPORTED
                      - TIMEOUT
                      - CONFLICT
                      - PRECONDITION_FAILED
                      - PAYLOAD_TOO_LARGE
                      - UNPROCESSABLE_CONTENT
                      - TOO_MANY_REQUESTS
                      - CLIENT_CLOSED_REQUEST
                      - INVALID_INPUT
                      - UNAUTHORIZED
                      - NOT_FOUND
                      - FORBIDDEN
                      - INVALID_STATE
                      - SERVER_ERROR
                    description: Error code for programmatic handling
                  message:
                    type: string
                    description: Human-readable error message
                required:
                  - error
                  - code
                  - message
      security:
        - BearerAuth: []
components:
  securitySchemes:
    BearerAuth:
      type: http
      scheme: bearer
      bearerFormat: API Key
      description: Noux API key from your integration settings

````