# Credit Offers

The **CreditOffer** resource (`co_`) represents a pre-approved credit offer
for a customer. Offers are automatically generated by Dinie when a Customer
reaches the `active` status. You are notified via the `credit_offer.available` webhook.



## List credit offers for a customer

 - [GET /customers/{customer_id}/credit-offers](https://dinie.redocly.app/apis/openapi/credit-offers/listcustomercreditoffers.md): Lists the available credit offers for a specific customer. Filterable by
status (available, accepted, expired). Use this endpoint after receiving the
customer.active webhook to check for pre-approved offers. Pagination uses cursor
with starting_after + limit.

## List credit offers

 - [GET /credit-offers](https://dinie.redocly.app/apis/openapi/credit-offers/listcreditoffers.md): Lists credit offers for all customers of the authenticated partner. Supports filters
by customer_id and status to locate specific offers. Useful for dashboards
and reports that need a consolidated view. For offers of a specific customer,
prefer GET /customers/{customer_id}/credit-offers.

## Retrieve a credit offer

 - [GET /credit-offers/{credit_offer_id}](https://dinie.redocly.app/apis/openapi/credit-offers/getcreditoffer.md): Returns the complete credit offer object, including approved amount
(approved_amount), minimum amount, interest rate (interest_rate), maximum number
of installments, and expiration date (valid_until). Query the offer before creating
a simulation to present the limits to the customer.

## Credit offer available

 - [POST credit_offer.available](https://dinie.redocly.app/apis/openapi/credit-offers/oncreditofferavailable.md): Fires when Dinie generates a new pre-approved credit offer for the customer.
Includes approved amount, interest rate, installments, and offer expiration date.
Use it to notify the customer about credit availability and start the simulation flow
via POST /credit-offers/{id}/simulations.

## Credit offer expired

 - [POST credit_offer.expired](https://dinie.redocly.app/apis/openapi/credit-offers/oncreditofferexpired.md): Fires when a credit offer expires after exceeding its expiration date
(valid_until). Includes the full offer data with expired status.
Use it to remove the offer from the customer interface. New offers may be generated
in the future via credit_offer.available.