> ## Documentation Index
> Fetch the complete documentation index at: https://developers.bumxpress.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Quotes

> Create quotes before initiating payins, payouts, or transfers.

Quotes lock fees, FX, provider routing, and amounts for 15 minutes. Create a fresh quote before every payin, payout, or transfer.

## Quote types

| Endpoint                 | Use case                                          |
| ------------------------ | ------------------------------------------------- |
| `POST /quotes/payin`     | Collect money from a customer.                    |
| `POST /quotes/payout`    | Send money to a recipient.                        |
| `POST /quotes/transfer`  | Collect from a payer and disburse to a recipient. |
| `GET /quotes/{quote_id}` | Read an existing quote.                           |

## Payin quote example

```json theme={null}
{
  "country_code": "CM",
  "operator_code": "CM_MTN_MOMO",
  "rail_type": "mobile_money",
  "send_amount": "10000",
  "send_currency": "XAF"
}
```

## Statuses

| Status    | Meaning                                                       |
| --------- | ------------------------------------------------------------- |
| `active`  | The quote can be used to create a payin, payout, or transfer. |
| `expired` | The quote is past `expires_at`; create a new quote.           |