Skip to main content
POST
/
quotes
Create lookup-backed PPV quote.
curl --request POST \
  --url https://public-test.blips.network/quotes \
  --header 'Authorization: Basic <encoded-value>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "lookupId": "lookup_replace_with_fresh_receiver_lookup",
  "source": {
    "accountId": "InternalAccount:replace_with_sender_internal_account"
  },
  "destination": {
    "ppvAddress": "demo-customer@pay.example.blips",
    "currency": "PHP"
  },
  "lockedCurrencySide": "SENDING",
  "lockedCurrencyAmount": "10000",
  "description": "Cross-border customer send",
  "senderCustomerInfo": {
    "FULL_NAME": "Alice Zhang"
  }
}
'
{
  "quoteId": "Quote:quote_123",
  "transactionId": "txn_quote_001",
  "status": "PENDING",
  "createdAt": "2026-04-05T12:00:00Z",
  "expiresAt": "2026-04-05T12:05:00Z",
  "lockedCurrencySide": "SENDING",
  "lockedCurrencyAmount": "10000",
  "sendingAmount": {
    "currencyCode": "USD",
    "amountMinor": "10000"
  },
  "receivingAmount": {
    "currencyCode": "PHP",
    "amountMinor": "542300"
  },
  "feesTotal": {
    "currencyCode": "USD",
    "amountMinor": "180"
  },
  "exchangeRate": "54.23000000",
  "aggregateQuote": {
    "quoteMode": "SEND_FIXED",
    "onRampQuoteRef": "onramp_quote_123",
    "railQuoteRef": "rail_quote_123",
    "offRampQuoteRef": "offramp_quote_123",
    "sendingAmount": {
      "currencyCode": "USD",
      "amountMinor": "10000"
    },
    "receivingAmount": {
      "currencyCode": "PHP",
      "amountMinor": "542300"
    },
    "totalFees": {
      "currencyCode": "USD",
      "amountMinor": "180"
    },
    "effectiveFxRate": "54.23000000",
    "effectiveExchangeRate": "54.23000000",
    "serviceFee": {
      "currencyCode": "USD",
      "amountMinor": "120"
    },
    "receiverFee": {
      "currencyCode": "PHP",
      "amountMinor": "3258"
    },
    "recipientGets": {
      "currencyCode": "PHP",
      "amountMinor": "542300"
    },
    "totalSenderPays": {
      "currencyCode": "USD",
      "amountMinor": "10000"
    },
    "validUntil": "2026-04-05T12:05:00Z",
    "status": "QUOTED"
  }
}

Authorizations

​
Authorization
string
header
required

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

Body

application/json

Frozen MVP public quote-create request: lookup-backed internal-account to PPV-address quote creation only.

​
lookupId
string
required

Fresh receiver lookup handle returned by the earlier receiver lookup step.

​
source
object
required

Sender-side source account for the quote.

​
destination
object
required

Lookup-backed PPV destination for the quote.

​
lockedCurrencySide
enum<string>
required

Which side of the quote is locked: SENDING for send-fixed or RECEIVING for receive-fixed.

Available options:
SENDING,
RECEIVING
​
lockedCurrencyAmount
string
required

Locked amount in minor units on the selected locked currency side.

Pattern: ^[0-9]+$
​
description
string

Optional business description stored with the quote request.

​
senderCustomerInfo
object

Additional payer/customer information required by the lookup context, keyed by field name.

Response

Lookup-backed PPV quote created.

Frozen MVP public quote-create response for the lookup-backed PPV quote lock, outward aggregate quote truth, and the linked public transaction flow.

​
quoteId
string
required

Stable BLIPS quote identifier.

​
transactionId
string
required

Public transaction identifier reserved for the linked execute and transaction readback flow.

​
status
enum<string>
required

Current public quote lifecycle status after create.

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

Quote creation timestamp.

​
expiresAt
string<date-time>
required

RFC 3339 timestamp when this quote expires.

​
lockedCurrencySide
enum<string>
required

Which side of the quote amount is locked.

Available options:
SENDING,
RECEIVING
​
lockedCurrencyAmount
string
required

Locked amount in minor units on the locked currency side.

Pattern: ^[0-9]+$
​
sendingAmount
object
required

Quoted sender-side amount.

​
receivingAmount
object
required

Quoted receiver-side amount.

​
feesTotal
object
required

Total quoted fees.

​
exchangeRate
string
required

Effective quoted exchange rate from sendingAmount to receivingAmount.

​
aggregateQuote
object

Outward aggregate quote truth, including the sender and receiver service-fee line items locked onto this quote at create time.