GET
/
api
/
invoice
/
{booking_id}
curl --request GET \
  --url https://app.flashquotes.com/api/invoice/{booking_id} \
  --header 'x-api-key: <api-key>'
[
  {
    "id": "inv_123",
    "invoiceNumber": "INV-2024-001",
    "dueDate": "2024-02-15T00:00:00Z",
    "issuedDate": "2024-01-15T08:30:00Z",
    "paidDate": "2024-01-16T10:15:00Z",
    "description": "Coffee service for corporate event",
    "status": "PAID",
    "poNumber": "PO-2024-001",
    "notes": "Please process payment within terms",
    "taxable": true,
    "taxRate": {
      "id": "tax_123",
      "name": "Sales Tax",
      "rate": 0.0825
    },
    "lineItems": [
      {
        "id": "line_123",
        "name": "Coffee Service",
        "description": "4 hour coffee service with barista",
        "quantity": 1,
        "unitPrice": 75000,
        "taxable": true,
        "position": 1,
        "type": "SERVICE"
      },
      {
        "id": "line_124",
        "name": "Specialty Syrups",
        "description": "Additional flavored syrups",
        "quantity": 1,
        "unitPrice": 2500,
        "taxable": true,
        "position": 2,
        "type": "ADDON"
      }
    ]
  }
]

This endpoint returns all invoices associated with a specific booking. The invoices include detailed information such as line items, tax rates, and payment status.

Response

The response includes an array of invoice objects. Each invoice contains:

  • Basic invoice details (ID, number, dates)
  • Status information (draft, sent, paid, void)
  • Line items with pricing and tax details
  • Tax rate information if applicable
  • Payment and due date information
All monetary values are returned in cents. For example, $750.00 is returned as 75000.

Example Usage

Here’s an example of how to use this endpoint with curl:

curl -X GET 'https://app.flashquotes.com/api/invoice/book_123' \
-H 'x-api-key: your_api_key_here'

Common Use Cases

  • Retrieving invoice history for a booking
  • Checking payment status of invoices
  • Accessing detailed pricing information
  • Verifying tax calculations

Authorizations

x-api-key
string
header
required

Path Parameters

booking_id
string
required

ID of the booking to retrieve invoices for

Response

200
application/json
List of invoices for the booking
id
string
required

The unique identifier of the invoice

invoiceNumber
string
required

The human-readable invoice number

status
enum<string>
required

Current status of the invoice

Available options:
DRAFT,
SENT,
PAID,
VOID
dueDate
string

When the invoice payment is due

issuedDate
string

When the invoice was issued

paidDate
string

When the invoice was paid, if applicable

description
string

Description of the invoice

poNumber
string

Purchase order number if provided

notes
string

Additional notes on the invoice

taxable
boolean

Whether the invoice is taxable

taxRate
object
lineItems
object[]