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

# Criar lote de assinaturas



## OpenAPI

````yaml https://api.juridiq.com.br/api-docs/client/openapi.json post /signature/batch
openapi: 3.1.0
info:
  title: Juridiq API — Documentação para Integradores
  description: ''
  version: 1.0.0
servers:
  - url: https://api.juridiq.com.br
    description: Production server
security:
  - apiKeyAuth: []
tags: []
paths:
  /signature/batch:
    post:
      tags:
        - Signatures
      summary: Criar lote de assinaturas
      requestBody:
        content:
          multipart/form-data:
            schema:
              type: object
              properties:
                files:
                  type: array
                  items:
                    description: Arquivo enviado no multipart/form-data
                  minItems: 2
                  description: Arquivos PDF do lote (mínimo 2, campo files)
                name:
                  type: string
                  description: Nome do lote
                signatories:
                  type: string
                  description: E-mails ou telefones dos signatários, separados por vírgula
                people:
                  type: string
                  description: >-
                    JSON com contatos vinculados. Ex: [{ "id": "uuid", "value":
                    "email@...", "type": "email" }]
                subject:
                  type: string
                  description: Assunto do envio
                message:
                  type: string
                  description: Mensagem enviada aos signatários
                has_chain:
                  type: string
                  description: true para assinatura em cadeia
                request_selfie:
                  type: string
                  description: true para solicitar selfie do signatário
                request_document:
                  type: string
                  description: true para solicitar documento com foto
                request_rubric:
                  type: string
                  description: false para desabilitar rubrica desenhada
                isPrivate:
                  type: string
                  description: true para lote privado no escritório
                due_months:
                  type: string
                  description: Meses de validade dos documentos assinados
                expire_date:
                  type: string
                  description: Data de expiração do pedido de assinatura
                width_page:
                  type: string
                  description: 'Largura da página em pixels. Padrão: 596'
              required:
                - files
                - name
              additionalProperties: false
        required: true
      responses:
        '201':
          description: Default Response
          content:
            application/json:
              schema:
                type: object
                properties:
                  id:
                    type: string
                    format: uuid
                    description: ID do lote
                  name:
                    type: string
                    description: Nome do lote
                  plugsignLoteId:
                    type: string
                    description: ID do lote no PlugSign
                  status:
                    type: string
                    description: Status do lote
                  signatories:
                    description: Signatários do lote
                  officeId:
                    type: string
                    format: uuid
                    description: ID do escritório
                  responsibleId:
                    type: string
                    nullable: true
                    description: ID do responsável
                  isPrivate:
                    type: boolean
                    nullable: true
                    description: Lote privado
                  expireDate:
                    anyOf:
                      - type: string
                        format: date-time
                      - type: string
                    nullable: true
                    description: Data de expiração
                  createdAt:
                    anyOf:
                      - type: string
                        format: date-time
                      - type: string
                    description: Criado em
                  updatedAt:
                    anyOf:
                      - type: string
                        format: date-time
                      - type: string
                    description: Atualizado em
                  responsible:
                    type: object
                    properties:
                      id:
                        type: string
                        description: ID do responsável
                      name:
                        type: string
                        description: Nome do responsável
                      imageUrl:
                        type: string
                        nullable: true
                        description: Foto do responsável
                    required:
                      - id
                      - name
                    additionalProperties: false
                    nullable: true
                  personOnBatches:
                    description: Pessoas vinculadas ao lote
                  signatures:
                    type: array
                    items:
                      type: object
                      properties:
                        id:
                          type: string
                          format: uuid
                          description: ID da assinatura
                        documentName:
                          type: string
                          description: Nome do documento
                        signName:
                          type: string
                          nullable: true
                          description: Nome exibido da assinatura
                        documentKey:
                          type: string
                          description: Chave do documento no PlugSign
                        signingKey:
                          type: string
                          nullable: true
                          description: Chave de assinatura
                        status:
                          type: string
                          description: 'Status. Ex: pending, signed, cancelled'
                        signatories:
                          type: array
                          items:
                            type: object
                            properties:
                              contact:
                                type: string
                              signed:
                                type: boolean
                              url:
                                type: string
                                nullable: true
                            additionalProperties: true
                          description: Signatários com status e link
                        responsibleId:
                          type: string
                          nullable: true
                          description: ID do responsável
                        responsible:
                          type: object
                          properties:
                            id:
                              type: string
                              description: ID do responsável
                            name:
                              type: string
                              description: Nome do responsável
                            imageUrl:
                              type: string
                              nullable: true
                              description: Foto do responsável
                          required:
                            - id
                            - name
                          additionalProperties: false
                          nullable: true
                        isPrivate:
                          type: boolean
                          nullable: true
                          description: Documento privado
                        updatedAt:
                          anyOf:
                            - type: string
                              format: date-time
                            - type: string
                          description: Atualizado em
                        createdAt:
                          anyOf:
                            - type: string
                              format: date-time
                            - type: string
                          description: Criado em
                        personOnSignatures:
                          description: Pessoas vinculadas
                        history:
                          description: Histórico do PlugSign
                      required:
                        - id
                        - documentName
                        - documentKey
                        - status
                        - updatedAt
                        - createdAt
                      additionalProperties: true
                    description: Documentos do lote
                required:
                  - id
                  - name
                  - plugsignLoteId
                  - status
                  - officeId
                  - createdAt
                  - updatedAt
                additionalProperties: true
        '400':
          description: Default Response
          content:
            application/json:
              schema:
                type: object
                properties:
                  message:
                    type: string
                  statusCode:
                    type: number
                  translateMessage:
                    type: string
                required:
                  - message
                  - statusCode
                  - translateMessage
                additionalProperties: false
        '500':
          description: Default Response
          content:
            application/json:
              schema:
                type: object
                properties:
                  message:
                    type: string
                  statusCode:
                    type: number
                  translateMessage:
                    type: string
                required:
                  - message
                  - statusCode
                  - translateMessage
                additionalProperties: false
      security:
        - apiKeyAuth: []
components:
  securitySchemes:
    apiKeyAuth:
      type: apiKey
      in: header
      name: x-juridiq-api-key
      description: >-
        Chave de API do escritório (criada no painel). Envie o valor no header
        x-juridiq-api-key.

````