Skip to main content
GET
/
invoices
/
{invoice_number}
Get Invoice
curl --request GET \
  --url https://payments.shakesco.com/invoices/{invoice_number} \
  --header 'Authorization: Bearer <token>'
{
  "id": 1,
  "user_id": 42,
  "invoice_number": "INV-2026-a1b2c3d4",
  "status": "pending",
  "type": "public",
  "currency": "USD",
  "tax_rate": "0.00",
  "is_business": true,
  "receiver": "business@example.com",
  "receiver_country": "US",
  "payer_name": "Jane Doe",
  "payer_email": "customer@example.com",
  "payer_country": null,
  "asset": null,
  "amount": null,
  "rate": null,
  "tx_hash_link": null,
  "receipt_number": null,
  "payment_url": "https://pay.shakesco.com/@business/a1b2c3...",
  "expires_at": "2026-05-23T10:00:00.000000Z",
  "scanned_at": null,
  "paid_at": null,
  "store_item_ids": null,
  "name": "business",
  "image": "https://example.com/avatar.jpg",
  "created_at": "2026-05-16T10:00:00.000000Z",
  "updated_at": "2026-05-16T10:00:00.000000Z",
  "transaction_items": [
    {
      "id": 1,
      "crypto_transaction_id": 1,
      "description": "Platform Services",
      "unit": "1",
      "price": "1400",
      "image": null,
      "created_at": "2026-05-16T10:00:00.000000Z",
      "updated_at": "2026-05-16T10:00:00.000000Z"
    }
  ]
}

Documentation Index

Fetch the complete documentation index at: https://docs.shakesco.com/llms.txt

Use this file to discover all available pages before exploring further.

For the complete documentation index, see llms.txt. Returns a single invoice by its number. The response includes two extra fields injected by the API for payment-page rendering: name (the receiver’s username) and image (the receiver’s profile photo URL).

​
Path Parameters

​
invoice_number
string
required
The invoice’s unique identifier (e.g. INV-2026-a1b2c3d4)

​
Response

​
invoice_number
string
The invoice identifier
​
status
string
"pending", "scanned", "paid", "expired", or "void"
​
payment_url
string
URL the customer opens to pay
​
name
string
Receiver’s username (injected for payment-page rendering)
​
image
string | null
Receiver’s profile photo URL (injected for payment-page rendering)
​
transaction_items
array
Line items on the invoice
const response = await fetch(
  "https://payments.shakesco.com/invoices/INV-2026-a1b2c3d4",
  { headers: { Authorization: `Bearer ${API_KEY}` } }
);
const invoice = await response.json();

{
  "id": 1,
  "user_id": 42,
  "invoice_number": "INV-2026-a1b2c3d4",
  "status": "pending",
  "type": "public",
  "currency": "USD",
  "tax_rate": "0.00",
  "is_business": true,
  "receiver": "business@example.com",
  "receiver_country": "US",
  "payer_name": "Jane Doe",
  "payer_email": "customer@example.com",
  "payer_country": null,
  "asset": null,
  "amount": null,
  "rate": null,
  "tx_hash_link": null,
  "receipt_number": null,
  "payment_url": "https://pay.shakesco.com/@business/a1b2c3...",
  "expires_at": "2026-05-23T10:00:00.000000Z",
  "scanned_at": null,
  "paid_at": null,
  "store_item_ids": null,
  "name": "business",
  "image": "https://example.com/avatar.jpg",
  "created_at": "2026-05-16T10:00:00.000000Z",
  "updated_at": "2026-05-16T10:00:00.000000Z",
  "transaction_items": [
    {
      "id": 1,
      "crypto_transaction_id": 1,
      "description": "Platform Services",
      "unit": "1",
      "price": "1400",
      "image": null,
      "created_at": "2026-05-16T10:00:00.000000Z",
      "updated_at": "2026-05-16T10:00:00.000000Z"
    }
  ]
}