# Retornar o contrato por id

Recupera os detalhes de um contrato específico por ID. Útil quando quiser exibir ou sincronizar todos os dados de um contrato específico.

Endpoint: GET /v1/contratos/{id}
Version: v1
Security: BearerAuth

## Security:

  - `BearerAuth` (unknown)
    apiKey in header Authorization

## Path parameters:

  - `id` (string, required)
    ID do contrato (UUID)

## Response 200:

  - `200` (unknown)
    OK

## Response 200 fields (application/json):

  - `cliente` (object)
    Resumo dos dados do cliente vinculado ao contrato

  - `cliente.id` (string)
    ID do cliente
    Example: 123e4567-e89b-12d3-a456-426614174000

  - `cliente.nome` (string)
    Nome do cliente
    Example: João da Silva

  - `composicao_valor` (object)
    Resumo da composição de valores do contrato

  - `composicao_valor.desconto` (number)
    Valor do desconto aplicado
    Example: 200

  - `composicao_valor.frete` (number)
    Valor do frete
    Example: 50

  - `composicao_valor.valor_bruto` (number)
    Valor bruto do contrato
    Example: 1200

  - `composicao_valor.valor_impostos_servico` (number)
    Valor total dos impostos sobre o serviço
    Example: 100

  - `composicao_valor.valor_liquido` (number)
    Valor líquido do contrato
    Example: 1050

  - `condicao_pagamento` (object)
    Resumo das condições de pagamento do contrato

  - `condicao_pagamento.dia_vencimento` (integer)
    Dia do mês para vencimento do pagamento
    Example: 15

  - `condicao_pagamento.nome_conta_financeira` (string)
    Nome da conta financeira vinculada ao pagamento
    Example: Conta Corrente

  - `condicao_pagamento.observacoes_pagamento` (string)
    Observações sobre o pagamento
    Example: Pagamento mensal

  - `condicao_pagamento.tipo_pagamento` (string)
    Tipo de pagamento do contrato
    Enum: "BOLETO_BANCARIO", "CARTAO_CREDITO", "CARTAO_DEBITO", "CARTEIRA_DIGITAL", "CASHBACK", "CHEQUE", "CREDITO_LOJA", "CREDITO_VIRTUAL", "DEPOSITO_BANCARIO", "DINHEIRO", "OUTRO", "DEBITO_AUTOMATICO", "LINK_PAGAMENTO", "PIX_PAGAMENTO_INSTANTANEO", "COBRANCA_PIX", "PROGRAMA_FIDELIDADE", "SEM_PAGAMENTO", "TRANSFERENCIA_BANCARIA", "VALE_ALIMENTACAO", "VALE_COMBUSTIVEL", "VALE_PRESENTE", "VALE_REFEICAO"

  - `configuracao_recorrencia` (object)
    Resumo da configuração de recorrência do contrato

  - `configuracao_recorrencia.vigencia_restante` (integer)
    Vigência restante do contrato
    Example: 12

  - `configuracao_recorrencia.vigencia_total` (integer)
    Vigência total do contrato
    Example: 24

  - `data_proxima_emissao` (string)
    Data da próxima emissão
    Example: 2026-09-15

  - `data_proximo_vencimento` (string)
    Data do próximo vencimento
    Example: 2026-09-15

  - `data_ultima_emissao` (string)
    Data da última emissão
    Example: 2026-08-15

  - `id` (string)
    ID do contrato
    Example: 123e4567-e89b-12d3-a456-426614174000

  - `id_proxima_venda_agendada` (string)
    ID da próxima venda agendada
    Example: 123e4567-e89b-12d3-a456-426614174002

  - `id_ultima_venda_confirmada` (string)
    ID da última venda confirmada
    Example: 123e4567-e89b-12d3-a456-426614174001

  - `local_prestacao_servico` (object)
    Resumo do local de prestação de serviço do contrato

  - `local_prestacao_servico.nome` (string)
    Nome do local de prestação de serviço
    Example: Escritório Central

  - `observacoes` (string)
    Observações adicionais sobre o contrato
    Example: Contrato de venda recorrente para serviços de consultoria.

  - `status` (string)
    Status do contrato
    Enum: "ATIVO", "INATIVO", "DELETADO"

  - `termos` (object)
    Resumo dos termos do contrato

  - `termos.data_fim` (string)
    Data de término do contrato
    Example: 2026-10-21

  - `termos.data_inicio` (string)
    Data de início do contrato
    Example: 2026-08-15

  - `termos.dia_emissao_venda` (integer)
    Dia do mês para emissão da venda
    Example: 15

  - `termos.intervalo_frequencia` (integer)
    Intervalo entre as cobranças (ex: a cada 1 mês)
    Example: 1

  - `termos.numero` (integer)
    Número do contrato
    Example: 1

  - `termos.tipo_expiracao` (string)
    Tipo de expiração do contrato
    Enum: "DATA", "VEZES", "NUNCA"

  - `termos.tipo_frequencia` (string)
    Tipo de frequência de cobrança
    Enum: "MENSAL", "SEMANAL", "ANUAL"

  - `vendedor` (object)
    Resumo dos dados do vendedor responsável pelo contrato

  - `vendedor.id` (string)
    ID do vendedor
    Example: 123e4567-e89b-12d3-a456-426614174000

  - `vendedor.nome` (string)
    Nome do vendedor
    Example: Maria Oliveira

## Response 400:

  - `400` (unknown)
    Bad Request

## Response 400 fields (application/json):

  - `error` (string)
    Mensagem de erro
    Example: Mensagem de erro detalhada

## Response 401:

  - `401` (unknown)
    Unauthorized

## Response 401 fields (application/json):

  - `error` (string)
    Mensagem de erro
    Example: Mensagem de erro detalhada

## Response 404:

  - `404` (unknown)
    Not Found

## Response 404 fields (application/json):

  - `error` (string)
    Mensagem de erro
    Example: Mensagem de erro detalhada

## Response 429:

  - `429` (unknown)
    Too Many Requests

## Response 429 fields (application/json):

  - `error` (string)
    Mensagem de erro
    Example: Mensagem de erro detalhada

## Response 500:

  - `500` (unknown)
    Internal Server Error

## Response 500 fields (application/json):

  - `error` (string)
    Mensagem de erro
    Example: Mensagem de erro detalhada