---
title: "Consultar informações de uma proposta."
method: GET
path: "/api/v1/proposal"
tags: ["Empresas"]
---

# Consultar informações de uma proposta.

`GET /api/v1/proposal`

## Request

- Base URL: `https://api-clientes.meuk8.com.br`
- URL: `https://api-clientes.meuk8.com.br/api/v1/proposal`
- Auth: HTTP bearer

**Empresas- Consultar informações de um a proposta enviada**<br/>Permite que seja acessado os detalhes específicos de uma proposta individual que foi enviado para uma empresa da plataforma.<br/><br/>**Funcionalidades do Endpoint:**<br/>-   **Status da Proposta:** O status atual da proposta.<br/><br/>**Requisição**<br/><table><thead><tr><th>Campo</th><th>Tipo</th><th>Descrição</th><th>Obrigatoriedade</th></tr></thead><tbody><tr><td>cnpj</td><td>Texto</td><td>CNPJ da empresa</td><td>Sim</td></tr><tr><td>client-id</td><td>Texto</td><td>Client ID enviado no Header</td><td>Sim</td></tr></tbody></table><br/><br/>**Resposta**<br/><table><thead><tr><th>Campo</th><th>Tipo</th><th>Descrição</th></tr></thead><tbody><tr><td>identification</td><td>Texto</td><td>CNPJ da empresa.</td></tr><tr><td>companyName</td><td>Texto</td><td>Nome da empresa.</td></tr><tr><td>client_type</td><td>Texto</td><td>Categoria da proposta.</td></tr><tr><td>flow</td><td>Texto</td><td>Tipo de conta da proposta.</td></tr><tr><td>accounts</td><td>Objeto</td><td>Objeto com contas vinculadas a proposta.</td></tr><tr><td>accountNumber</td><td>Texto</td><td>Número da conta.</td></tr><tr><td>accountName</td><td>Texto</td><td>Nome da conta.</td></tr><tr><td>status</td><td>Texto</td><td>Status atualdo andamento da proposta.</td></tr></tbody></table>

## Query parameters

- `cnpj` string, required

## Headers

- `client-id` string, uuid, required

## Response `200`

Proposta localizada com sucesso.

- object
  - `message` string
  - `data` object[]
    - `proposals` object[]
      - `identification` string
      - `companyName` string
      - `client_type` string
      - `flow` string
      - `accounts` object[]
        - `accountNumber` string
        - `accountName` string
        - `status` string

## Other responses

- `400`: Nenhuma proposta localizada para este cnpj
- `401`: Invalid client data.
- `403`: Invalid token.
- `422`: Invalid input fields.

---

[API](https://skmtc.dev/meuk8/apis/k8-api-conta.md) - [All operations](https://skmtc.dev/meuk8/apis/k8-api-conta/llms.txt) - [OpenAPI document](https://skmtc.dev/meuk8/apis/k8-api-conta/revisions/edfe92cb11ff?raw)