Create a billing account

curl --request POST \
  --url https://api.altostrat.io/workspaces/{workspaceId}/billing-accounts \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "name": "ACME Corp (EU)",
  "email": "[email protected]",
  "phone": "+442071234567",
  "description": "For all European operations.",
  "currency": "eur",
  "address": {
    "country": "US",
    "line1": "123 Main Street",
    "line2": "Suite 456",
    "city": "San Francisco",
    "state": "CA",
    "postal_code": "94105"
  }
}
'

{
  "id": "cus_a1b2c3d4e5f6g7h8",
  "workspace_id": "ws_a1b2c3d4e5f6g7h8",
  "name": "ACME Corp Billing",
  "email": "[email protected]",
  "phone": "+15551234567",
  "description": "For US-based operations",
  "currency": "usd",
  "address": {
    "country": "US",
    "line1": "123 Main Street",
    "line2": "Suite 456",
    "city": "San Francisco",
    "state": "CA",
    "postal_code": "94105"
  },
  "created_at": "2025-10-29T00:40:06.000000Z",
  "updated_at": "2025-10-29T00:40:06.000000Z"
}

POST

workspaces

{workspaceId}

billing-accounts

Create a billing account

curl --request POST \
  --url https://api.altostrat.io/workspaces/{workspaceId}/billing-accounts \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "name": "ACME Corp (EU)",
  "email": "[email protected]",
  "phone": "+442071234567",
  "description": "For all European operations.",
  "currency": "eur",
  "address": {
    "country": "US",
    "line1": "123 Main Street",
    "line2": "Suite 456",
    "city": "San Francisco",
    "state": "CA",
    "postal_code": "94105"
  }
}
'

{
  "id": "cus_a1b2c3d4e5f6g7h8",
  "workspace_id": "ws_a1b2c3d4e5f6g7h8",
  "name": "ACME Corp Billing",
  "email": "[email protected]",
  "phone": "+15551234567",
  "description": "For US-based operations",
  "currency": "usd",
  "address": {
    "country": "US",
    "line1": "123 Main Street",
    "line2": "Suite 456",
    "city": "San Francisco",
    "state": "CA",
    "postal_code": "94105"
  },
  "created_at": "2025-10-29T00:40:06.000000Z",
  "updated_at": "2025-10-29T00:40:06.000000Z"
}

Authorizations

Authorization

string

header

required

Enter your JWT in the format: Bearer {token}

Path Parameters

workspaceId

string

required

The ID of the workspace.

Example:

"ws_a1b2c3d4e5f6g7h8"

Body

application/json

name

string

required

The name for the new billing account. Maximum 100 characters.

Example:

"ACME Corp (EU)"

string<email>

required

The primary billing email address. Maximum 150 characters.

Example:

"[email protected]"

phone

string | null

The billing contact phone number. Maximum 50 characters.

Example:

"+442071234567"

description

string | null

An optional description for the billing account. Maximum 200 characters.

Example:

"For all European operations."

currency

enum<string>

The three-letter ISO currency code. If not provided, it will default based on the workspace or system settings.

Available options:

usd,

zar,

eur,

gbp,

aud

Example:

"eur"

address

object

Show child attributes

address.country

string

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

Example:

"US"

address.line1

string | null

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

Example:

"123 Main Street"

address.line2

string | null

Address line 2 (e.g., apartment, suite, unit, or building).

Example:

"Suite 456"

address.city

string | null

City, district, suburb, town, or village.

Example:

"San Francisco"

address.state

string | null

State, county, province, or region.

Example:

"CA"

address.postal_code

string | null

ZIP or postal code.

Example:

"94105"

Response

The billing account was created successfully.

string

Unique identifier for the billing account (Stripe Customer ID), prefixed with cus_.

Example:

"cus_a1b2c3d4e5f6g7h8"

workspace_id

string

The ID of the workspace this billing account belongs to.

Example:

"ws_a1b2c3d4e5f6g7h8"

name

string

The name of the billing account.

Example:

"ACME Corp Billing"

string<email>

The primary billing email address.

Example:

"[email protected]"

phone

string | null

The billing contact phone number.

Example:

"+15551234567"

description

string | null

An optional description for the billing account.

Example:

"For US-based operations"

currency

enum<string>

The three-letter ISO currency code for the billing account.

Available options:

usd,

zar,

eur,

gbp,

aud

Example:

"usd"

address

object

Show child attributes

address.country

string

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

Example:

"US"

address.line1

string | null

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

Example:

"123 Main Street"

address.line2

string | null

Address line 2 (e.g., apartment, suite, unit, or building).

Example:

"Suite 456"

address.city

string | null

City, district, suburb, town, or village.

Example:

"San Francisco"

address.state

string | null

State, county, province, or region.

Example:

"CA"

address.postal_code

string | null

ZIP or postal code.

Example:

"94105"

created_at

string<date-time>

The timestamp when the billing account was created.

Example:

"2025-10-29T00:40:06.000000Z"

updated_at

string<date-time>

The timestamp when the billing account was last updated.

Example:

"2025-10-29T00:40:06.000000Z"

List billing accounts

Retrieve a billing account

⌘I

Getting Started

Platform & Identity

Device Management & Orchestration

Automation & AI

Network Services & Connectivity

Security & Threat Management

Monitoring & Analytics

Core Services & Utilities

Create a billing account

Authorizations

Path Parameters

Body

Response