# Dinie API Documentation

Welcome to the official Dinie API documentation. Dinie's embedded lending platform enables partners to offer credit products directly within their applications through a simple, well-documented API.

## Get Started in Minutes

New to the Dinie API? Follow our **[Quick Start guide](/guides/quickstart)** to make your first API call and understand the core integration flow.

## Explore the Documentation

### Getting Started

| Guide | Description |
|  --- | --- |
| [Quick Start](/guides/quickstart) | Make your first API call in minutes |
| [Authentication](/apis/concepts/authentication) | API key setup and environment management |
| [Error Handling](/apis/concepts/errors) | HTTP status codes and error response format |
| [Pagination](/apis/concepts/pagination) | Navigate large result sets efficiently |


### Integration Guides

| Guide | Description |
|  --- | --- |
| [Customer Registration](/guides/customer-registration) | Register customers and start credit analysis |
| [Credit Workflow](/guides/credit-workflow) | Full credit lifecycle from analysis to disbursement |
| [Webhooks](/apis/concepts/webhooks) | Real-time event notifications for your integration |


### API Reference

Browse the complete **[API Reference](/apis/openapi)** for detailed endpoint documentation, request/response schemas, and interactive code samples.

## How It Works

The integration with Dinie combines two parallel processes:

- **Credit Analysis** -- starts automatically when a customer is registered
- **KYC Verification** -- the customer completes at their own pace


A customer can only take out a loan when **both** are completed: at least one active credit offer (`credit_offer.available`) and approved KYC (`customer.active`).


```
Partner App                    Dinie API
    |                              |
    |-- POST /v3/customers ------->|  Register customer
    |                              |-- Credit analysis starts
    |                              |-- KYC verification starts
    |                              |
    |<-- Webhook: credit_offer ----|  Credit offer available
    |<-- Webhook: customer.active -|  KYC approved
    |                              |
    |-- POST /v3/loans ----------->|  Create loan
    |<-- Webhook: loan.disbursed --|  Funds transferred
```

## Need Help?

- Visit [dinie.com.br](https://dinie.com.br) for more information about the platform
- Contact your Dinie partner manager for API credentials and support