Consultar Proposta

Requisição

Endpoint

• Metodo: GET
• Endpoint: /v2/proposals/{proposal_id}

Parâmetros (Path)

Parâmetro	Tipo	Obrigatório	Descrição
proposal_id	string (uuid)	✅	Identificador da proposta

Exemplo de requisição

GET /v2/proposals/3fa85f64-5717-4562-b3fc-2c963f66afa6

Resposta

Campos da resposta (200)

Parâmetro	Tipo	Descrição
id	string (uuid)	Identificador da proposta
client_id	string (uuid)	Identificador do cliente
status	string	Status da proposta
expires_at	string (date-time)	Data de expiração da proposta
credit_contract_id	string	Identificador do contrato de crédito
quote_id	string (uuid)	Identificador da cotação
premium	string	Prêmio do seguro
lucky_number	integer | null	Número da sorte (se aplicável)
coverage_from	string (date-time)	Início da cobertura
coverage_until	string (date-time)	Fim da cobertura
loan.amount	string	Valor emprestado
loan.period_in_months	integer	Duração do empréstimo (em meses)
person	PersonInfo	Informações do tomador
address	Address	Endereço do tomador
signature	Signature	Informações da assinatura
created_at	string (date-time)	Data de criação
updated_at	string (date-time)	Data da última atualização
cancelled_at	string (date-time) | null	Data de cancelamento

Tipo PersonInfo

Parâmetro	Tipo	Descrição
name	string	Nome do tomador
date_of_birth	string (date)	Data de nascimento do tomador
gender	string	Gênero do tomador
cpf	string	CPF do tomador
marital_status	string	Estado Civil do tomador
phone	string	Telefone do tomador
email	string	Email do tomador

Tipo Address

Parâmetro	Tipo	Descrição
street	string	Logradouro
number	string	Número
complement	string | null	Complemento
zip	string	CEP
neighborhood	string	Bairro
city	string	Cidade
state	string	Estado (UF)

Tipo Signature

Parâmetro	Tipo	Descrição
signature_id	string | null	Identificador da assinatura
signed_at	string (date-time) | null	Data de assinatura do contrato
signature_provider	string | null	Provedor de assinatura

Exemplo (200)

{
  "id": "3fa85f64-5717-4562-b3fc-2c963f66afa4",
  "client_id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
  "status": "PENDING_SIGNATURE",
  "expires_at": "2025-08-11T02:07:49.030Z",
  "credit_contract_id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
  "quote_id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
  "premium": "100.0",
  "lucky_number": null,
  "coverage_from": "2025-08-11T00:00:00.000Z",
  "coverage_until": "2035-08-11T00:00:00.000Z",
  "loan": {
    "amount": "1000.0",
    "period_in_months": 120
  },
  "person": {
    "name": "Fulano de Tal",
    "date_of_birth": "2000-01-01",
    "gender": "M",
    "cpf": "01234567890",
    "marital_status": "SINGLE",
    "phone": "+5551999998888",
    "email": "fulano@mail.com"
  },
  "address": {
    "street": "Rua das Flores",
    "number": "123",
    "complement": "Apto 4",
    "zip": "90010-000",
    "neighborhood": "Centro",
    "city": "Porto Alegre",
    "state": "RS"
  },
  "signature": {
    "signature_id": null,
    "signed_at": null,
    "signature_provider": null
  },
  "created_at": "2025-08-10T02:07:49.030Z",
  "updated_at": "2025-08-10T02:07:49.030Z",
  "cancelled_at": null
}

Erros

Código	HTTP	Descrição
NOT_FOUND	404	Proposta não encontrada.