Skip to main content
POST
/
quotes
/
{quoteId}
/
execute
Execute a previously created quote.
curl --request POST \
  --url https://{publicHost}/quotes/{quoteId}/execute \
  --header 'Authorization: Basic <encoded-value>'
{
  "quoteId": "Quote:quote_123",
  "transactionId": "txn_quote_execute_001",
  "status": "PENDING",
  "createdAt": "2026-03-28T10:00:00Z",
  "expiresAt": "2026-03-28T10:15:00Z",
  "source": {
    "accountId": "InternalAccount:sender_usd_001"
  },
  "destination": {
    "ppvAddress": "demo-customer@demo.blips.test"
  },
  "sendingCurrency": {
    "code": "USD"
  },
  "receivingCurrency": {
    "code": "PHP"
  },
  "totalSendingAmount": 10000,
  "totalReceivingAmount": 542300,
  "exchangeRate": 54.23,
  "feesIncluded": true
}

Authorizations

​
Authorization
string
header
required

Integration-key Basic Auth (clientId:clientSecret) as documented in docs/public/AUTHENTICATION.md.

Headers

​
Idempotency-Key
string

Optional idempotency key for safe client retries of this execution action.

Path Parameters

​
quoteId
string
required

Quote identifier returned by quote creation and quote readback flows and used to execute that quote.

Response

Quote execution accepted.

Public transaction-first quote-execute response returned after the public quote execution action is accepted.

​
quoteId
string
required

Quote identifier for the executed quote.

​
transactionId
string
required

Public transaction identifier created or reused for this execution and used on the transaction routes.

​
status
enum<string>
required

Current top-level execution status.

Available options:
PENDING,
PROCESSING,
COMPLETED,
FAILED
​
createdAt
string<date-time>
required

RFC 3339 timestamp when the execution acceptance record was created.

​
expiresAt
string<date-time>
required

RFC 3339 timestamp when the executed quote window expires.

​
source
object
required

Source account snapshot used for this execution.

​
destination
object
required

Destination snapshot used for this execution.

​
sendingCurrency
object
required

Sending currency for the executed quote.

​
receivingCurrency
object
required

Receiving currency for the executed quote.

​
totalSendingAmount
integer
required

Total sender-side amount in minor units for this execution.

​
totalReceivingAmount
integer
required

Total receiver-side amount in minor units for this execution.

​
exchangeRate
required

Execution exchange rate applied to the quote.

​
feesIncluded
boolean
required

Whether the execution totals already include fees.