# Quotes

Quote generation

## Create quote

> Create a new quote for a money transfer transaction. The quote calculates the destination amount based on the current exchange rate and fees. Quotes have an expiration time (configured via quoteExpiryDate).

```json
{"openapi":"3.1.0","info":{"title":"Minit Money Enterprise API","version":"1.12.8"},"tags":[{"name":"Quotes","description":"Quote generation"}],"servers":[{"url":"/api/v1","description":"API v1"},{"url":"/","description":"API v0 (Legacy)"}],"security":[{"ApiKeyAuth":[]}],"components":{"securitySchemes":{"ApiKeyAuth":{"type":"apiKey","in":"header","name":"x-api-key","description":"API key for tenant authentication"}},"schemas":{"CreateQuoteDto":{"type":"object","required":["sender_id","payout_method_id","currency_pair_id","source_amount","destination_amount"],"properties":{"sender_id":{"type":"string","minLength":1,"description":"Unique identifier of the sender initiating the transfer"},"payout_method_id":{"type":"string","minLength":1,"description":"Unique identifier of the payout method (e.g., bank transfer, mobile money)"},"currency_pair_id":{"type":"string","minLength":1,"description":"Unique identifier of the currency pair for the transfer"},"source_amount":{"type":"number","description":"Amount to send in source currency"},"destination_amount":{"type":"number","description":"Expected amount to receive in destination currency. Must be within tolerance of calculated amount based on exchange rate and fees"}}},"QuoteDetails":{"type":"object","properties":{"id":{"type":"string"},"created_at":{"type":"string","format":"date-time"},"updated_at":{"type":["string","null"],"format":"date-time"},"expires_at":{"type":["string","null"],"format":"date-time"},"sender_id":{"type":"string"},"corridor_id":{"type":"string"},"payout_method_id":{"type":"string"},"source_currency_code":{"type":"string"},"destination_currency_code":{"type":"string"},"source_amount":{"type":"number"},"destination_amount":{"type":"number"},"exchange_rate":{"type":"number"},"fee":{"type":"number"}}}}},"paths":{"/quotes":{"post":{"tags":["Quotes"],"summary":"Create quote","description":"Create a new quote for a money transfer transaction. The quote calculates the destination amount based on the current exchange rate and fees. Quotes have an expiration time (configured via quoteExpiryDate).","operationId":"createQuote","requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CreateQuoteDto"}}}},"responses":{"201":{"description":"Quote created successfully","content":{"application/json":{"schema":{"$ref":"#/components/schemas/QuoteDetails"}}}},"400":{"description":"Bad request - Invalid input data or amount mismatch","content":{"application/json":{}}},"401":{"description":"Unauthorized - Invalid or missing API key"},"404":{"description":"Not found - Sender, currency pair, or payout method does not exist","content":{"application/json":{}}},"500":{"description":"Internal server error"}}}}}}
```

## Get quote details

> Retrieve detailed information for a specific quote by ID. Includes exchange rate, fees, source/destination amounts and currencies, and expiration time. Quotes must be used before their expiration time.

```json
{"openapi":"3.1.0","info":{"title":"Minit Money Enterprise API","version":"1.12.8"},"tags":[{"name":"Quotes","description":"Quote generation"}],"servers":[{"url":"/api/v1","description":"API v1"},{"url":"/","description":"API v0 (Legacy)"}],"security":[{"ApiKeyAuth":[]}],"components":{"securitySchemes":{"ApiKeyAuth":{"type":"apiKey","in":"header","name":"x-api-key","description":"API key for tenant authentication"}},"schemas":{"QuoteDetails":{"type":"object","properties":{"id":{"type":"string"},"created_at":{"type":"string","format":"date-time"},"updated_at":{"type":["string","null"],"format":"date-time"},"expires_at":{"type":["string","null"],"format":"date-time"},"sender_id":{"type":"string"},"corridor_id":{"type":"string"},"payout_method_id":{"type":"string"},"source_currency_code":{"type":"string"},"destination_currency_code":{"type":"string"},"source_amount":{"type":"number"},"destination_amount":{"type":"number"},"exchange_rate":{"type":"number"},"fee":{"type":"number"}}}}},"paths":{"/quotes/{quoteId}":{"get":{"tags":["Quotes"],"summary":"Get quote details","description":"Retrieve detailed information for a specific quote by ID. Includes exchange rate, fees, source/destination amounts and currencies, and expiration time. Quotes must be used before their expiration time.","operationId":"getQuoteDetails","parameters":[{"name":"quoteId","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Successfully retrieved quote details including exchange rate and expiry","content":{"application/json":{"schema":{"$ref":"#/components/schemas/QuoteDetails"}}}},"404":{"description":"Not found - Quote does not exist","content":{"application/json":{}}}}}}}}
```


---

# Agent Instructions: 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:

```
GET https://docs.minitmoney.enterprises/raas-api/quotes.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
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.
