Skip to main content
POST
/
v1
/
accounts
/
{account_id}
/
quotes
/
{quote_id}
/
execute
curl
curl -X POST "https://api.services.payward.com/v1/accounts/W4BE9868GY65TB6523/quotes/qte_01J0M7C0Z9F8YX3GQH8E/execute" \
  -H "API-Key: $PWS_API_KEY" \
  -H "API-Nonce: $PWS_API_NONCE" \
  -H "API-Sign: $PWS_API_SIGN" \
  -H "Idempotency-Key: 550e8400-e29b-41d4-a716-446655440000"
{
  "data": {
    "id": "Q-BTC2USD-1",
    "status": "executing",
    "executed_at": "2026-04-23T16:00:12Z"
  }
}

Authorizations

​
api-key
string
header
required
​
api-sign
string
header
required
​
api-nonce
string
header
required
​
api-otp
string
header
required

Headers

​
Idempotency-Key
string<uuid>

Client-generated UUIDv4 for safe retries. Sent as the Idempotency-Key HTTP header. Replayed responses include the Idempotent-Replayed: true header.

Pattern: ^[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-4[0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}$
Example:

"550e8400-e29b-41d4-a716-446655440000"

Path Parameters

​
account_id
string
required

ID of the account the request applies to. This refers to one of the accounts held by the user the request is acting on behalf of (typically the user's main account, but any of the user's accounts is accepted). Routes the request to that specific account container. Canonical identifier for an account in the Payward public API.

Required string length: 14 - 42
​
quote_id
string
required

ID of the quote to execute.

Required string length: 1 - 64

Response

Successful response

​
data
object

Result of triggering execution of a quote.