Nookhive Logo
StyleguideAPI Reference

Invoicing API

Generate and manage invoices, receipts, and credit notes for your bookings.

Overview

The Invoicing API allows you to generate professional invoices for bookings, send receipts, and manage credit notes. All invoices are generated as PDFs with your organization's branding.

Invoices can be generated individually or in bulk for multiple bookings.

Base Path

https://api.nookhive.com/v1/invoicing

Invoice Endpoints

GET/v1/invoicing/bookings

List Invoiced Bookings

Returns a paginated list of bookings with their invoice status.

Parameters

NameTypeDescription
pageintegerPage number (default: 1)
limitintegerResults per page (default: 20, max: 100)
eventSlugstringFilter by event slug
hasInvoicebooleanFilter by invoice existence
Example RequestBASH
curl -X GET "https://api.nookhive.com/v1/invoicing/bookings?eventSlug=annual-conference-2026" \
  -H "Authorization: Bearer nk_live_your_api_key_here"
POST/v1/invoicing/create

Create Invoice

Generate an invoice for a specific booking.

Parameters

NameTypeDescription
bookingId*stringThe booking ID to create invoice for
invoiceNumberstringCustom invoice number (auto-generated if not provided)
sellerReferencestringInternal reference for the seller
notesstringAdditional notes to include on the invoice
Example RequestBASH
curl -X POST "https://api.nookhive.com/v1/invoicing/create" \
  -H "Authorization: Bearer nk_live_your_api_key_here" \
  -H "Content-Type: application/json" \
  -d '{
    "bookingId": "bkg_abc123",
    "invoiceNumber": "INV-2026-001",
    "sellerReference": "PO-12345",
    "notes": "Thank you for your business"
  }'
ResponseJSON
{
  "invoice": {
    "id": "inv_xyz789",
    "invoiceNumber": "INV-2026-001",
    "bookingId": "bkg_abc123",
    "status": "GENERATED",
    "totalAmount": 398.00,
    "currency": "USD",
    "pdfUrl": "https://files.nookhive.com/invoices/inv_xyz789.pdf",
    "createdAt": "2026-01-15T10:00:00Z"
  }
}
POST/v1/invoicing/bulk-generate

Bulk Generate Invoices

Generate invoices for multiple bookings at once.

Parameters

NameTypeDescription
bookingIds*string[]Array of booking IDs
prefixstringInvoice number prefix
Example RequestBASH
curl -X POST "https://api.nookhive.com/v1/invoicing/bulk-generate" \
  -H "Authorization: Bearer nk_live_your_api_key_here" \
  -H "Content-Type: application/json" \
  -d '{
    "bookingIds": ["bkg_abc123", "bkg_def456", "bkg_ghi789"],
    "prefix": "INV-2026"
  }'
POST/v1/invoicing/bookings/{id}/send-receipt

Send Receipt

Send a payment receipt to the booking attendee via email.

Parameters

NameTypeDescription
id*stringBooking ID
emailstringOverride recipient email (uses attendee email by default)
Example RequestBASH
curl -X POST "https://api.nookhive.com/v1/invoicing/bookings/bkg_abc123/send-receipt" \
  -H "Authorization: Bearer nk_live_your_api_key_here"

Credit Note Endpoints

Credit notes are used to issue partial or full refunds against invoices.

GET/v1/invoicing/bookings/{id}/credit-notes

List Credit Notes

Get all credit notes associated with a booking.

Parameters

NameTypeDescription
id*stringBooking ID
Example RequestBASH
curl -X GET "https://api.nookhive.com/v1/invoicing/bookings/bkg_abc123/credit-notes" \
  -H "Authorization: Bearer nk_live_your_api_key_here"
POST/v1/invoicing/bookings/{id}/credit-notes

Create Credit Note

Create a credit note to issue a refund against an invoice.

Parameters

NameTypeDescription
id*stringBooking ID
amount*numberCredit amount
reason*stringReason for the credit note
Example RequestBASH
curl -X POST "https://api.nookhive.com/v1/invoicing/bookings/bkg_abc123/credit-notes" \
  -H "Authorization: Bearer nk_live_your_api_key_here" \
  -H "Content-Type: application/json" \
  -d '{
    "amount": 100.00,
    "reason": "Partial refund for service issue"
  }'

The Invoice Object

{
  "id": "inv_xyz789",
  "invoiceNumber": "INV-2026-001",
  "bookingId": "bkg_abc123",
  "organizationId": "org_abc123",
  "status": "SENT",
  "lineItems": [
    {
      "description": "Standard Ticket - Annual Conference 2026",
      "quantity": 2,
      "unitPrice": 199.00,
      "amount": 398.00
    }
  ],
  "subtotal": 398.00,
  "tax": 0.00,
  "totalAmount": 398.00,
  "currency": "USD",
  "sellerReference": "PO-12345",
  "notes": "Thank you for your business",
  "pdfUrl": "https://files.nookhive.com/invoices/inv_xyz789.pdf",
  "sentAt": "2026-01-15T10:05:00Z",
  "createdAt": "2026-01-15T10:00:00Z",
  "updatedAt": "2026-01-15T10:05:00Z"
}