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

# List quote signers

> Retrieve the signature circuit of a quote, step by step, with the signature status of each signer.



## OpenAPI

````yaml get /v1/quotes/{id}/signers
openapi: 3.1.0
info:
  title: Hyperline API
  version: 0.0.0
servers:
  - url: https://api.hyperline.co
  - url: https://sandbox.api.hyperline.co
security: []
paths:
  /v1/quotes/{id}/signers:
    get:
      tags:
        - Quotes
      summary: List quote signers
      description: >-
        Retrieve the signature circuit of a quote, step by step, with the
        signature status of each signer.
      operationId: listQuoteSigners
      parameters:
        - schema:
            type: string
          required: true
          name: id
          in: path
      responses:
        '200':
          description: ''
          content:
            application/json:
              schema:
                type: array
                items:
                  $ref: '#/components/schemas/QuoteSigner'
        '404':
          description: Quote not found
          content:
            application/json:
              schema:
                type: object
                properties:
                  message:
                    type: string
                required:
                  - message
      security:
        - bearer: []
components:
  schemas:
    QuoteSigner:
      type: object
      properties:
        id:
          type: string
          description: Quote signer ID.
          example: quor_4XyQhGd8P3CYaX
        kind:
          type: string
          enum:
            - external
            - countersigner
          description: >

            Signer kind.


            - `external`: A signer on the customer side.

            - `countersigner`: A signer on your side, who signs after the
            customer.
          example: external
        step_order:
          type: integer
          description: >-
            Position of the signer in the signature circuit, starting at 1.
            Signers with the same step order sign in parallel.
          example: 1
        user_id:
          type:
            - string
            - 'null'
          description: >-
            ID of the Hyperline user acting as the countersigner. Only allowed
            on a `countersigner`; their email and name are then taken from the
            user.
          example: null
        email:
          type: string
          format: email
          description: Email address of the signer.
          example: jane@customer.com
        first_name:
          type:
            - string
            - 'null'
          description: >-
            First name of the signer. Required by electronic signature
            providers.
          example: Jane
        last_name:
          type:
            - string
            - 'null'
          description: Last name of the signer. Required by electronic signature providers.
          example: Doe
        language:
          type:
            - string
            - 'null'
          enum:
            - fr
            - en
            - de
            - it
            - lt
            - nl
            - es
            - pt
            - pl
          description: >-
            Language of the emails and signature page sent to the signer.
            Defaults to the customer language.
          example: en
        status:
          type: string
          enum:
            - pending
            - notified
            - viewed
            - signed
            - declined
          description: |

            Signer status.

            - `pending`: Not notified yet.
            - `notified`: The signer received the quote by email.
            - `viewed`: The signer opened the quote.
            - `signed`: The signer signed the quote.
            - `declined`: The signer declined the quote.
          example: notified
        notified_at:
          type:
            - string
            - 'null'
          format: date-time
          description: >-
            Date the signer was last notified. UTC date time string in the [ISO
            8601](https://en.wikipedia.org/wiki/ISO_8601) format.
          example: '2024-04-24T09:12:00.000Z'
        viewed_at:
          type:
            - string
            - 'null'
          format: date-time
          description: >-
            Date the signer first opened the quote. UTC date time string in the
            [ISO 8601](https://en.wikipedia.org/wiki/ISO_8601) format.
          example: null
        signed_at:
          type:
            - string
            - 'null'
          format: date-time
          description: >-
            Date the signer signed the quote. UTC date time string in the [ISO
            8601](https://en.wikipedia.org/wiki/ISO_8601) format.
          example: null
        declined_at:
          type:
            - string
            - 'null'
          format: date-time
          description: >-
            Date the signer declined the quote. UTC date time string in the [ISO
            8601](https://en.wikipedia.org/wiki/ISO_8601) format.
          example: null
        decline_reason:
          type:
            - string
            - 'null'
          description: Reason given by the signer when declining the quote.
          example: null
        created_at:
          type: string
          format: date-time
          description: >-
            Signer creation date. UTC date time string in the [ISO
            8601](https://en.wikipedia.org/wiki/ISO_8601) format.
          example: '2024-04-24T09:10:00.220Z'
        updated_at:
          type: string
          format: date-time
          description: >-
            Signer last update date. UTC date time string in the [ISO
            8601](https://en.wikipedia.org/wiki/ISO_8601) format.
          example: '2024-04-24T09:12:00.000Z'
      required:
        - id
        - kind
        - step_order
        - user_id
        - email
        - first_name
        - last_name
        - language
        - status
        - notified_at
        - viewed_at
        - signed_at
        - declined_at
        - decline_reason
        - created_at
        - updated_at
  securitySchemes:
    bearer:
      type: http
      scheme: bearer
      bearerFormat: JWT

````

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