EnterpriseBilling

Schema Properties

invoiceId string

Required

The unique identifier for the invoice.

status 'draft' | 'open' | 'paid' | 'void' | 'uncollectible'

Required

The current status of the invoice.

totalAmount number

Required

Total invoice amount in cents.

currency string

Required

Three-letter ISO currency code.

customer object

Required

Details about the customer being billed.

View Properties

customerId string

Required

Stripe customer ID.

billingAddress object

Required

The primary billing address for tax purposes.

View Properties

line1 string

Required

Address line 1 (e.g., street, PO Box).

line2 string

Optional

Address line 2 (e.g., apartment, suite).

city string

Required

City, district, suburb, town, or village.

country string

Required

Two-letter country code (ISO 3166-1 alpha-2).

lineItems object[]

Required

The individual items or subscriptions included in this invoice.

Array Item Properties

itemId string

Required

Unique identifier for the line item.

description string

Required

A brief description of the product or service.

quantity number

Required

The quantity purchased.

unitAmount number

Required

Cost per unit in cents.

metadata Record<string, string>

Optional

Arbitrary key-value metadata attached to the invoice.

SDK Code Samples

Copy these snippets to integrate the EnterpriseBilling API into your application.

cURL

curl -X POST "https://api.cloudstart.dev/v1/enterprisebillings" \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -d '{"invoiceId":"...","status":"...","totalAmount":"...","currency":"...","customer":"...","lineItems":"...","metadata":"..."}'

Node.js

const options = {
  method: 'POST',
  headers: {
    'Content-Type': 'application/json',
    'Authorization': 'Bearer YOUR_API_KEY'
  },
  body: JSON.stringify({
    "invoiceId": "...",
    "status": "...",
    "totalAmount": "...",
    "currency": "...",
    "customer": "...",
    "lineItems": "...",
    "metadata": "..."
  })
};

fetch('https://api.cloudstart.dev/v1/enterprisebillings', options)
  .then(response => response.json())
  .then(response => console.log(response))
  .catch(err => console.error(err));

Python

import requests

url = "https://api.cloudstart.dev/v1/enterprisebillings"

headers = {
    "Content-Type": "application/json",
    "Authorization": "Bearer YOUR_API_KEY"
}

payload = {
  "invoiceId": "...",
  "status": "...",
  "totalAmount": "...",
  "currency": "...",
  "customer": "...",
  "lineItems": "...",
  "metadata": "..."
}

response = requests.request("POST", url, json=payload, headers=headers)

print(response.text)

Interactive Testing

Use the playground below to simulate creating a new EnterpriseBilling object. This executes a live fetch request directly from your browser.

POSThttps://api.cloudstart.dev/v1/enterprisebillings

Send

Bearer Token

Body (JSON)

{ "invoiceId": "...", "status": "...", "totalAmount": "...", "currency": "...", "customer": "...", "lineItems": "...", "metadata": "..." }