---
title: "List billing groups in an organization"
method: GET
path: "/organization/{organization_id}/billing-groups"
tags: ["OrganizationBillingGroup"]
---

# List billing groups in an organization

`GET /organization/{organization_id}/billing-groups`

## Path parameters

- `organization_id` string, required

## Response `200`

Response

- OrganizationBillingGroupListResponse — OrganizationBillingGroupListResponse
  - `billing_groups` object[], required — A list of all billing groups belonging to the organization
    - `billing_address_id` string, required — Billing address ID
    - `billing_contact_emails` object[], required — List of billing contact emails
      - `email` string, required — Email
    - `billing_emails` object[], required — List of billing contact emails
      - `email` string, required — Email
    - `billing_group_id` string, required — Billing group ID
    - `billing_group_name` string, required — Billing Group Name
    - `create_time` string, required — The date when this billing group was created
    - `custom_invoice_text` string — Extra billing text
    - `organization_id` string, required — Organization ID
    - `payment_method` object — Payment method
      - `payment_method_id` string, required — Payment method ID
      - `payment_method_type` 'aws_subscription' | 'azure_subscription' | 'bank_transfer' | 'credit_card' | 'gcp_subscription' | 'custom', required — An enumeration.
    - `shipping_address_id` string, required — Shipping address ID
    - `vat_id` string — VAT ID

## Other responses

- `404` — Resource not found

## Changes

- **2026-09-21** `7f378868f351` — 2 info
  - removed the `aws_subscription_v1` enum value from the `billing_groups/items/payment_method/payment_method_type` response property for the response status `200`
  - removed the `gcp_subscription_v1` enum value from the `billing_groups/items/payment_method/payment_method_type` response property for the response status `200`
- **2026-09-09** `c3d7cd304ef2` — 2 warning
  - added the new `aws_subscription_v1` enum value to the `billing_groups/items/payment_method/payment_method_type` response property for the response status `200`
  - added the new `gcp_subscription_v1` enum value to the `billing_groups/items/payment_method/payment_method_type` response property for the response status `200`

[Change history](https://skmtc.dev/aiven/apis/aiven-api-documentation/changes/organization/:organization_id/billing-groups/get.md)

---

[API](https://skmtc.dev/aiven/apis/aiven-api-documentation.md) · [All operations](https://skmtc.dev/aiven/apis/aiven-api-documentation/llms.txt) · [OpenAPI document](https://skmtc.dev/aiven/apis/aiven-api-documentation/revisions/90f50802482d?raw)