Skip to main content
GET
/
workspaces
/
{workspaceId}
/
billing-accounts
/
{billingAccountId}
Retrieve a billing account
curl --request GET \
  --url https://api.altostrat.io/workspaces/{workspaceId}/billing-accounts/{billingAccountId} \
  --header 'Authorization: Bearer <token>'
{
  "id": "cus_a1b2c3d4e5f6g7h8",
  "workspace_id": "ws_a1b2c3d4e5f6g7h8",
  "name": "ACME Corp Billing",
  "email": "billing@acme.com",
  "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"

โ€‹
billingAccountId
string
required

The ID of the billing account, which corresponds to a Stripe Customer ID (cus_...).

Example:

"cus_a1b2c3d4e5f6g7h8"

Response

The requested billing account object.

โ€‹
id
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"

โ€‹
email
string<email>

The primary billing email address.

Example:

"billing@acme.com"

โ€‹
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
โ€‹
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"