---
title: "Get billing details"
method: GET
path: "/v1/billing-details"
tags: ["Payment"]
---

# Get billing details

`GET /v1/billing-details`

## Request

- Base URL: `https://console-api.akash.network`
- URL: `https://console-api.akash.network/v1/billing-details`
- Auth: one of:
  - HTTP bearer
  - API key in header `x-api-key`

Returns the legal name, billing address and tax ID printed on the invoices of the active account or organization

## Headers

- `x-organization-id` string
- `x-project-id` string, uuid

## Response `200`

The billing details, empty until they are first set

- object
  - `data` object, required
    - `legalName` string, nullable, required
    - `companyName` string, nullable, required
    - `address` object, nullable, required
      - `line1` string, nullable, required
      - `line2` string, nullable, required
      - `city` string, nullable, required
      - `state` string, nullable, required
      - `postalCode` string, nullable, required
      - `country` string, nullable, required
    - `taxId` object, nullable, required
      - `type` string, required
      - `value` string, required
      - `verificationStatus` 'pending' | 'verified' | 'unverified' | 'unavailable', nullable, required: Whether the tax authority confirmed the number, or null for a type Stripe does not verify

## Other responses

- `401`: Unauthorized
- `403`: The caller cannot read the billing of this organization
- `404`: Invoices are not enabled for the caller

## Changes

- **2026-10-26** `4879767ba90d`: 1 info
  - added the required property `data/companyName` to the response with the `200` status
- **2026-10-15** `bb97e5bacb6f`: 2 info
  - added the new optional `header` request parameter `x-organization-id`
  - added the new optional `header` request parameter `x-project-id`
- **2026-10-14** `29008d7afb50`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/akash-network/apis/akash-network-console-api/changes/v1/billing-details/get.md)

---

[API](https://skmtc.dev/akash-network/apis/akash-network-console-api.md) - [All operations](https://skmtc.dev/akash-network/apis/akash-network-console-api/llms.txt) - [OpenAPI document](https://skmtc.dev/akash-network/apis/akash-network-console-api/revisions/6e478b9907da?raw)