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

# Request contract signatures

> Accepts a contract document for signature and starts the signature process if possible.



## OpenAPI

````yaml /openapi-2025-01-15.init.json post /contracts/{id}/request-signatures
openapi: 3.0.0
info:
  title: Tomorro API
  description: >
    The Tomorro Public API enables you to programmatically manage contracts,
    members, and counterparties. Build powerful integrations that automate your
    contract management workflows.


    ## API Version: 2025-01-15.init


    This documentation is for API version `2025-01-15.init`.


    > **Warning:** This version is deprecated. This version is deprecated.
    Please upgrade to 2025-01-29.alpha.


    ### Using this version

    ```

    curl -X GET https://api.tomorro.com/members \
      -H "x-api-key: YOUR_API_KEY" \
      -H "tomorro-version: 2025-01-15.init"
    ```
  version: 2025-01-15.init
  contact: {}
servers:
  - url: https://api.tomorro.com/v2
    description: Production
  - url: https://api.demo.tomorro.com/v2
    description: Demo
  - url: http://localhost:3015
    description: Local Development
security: []
tags: []
paths:
  /contracts/{id}/request-signatures:
    post:
      tags:
        - Contracts
      summary: Request contract signatures
      description: >-
        Accepts a contract document for signature and starts the signature
        process if possible.
      operationId: ContractController_sendSignature
      parameters:
        - name: id
          required: true
          in: path
          description: The unique identifier (UUID) of the contract
          schema:
            example: 550e8400-e29b-41d4-a716-446655440000
            type: string
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/ContractSendSignatureDto'
      responses:
        '200':
          description: Contract sent for signature successfully
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ContractSignatureSendResponseDto'
        '401':
          description: Unauthorized - Invalid or missing API key
        '403':
          description: Forbidden - Insufficient permissions
        '429':
          description: Too Many Requests - Rate limit exceeded
      security:
        - X-API-KEY: []
components:
  schemas:
    ContractSendSignatureDto:
      type: object
      properties:
        documentId:
          type: string
          description: >-
            Document ID to send for signature. If not provided, the last
            document will be used.
          example: 123e4567-e89b-12d3-a456-426614174000
        signatureNote:
          type: string
          description: Optional note to include with the signature request
          nullable: true
          example: Please review and sign this contract
        isReminderEnabled:
          type: boolean
          description: Whether to enable signature reminders
          default: true
          example: true
    ContractSignatureSendResponseDto:
      type: object
      properties:
        id:
          type: string
          description: Unique identifier for the signature.
          example: sig-123
        status:
          type: string
          description: Signature status
          enum:
            - draft
            - sent
            - signed
            - canceled
          example: sent
        signatories:
          description: List of signatories
          example:
            - id: sig-123
              email: john@example.com
              type: member
              status: signed
              signedAt: '2024-01-15T10:00:00Z'
          type: array
          items:
            $ref: '#/components/schemas/ContractSignatoryResponseDto'
        sentAt:
          type: string
          description: Date when the signature was sent
          example: '2024-01-15T10:00:00Z'
          format: date-time
          nullable: true
      required:
        - id
        - status
        - signatories
    ContractSignatoryResponseDto:
      type: object
      properties:
        id:
          type: string
          description: Unique identifier for the signatory.
          example: sig-1
        email:
          type: string
          description: The email address of the signatory.
          example: john@org.com
          nullable: true
        type:
          type: string
          description: The type of the signatory.
          enum:
            - member
            - guest
            - external
          example: member
        status:
          type: string
          description: The status of the signatory.
          enum:
            - draft
            - sent
            - signed
            - completed
          example: sent
        signedAt:
          type: string
          description: Date when the signatory signed the contract.
          example: '2024-01-15T10:00:00Z'
          format: date-time
          nullable: true
      required:
        - id
        - type
        - status
  securitySchemes:
    X-API-KEY:
      type: apiKey
      in: header
      name: x-api-key
      description: >-
        API key for authentication. Get your key at
        https://app.tomorro.com/settings/integrations?integration=api-key

````