Endpoint

List an order's payment instructions

GET/v1/orders/{id}/instructions

Returns the payment instructions of one order, newest first, a page at a time. Each says what to send, where and by which rail, for one asset the payer chose (create a payment instruction).

Scope a restricted key needs: orders:read
Publishable key: Not allowed: secret or restricted key only
Idempotency-Key: Not used. A GET is already safe to repeat.

Parameters

Parameters of List an order's payment instructions
Parameter	Type and place	Meaning
`id`required	stringpath	The id of the order.
`limit`	integerquery	Items per page, 1 to 100. Default 20.
`starting_after`	stringquery	An object id: return the items after it.
`ending_before`	stringquery	An object id: return the items before it.
`created[gte]`	string (date-time)query	Created at or after. Also created[gt], created[lte], created[lt].
`created[lt]`	string (date-time)query	Created before.
`Orrerie-Version`	stringheader	API version date. Default: the version the key was created with. Example `2026-10-11`.

Example request

curl

curl https://api.orrerie.com/v1/orders/ord_0zymngngvf12b8b2cra7tb8e/instructions \
  -H "Authorization: Bearer $ORRERIE_SECRET_KEY"

JavaScript

const response = await fetch("https://api.orrerie.com/v1/orders/ord_0zymngngvf12b8b2cra7tb8e/instructions", {
  headers: {
    Authorization: `Bearer ${process.env.ORRERIE_SECRET_KEY}`,
  },
});
const result = await response.json();
if (!response.ok) throw new Error(`${result.error.code}: ${result.error.message}`);
console.log(result);

Python

import os
import requests

response = requests.get(
    "https://api.orrerie.com/v1/orders/ord_0zymngngvf12b8b2cra7tb8e/instructions",
    headers={"Authorization": f"Bearer {os.environ['ORRERIE_SECRET_KEY']}"},
    timeout=30,
)
result = response.json()
if not response.ok:
    raise RuntimeError(f"{result['error']['code']}: {result['error']['message']}")
print(result)

PHP

<?php
$request = curl_init('https://api.orrerie.com/v1/orders/ord_0zymngngvf12b8b2cra7tb8e/instructions');
curl_setopt_array($request, [
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_HTTPHEADER => [
        'Authorization: Bearer ' . getenv('ORRERIE_SECRET_KEY'),
    ],
]);
$body = curl_exec($request);
if ($body === false) {
    throw new RuntimeException(curl_error($request));
}
$result = json_decode($body, true);
if (curl_getinfo($request, CURLINFO_HTTP_CODE) >= 400) {
    throw new RuntimeException($result['error']['code'] . ': ' . $result['error']['message']);
}
print_r($result);

Responses

`200` OK

A list whose data holds payment_instruction objects. Headers: Orrerie-Request-Id.

Example response, 200

{
  "object": "list",
  "url": "/v1/orders/ord_0zymngngvf12b8b2cra7tb8e/instructions",
  "has_more": false,
  "data": [
    {
      "id": "pin_h73hkjr8dyp4zymaet5e2gbv",
      "object": "payment_instruction",
      "livemode": true,
      "created": "2026-10-11T14:04:10.902Z",
      "order": "ord_0zymngngvf12b8b2cra7tb8e",
      "status": "delivered",
      "rail": "relay",
      "provider": "relay",
      "pay_asset": "ethereum:usdc",
      "pay_amount": "22.410000",
      "amount_mode": "exact",
      "address": {
        "id": "addr_x76q8chyjk6j34he4jrcbb7v",
        "address": "0xfB6916095ca1df60bB79Ce92cE3Ea74c37c5d359",
        "network": "ethereum",
        "owner": "provider",
        "solana_pay_reference": null,
        "derivation": null
      },
      "payment_uri": "ethereum:0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48@1/transfer?address=0xfB6916095ca1df60bB79Ce92cE3Ea74c37c5d359&uint256=22410000",
      "quote": {
        "id": "qt_0fymhdf3w7nem8m9f6rfjtgw",
        "price_amount": "21.99",
        "price_currency": "USD",
        "rate": "1.000200",
        "route_fee": {
          "amount": "0.42",
          "currency": "USD",
          "bearer": "payer"
        },
        "created": "2026-10-11T14:04:10.902Z",
        "expires_at": "2026-10-11T14:19:10.902Z"
      },
      "settle_asset": "base:usdc",
      "settle_amount_expected": "21.990000",
      "confirmations_required": 12,
      "in_transit_notice": "While a payment is being routed it is held by Relay, a separate company. Orrerie never holds it.",
      "wrong_asset_warning": "Send only USDC on Ethereum to this address. Anything else may be lost.",
      "expires_at": "2026-10-11T14:19:10.902Z",
      "late_until": "2026-11-10T14:19:10.902Z",
      "failure_code": null,
      "test_simulation_url": null
    }
  ]
}

Any other status: an error

A status of 400 or above answers with the error object. Branch on its code, never on its message.

Errors

This call has no error of its own. It answers with the errors every call can answer with: a bad key, a missing scope, an object that does not exist, the rate limit. Every error code has its own entry.