Skip to main content
Beta - Invoice data is currently in beta. The payload structure may still evolve before general availability. Share your feedback at support@bookingshake.com.

​
Overview

GET /invoices/{id} returns a single invoice by its document ID - useful to back-fill a missed webhook, reconcile your accounting, or re-fetch a document on demand. The endpoint returns standard invoices, deposit invoices, balance invoices, and their credit notes. Quotes are not exposed by this endpoint.
Amounts are always integer cents, dates are YYYY-MM-DD strings in the Europe/Paris timezone, timestamps are Unix milliseconds, and missing values are explicit null. See the invoice webhook reference for the full field-by-field definition.

​
Authentication

All requests require a Bearer token (your BookingShake API key): 
Authorization: Bearer YOUR_API_KEY

​
Path Parameters

​
id
string
required
The invoice document ID - the id field carried by the invoice.created webhook.

​
Request

curl https://api.bookingshake.io/api/invoices/file-789 \
  -H "Authorization: Bearer YOUR_API_KEY"

const res = await fetch("https://api.bookingshake.io/api/invoices/file-789", {
  headers: { Authorization: `Bearer ${process.env.BOOKINGSHAKE_API_KEY}` },
});
const { data: invoice } = await res.json();

import os, requests

res = requests.get(
    "https://api.bookingshake.io/api/invoices/file-789",
    headers={"Authorization": f"Bearer {os.environ['BOOKINGSHAKE_API_KEY']}"},
)
invoice = res.json()["data"]

<?php
$ch = curl_init("https://api.bookingshake.io/api/invoices/file-789");
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
curl_setopt($ch, CURLOPT_HTTPHEADER, [
    "Authorization: Bearer " . getenv("BOOKINGSHAKE_API_KEY"),
]);
$invoice = json_decode(curl_exec($ch), true)["data"];
curl_close($ch);

​
Response

The invoice is returned wrapped in the standard { message, data } envelope. The data object follows the Invoice schema. 
{
  "message": "success",
  "data": {
    "id": "file-789",
    "number": "FAC-2026-0042",
    "type": "balance_invoice",
    "type_code": 380,
    "status": "ongoing",
    "title": "Séminaire Acme - 12 juin 2026",
    "language": "fr",
    "currency": "EUR",
    "created_at": 1749722400000,
    "due_date": "2026-07-12",
    "service_start_date": "2026-06-12",
    "service_end_date": "2026-06-13",
    "purchase_order_number": "PO-2026-1234",
    "amount_excl_tax": 175000,
    "amount_incl_tax": 210000,
    "taxable_breakdown": { "20": 175000 },
    "tax_breakdown": { "20": 35000 },
    "global_discount_excl_tax": 0,
    "lines": [
      {
        "name": "Location salle plénière",
        "description": "Salle de 200 m², vidéoprojecteur et sonorisation inclus",
        "accounting_code": "706100",
        "quantity": "1.00",
        "unit": null,
        "unit_price_excl_tax": 150000,
        "discount": 0,
        "tax_rate": "20.00",
        "total_excl_tax": 150000
      },
      {
        "name": "Forfait journée d'étude",
        "description": null,
        "accounting_code": "707-SEM",
        "quantity": "25.00",
        "unit": null,
        "unit_price_excl_tax": 4000,
        "discount": 0,
        "tax_rate": "20.00",
        "total_excl_tax": 100000
      },
      {
        "name": "Déduction acompte FAC-2026-0021 (TVA 20%)",
        "description": null,
        "accounting_code": null,
        "quantity": "1.00",
        "unit": null,
        "unit_price_excl_tax": -75000,
        "discount": 0,
        "tax_rate": "20.00",
        "total_excl_tax": -75000
      }
    ],
    "booking_id": "booking-abc",
    "quote_id": "quote-123",
    "linked_invoice_id": null,
    "deposit_invoices": [
      {
        "id": "file-456",
        "number": "FAC-2026-0021",
        "date": "2026-05-01",
        "amount_incl_tax": 90000
      }
    ],
    "account_id": "account-123",
    "contact_id": "contact-456",
    "seller": { "id": "venue123", "legal_name": "HOTEL EXAMPLE SAS", "...": "..." },
    "account": { "id": "account-123", "name": "Acme Corp", "...": "..." },
    "contact": { "id": "contact-456", "first_name": "John", "last_name": "Doe", "...": "..." },
    "pdf_url": "https://storage.googleapis.com/.../FAC-2026-0042.pdf",
    "metadata": { "external_ref": "MEWS-2026-0042" }
  }
}

​
Key Fields

FieldTypeDescription
idstringUnique invoice document ID
numberstringInvoice number as printed on the PDF
type / type_codestring / numberDocument type and its UNTDID 1001 code (see Invoice Types)
statusstring | nullongoing, paid, or canceled
amount_excl_tax / amount_incl_taxnumberDocument totals, in cents
linesarrayLine items, self-consistent with the totals
deposit_invoicesarrayFor balance invoices: prior deposits deducted
booking_idstring | nullCorrelation key shared with payment and invoice events of the same booking
seller / account / contactobject | nullFrozen legal-mention snapshots captured at issue time
pdf_urlstring | nullURL of the generated PDF
metadataobjectFree-form integration key/value pairs (strings), editable via PATCH /invoices/{id}. Empty {} when unset
For the complete field reference (amounts, lines, snapshot blocks), see the invoice webhook documentation.

​
Errors

StatusMeaning
400Missing/invalid token, or missing invoice id
404Invoice not found - it does not exist, belongs to another venue, or is not an invoice (e.g. a quote)
429Rate limit exceeded (60 requests/minute)
500Internal server error
A 404 is returned uniformly whenever the invoice is outside your scope, so the existence of another venue’s invoice is never disclosed.

​
Next Steps

Invoice Events

Receive invoices in real time via the invoice.created webhook

Payment Events

Track payments tied to the same booking