> 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/api-reference-client/get-customers-contracts.md).

# List Customer Contracts

**GET** `/customers/{cpf}/contracts`

Returns all contracts associated with a CPF within the authenticated channel. Useful for displaying the customer's contracting history or validating active contracts before starting a new proposal.

{% hint style="info" %}
**Query scope**

The query returns only contracts from the authenticated channel itself. Contracts for the same CPF in other channels are not listed.
{% endhint %}

## URL parameters

| Parameter | Type   | Description                                 |
| --------- | ------ | ------------------------------------------- |
| `cpf`     | string | Customer's CPF (digits only, 11 characters) |

## Request Example

```http
GET /customers/12345678909/contracts HTTP/1.1
Authorization: Bearer your_token
```

## Success Response (200 OK)

```json
{
  "cpf": "12345678909",
  "total": 2,
  "contracts": [
    {
      "contract_id": "9f195264-b1f5-415f-97ea-8e7a51e04238",
      "proposal_id": "99afc6ce-4720-4746-9cf6-0a23e85cdf75",
      "status": "ISSUED",
      "celcoin_application_id": "CCB123456",
      "principal_amount": 25153.66,
      "total_amount": 41903.28,
      "installment_amount": 2327.96,
      "installments": 18,
      "interest_rate": 4.99,
      "disbursement_amount": 25153.66,
      "disbursement_date": "2026-04-21T00:00:00.000Z",
      "disbursement_paid_at": "2026-04-21T13:45:00.000Z",
      "first_due_date": "2026-05-21T00:00:00.000Z",
      "final_due_date": "2027-10-21T00:00:00.000Z",
      "issue_date": "2026-04-20T18:30:00.000Z",
      "created_at": "2026-04-20T18:25:00.000Z"
    }
  ]
}
```

### Response Fields

| Field       | Type    | Description                        |
| ----------- | ------- | ---------------------------------- |
| `cpf`       | string  | Queried CPF                        |
| `total`     | integer | Total number of contracts returned |
| `contracts` | array   | List of customer contracts         |

### Fields for Each Contract (`contracts[]`)

| Field                    | Type                      | Description                                     |
| ------------------------ | ------------------------- | ----------------------------------------------- |
| `contract_id`            | string (UUID)             | Unique contract ID                              |
| `proposal_id`            | string (UUID)             | ID of the proposal that originated the contract |
| `status`                 | string                    | Current contract status                         |
| `celcoin_application_id` | string \| null            | CCB number                                      |
| `principal_amount`       | number                    | Net loan amount                                 |
| `total_amount`           | number                    | Total amount to be paid                         |
| `installment_amount`     | number                    | Amount of each installment                      |
| `installments`           | integer                   | Number of installments                          |
| `interest_rate`          | number                    | Monthly interest rate (%)                       |
| `disbursement_amount`    | number \| null            | Amount actually disbursed                       |
| `disbursement_date`      | string (ISO 8601) \| null | Expected disbursement date                      |
| `disbursement_paid_at`   | string (ISO 8601) \| null | Date/time when the disbursement was confirmed   |
| `first_due_date`         | string (ISO 8601) \| null | Date of the first due date                      |
| `final_due_date`         | string (ISO 8601) \| null | Date of the last due date                       |
| `issue_date`             | string (ISO 8601) \| null | Contract issue date                             |
| `created_at`             | string (ISO 8601)         | Record creation date                            |

## Possible Errors

| Code | Message                                |
| ---- | -------------------------------------- |
| 400  | Invalid CPF. Enter only the 11 digits. |

## Notes

* When the CPF has no contracts in the authenticated channel, the response returns `contracts: []` and `total: 0`
* The contracts are listed regardless of status (including canceled, active, and completed)
* To query a specific proposal in detail, use [GET /proposals/{proposalId}](https://github.com/BullCredTech/bull-api-docs-gitbook/tree/main/fluxo-da-proposta/get-proposals-by-id.md)


---

# 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/api-reference-client/get-customers-contracts.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.