> For the complete documentation index, see [llms.txt](https://docs.bullcredtech.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.bullcredtech.com/api-reference/apis-en/queries/get-proposals-by-id.md).

# Search by ID

**GET** `/proposals/{proposalId}`

Returns detailed information about a specific proposal, including customer data, selected offer, contract, and digital signature.

## URL Parameters

| Parameter    | Type          | Description |
| ------------ | ------------- | ----------- |
| `proposalId` | string (UUID) | Proposal ID |

## Success Response (200 OK)

```json
{
  "id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
  "cpf": "12345678909",
  "full_name": "JOHN DOE",
  "birth_date": "1985-03-15",
  "email": "john@example.com",
  "phone": "+5511999999999",
  "status": "CONTRACT_GENERATED",
  "status_detail": {
    "code": "CONTRACT_GENERATED",
    "name": "Contract Generated",
    "description": "Contract generated based on the proposal information",
    "order": 12
  },
  "analysis_status_code": "APPROVED",
  "analysis_status_message": "Credit analysis approved",
  "origin": "EXAMPLE_ORIGIN",
  "selected_offer_id": "offer-uuid-123",
  "selected_offer": {
    "id": "offer-uuid-123",
    "principal_amount": 10000.00,
    "interest_rate": 1.99,
    "installments": 24,
    "installment_amount": 520.50,
    "total_amount": 12492.00,
    "first_due_date": "2025-02-10",
    "iof_amount": 189.50,
    "cet_monthly": 2.15,
    "cet_yearly": 28.95
  },
  "bank_code": "001",
  "agency": "1234",
  "account": "56789",
  "account_type": "checking_account",
  "contract_id": "contract-uuid-456",
  "contract_details": {
    "celcoin_application_id": "CCB123456",
    "principal_amount": 10000.00,
    "interest_rate": 1.99,
    "installments": 24,
    "total_amount": 12492.00,
    "installment_amount": 520.50,
    "first_due_date": "2025-02-10",
    "disbursement_date": "2025-01-15"
  },
  "digital_signature": {
    "signature_id": "sig-uuid-789",
    "unico_process_id": "unico-process-123",
    "user_redirect_url": "https://cadastro.unico.app/process/unico-process-123",
    "status": "PENDING",
    "expires_at": "2025-01-16T21:00:00.000Z"
  },
  "created_at": "2025-01-14T10:30:00.000Z",
  "updated_at": "2025-01-14T15:45:00.000Z"
}
```

### Response Fields

| Field                     | Type          | Description                                     |
| ------------------------- | ------------- | ----------------------------------------------- |
| `id`                      | string (UUID) | Unique proposal ID                              |
| `cpf`                     | string        | Customer CPF                                    |
| `full_name`               | string        | Full name                                       |
| `birth_date`              | string        | Date of birth                                   |
| `email`                   | string        | Customer email                                  |
| `phone`                   | string        | Customer phone                                  |
| `status`                  | string        | Current proposal status                         |
| `status_detail`           | object        | Status details (code, name, description, order) |
| `analysis_status_code`    | string        | Credit analysis result code                     |
| `analysis_status_message` | string        | Friendly result message                         |
| `origin`                  | string        | Originator code                                 |

### Selected Offer (`selected_offer`)

| Field                | Type          | Description                |
| -------------------- | ------------- | -------------------------- |
| `id`                 | string (UUID) | Offer ID                   |
| `principal_amount`   | number        | Net loan amount            |
| `interest_rate`      | number        | Monthly interest rate (%)  |
| `installments`       | number        | Number of installments     |
| `installment_amount` | number        | Amount of each installment |
| `total_amount`       | number        | Total amount to be paid    |
| `first_due_date`     | string        | Date of the first due date |
| `iof_amount`         | number        | IOF amount                 |
| `cet_monthly`        | number        | Monthly CET (%)            |
| `cet_yearly`         | number        | Annual CET (%)             |

### Bank Details

| Field          | Type   | Description                                          |
| -------------- | ------ | ---------------------------------------------------- |
| `bank_code`    | string | Bank code for disbursement                           |
| `agency`       | string | Bank branch                                          |
| `account`      | string | Account number                                       |
| `account_type` | string | Account type (`checking_account`, `savings_account`) |

### Contract (`contract_details`)

| Field                    | Type   | Description                |
| ------------------------ | ------ | -------------------------- |
| `celcoin_application_id` | string | CCB number                 |
| `principal_amount`       | number | Net loan amount            |
| `interest_rate`          | number | Monthly interest rate (%)  |
| `installments`           | number | Number of installments     |
| `total_amount`           | number | Total amount               |
| `installment_amount`     | number | Amount of each installment |
| `first_due_date`         | string | Date of the first due date |
| `disbursement_date`      | string | Expected disbursement date |

### Digital Signature (`digital_signature`)

| Field               | Type              | Description                                                       |
| ------------------- | ----------------- | ----------------------------------------------------------------- |
| `signature_id`      | string (UUID)     | Unique signature ID                                               |
| `unico_process_id`  | string (UUID)     | UNICO process ID                                                  |
| `user_redirect_url` | string (URL)      | Signing URL                                                       |
| `status`            | string            | Status: `PENDING`, `IN_PROGRESS`, `SIGNED`, `EXPIRED`, `REJECTED` |
| `expires_at`        | string (ISO 8601) | Signature deadline                                                |

### Timestamps

| Field        | Type              | Description      |
| ------------ | ----------------- | ---------------- |
| `created_at` | string (ISO 8601) | Creation date    |
| `updated_at` | string (ISO 8601) | Last update date |

## Possible Errors

| Code | Message            |
| ---- | ------------------ |
| 404  | Proposal not found |

## Notes

* The available fields depend on the proposal's current status
* Fields such as `selected_offer`, `contract_details` and `digital_signature` are only present when the flow has advanced to these stages
* Useful for querying the complete status of the proposal after webhook notifications


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://docs.bullcredtech.com/api-reference/apis-en/queries/get-proposals-by-id.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.