Skip to main content
POST
/
v1
/
users
/
{userId}
/
quotes
Create a Quote
curl --request POST \
  --url https://remittances.sandbox.api-us.meridianapps.dev:80/v1/users/{userId}/quotes \
  --header 'Content-Type: application/json' \
  --header 'X-Meridian-Api-Key: <x-meridian-api-key>' \
  --header 'X-Meridian-Signature: <x-meridian-signature>' \
  --header 'X-Meridian-Timestamp: <x-meridian-timestamp>' \
  --data '
{
  "amount": 50,
  "fromCurrency": "USD",
  "toCurrency": "PHP"
}
'
{
  "quote": {
    "id": "quote_01HT2P6W9PC2QV4W0Q63QMFJ44",
    "userId": "usr_01HT2P6W9PC2QV4W0Q63QMFJ44",
    "fromAmount": 50,
    "remainingBalance": 150,
    "toAmount": 2800,
    "exchangeRate": 56,
    "fromCurrency": "USD",
    "toCurrency": "PHP",
    "expiresAt": "2026-06-10T14:30:00Z"
  }
}
Legacy endpoint. This is part of the legacy withdrawal flow and will be deprecated. An upcoming Transactions Intent API will replace it. Avoid building new integrations against this endpoint — contact your Solutions Engineer for migration guidance.

Headers

​
X-Meridian-Api-Key
string
required

API key issued by Meridian during provisioning. See Authentication.

​
X-Meridian-Timestamp
string
required

Current time in milliseconds since the Unix epoch. Must be within 60 seconds of the request. See Authentication.

​
X-Meridian-Signature
string
required

HMAC SHA-256 signature of the canonical request string, computed per request. See Authentication for how to construct it.

Path Parameters

​
userId
string
required

ID of the user the quote is created for

Body

application/json

Details of the quote to be created

​
amount
number
required

Amount to convert, expressed in the source currency

Example:

50

​
fromCurrency
string
required

ISO 4217 currency code to convert from (for example, USD)

Example:

"USD"

​
toCurrency
string
required

ISO 4217 currency code to convert to (for example, PHP)

Example:

"PHP"

Response

Quote created successfully

​
quote
QuoteDto · object
required