---
title: "Retrieve the billing profile"
method: GET
path: "/api/space/billing_profile"
tags: ["Space Billing"]
---

# Retrieve the billing profile

`GET /api/space/billing_profile`

Returns the billing address and contacts for the space. A profile that has never been
configured is returned with `null` fields rather than a `404`.

The billing endpoints are available when billing is managed in the space itself, which
is the case for every ordinary space: if the Billing section appears in your Dashboard,
you can use them. A space purchased through a cloud marketplace, or a suspended or
deactivated space, receives `401`. A space deactivated for nonpayment keeps them so that
its outstanding balance can be settled.

#### Permissions

Authenticate with a [Personal access token](/docs/apis/authorization#personal-access-tokens) whose holder is an owner or admin of the space. A project API token is not accepted on this endpoint, and a Personal access token has no scopes: the holder's role in the space is the whole authorization decision.

## Response `200`

The request has succeeded.

- SpaceBillingProfile — The billing address and contacts for the space. A profile that has never been configured is returned with `null` fields rather than a `404`.
  - `type` 'billing_profile', required — The object type. Always `billing_profile`.
  - `address_line1` string, nullable, required — The first line of the billing address.
  - `address_line2` string, nullable, required — The second line of the billing address.
  - `address_city` string, nullable, required — The city of the billing address.
  - `address_state` string, nullable, required — The state, province, or region of the billing address.
  - `address_zip` string, nullable, required — The postal code of the billing address.
  - `address_country` string, nullable, required — The ISO 3166-1 alpha-2 country code of the billing address.
  - `company_name` string, nullable, required — The company name that appears on statements.
  - `contact_name` string, nullable, required — The name of the billing contact.
  - `contact_email` string[], nullable, required — The email addresses billing correspondence is sent to.
  - `contact_phone` string, nullable, required — The phone number of the billing contact.
  - `tax_id_number` string, nullable, required — The tax identification number that appears on statements.
  - `monthly_invoices` boolean, required — Whether a monthly invoice is issued for the space.
  - `tax_id_number_required` boolean, required — Whether `tax_id_number` is required when updating the profile. `true` on Enterprise spaces.
  - `monthly_invoices_locked` boolean, required — Whether `monthly_invoices` is locked on. `true` on postpay spaces, where monthly invoices cannot be turned off.

## Other responses

- `401` — The credential is missing, unknown, or revoked; its holder is not a member of the space in the subdomain; the member is not an owner or admin; or billing for this space is not managed in the space itself, which is the case for a space purchased through a cloud marketplace and for a suspended or deactivated space. A space deactivated for nonpayment keeps the billing endpoints so that its outstanding balance can be settled. The body is the plain text `Unauthorized`. An unverified space instead receives the JSON body `{"message": "Please validate a phone number to access your account."}` on every endpoint under `/api/space`.
- `500` — An internal server error occurred.

## Changes

> 161 revisions in range; 3 could not be searched.

- **2026-09-15** `45bac4fd93ab` — 1 info
  - endpoint added

[Change history](https://skmtc.dev/signalwire/apis/signalwire-rest-api/changes/api/space/billing_profile/get.md)

---

[API](https://skmtc.dev/signalwire/apis/signalwire-rest-api.md) · [All operations](https://skmtc.dev/signalwire/apis/signalwire-rest-api/llms.txt) · [OpenAPI document](https://skmtc.dev/signalwire/apis/signalwire-rest-api/revisions/20ee0f568ece?raw)