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

# Criar solicitação de CNH

> Cria uma nova solicitação de CNH e envia para a fila de processamento assíncrono

Cria uma nova solicitação de CNH e envia para processamento assíncrono.


## OpenAPI

````yaml POST /v1/cnh
openapi: 3.1.0
info:
  title: Tratum API
  description: >-
    Esta documentação fornece as informações necessárias para integrar-se ao
    nosso ecosistema. Nossas APIs permite que os clientes enviem solicitações
    para analisar, consultar, monitorar dados associados a um documento
    específico.
  license:
    name: MIT
  version: 1.0.0
servers:
  - url: https://search.tratum.com.br
security:
  - bearerAuth: []
paths:
  /v1/cnh:
    post:
      tags:
        - CNH
      summary: Criar solicitação de CNH
      description: >-
        Cria uma nova solicitação de CNH e envia para a fila de processamento
        assíncrono
      operationId: issuer
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/CnhSolicitacaoRequest'
      responses:
        '200':
          description: Solicitação criada com sucesso
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/CnhResponse'
        '400':
          description: Dados inválidos na requisição
        '500':
          description: Erro interno ao processar solicitação
components:
  schemas:
    CnhSolicitacaoRequest:
      type: object
      description: Payload para criar uma solicitação de CNH (processamento assíncrono).
      properties:
        organizationId:
          type: integer
          format: int64
          description: ID da organização.
        document:
          type: string
          description: CPF do titular da CNH.
      required:
        - organizationId
        - document
    CnhResponse:
      type: object
      description: Retorno de uma CNH (ou status do processamento).
      properties:
        requestId:
          type: string
          description: Identificador da solicitação.
        organizationId:
          type: integer
          format: int64
          description: ID da organização.
        document:
          type: string
          description: CPF do titular da CNH.
        status:
          type: string
          description: Status do processamento/retorno.
        data:
          type:
            - object
            - 'null'
          description: Dados da CNH, quando disponíveis.
          additionalProperties: true
        createdAt:
          type:
            - string
            - 'null'
          format: date-time
        updatedAt:
          type:
            - string
            - 'null'
          format: date-time
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer

````