Skip to main content

​
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 "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.