Provider Invoice PDF

Stream the provider-issued invoice PDF (SmartBill).

Method

GET /v1/billing/invoices/provider

Query Parameters

series · string · required

Invoice series (e.g. INV).

number · string · required

Invoice number inside the series.

workspaceId · uuid

Workspace ID (optional if derived from API key).

bookingId · uuid

Booking ID used to infer the provider when multiple are configured.

provider · string

Provider hint (defaults to smartbill).

Headers

Authorization · string

Bearer token with billing:read scope.

Request Example

cURL

curl "https://api.voyantcloud.com/v1/billing/invoices/provider?series=INV&number=2025-00012&workspaceId=ws_abc" \
  -H "Authorization: Bearer $VOYANT_API_KEY" \
  -o invoice.pdf

Response

• 200 OK – Binary PDF stream with content-type: application/pdf and content-disposition: inline; filename=....
• 400 Bad Request – Missing required parameters (series, number, or workspace context).
• 404 Not Found – Workspace or provider configuration not found.
• 500 Internal Server Error – KMS not configured or provider failure.

This endpoint decrypts provider credentials using Google Cloud KMS. Ensure the environment is configured with GCP_KMS_INTEGRATIONS_KEY_NAME + access token, a service account key, or the fallback integrations KMS before calling it.