---
title: "ListOrganizationBillingIssues lists all the billing issues for the organization"
method: GET
path: "/v1/orgs/{org}/billing/issues"
---

# ListOrganizationBillingIssues lists all the billing issues for the organization

`GET /v1/orgs/{org}/billing/issues`

## Path parameters

- `org` string, required

## Query parameters

- `superuserForceAccess` boolean

## Response `200`

A successful response.

- V1ListOrganizationBillingIssuesResponse
  - `issues` V1BillingIssue[]
    - `createdOn` string, date-time
    - `eventTime` string, date-time
    - `level` 'BILLING_ISSUE_LEVEL_UNSPECIFIED' | 'BILLING_ISSUE_LEVEL_WARNING' | 'BILLING_ISSUE_LEVEL_ERROR'
    - `metadata` V1BillingIssueMetadata
      - `message` V1BillingIssueMetadataMessage
        - `message` string
      - `neverSubscribed` V1BillingIssueMetadataNeverSubscribed
      - `noBillableAddress` V1BillingIssueMetadataNoBillableAddress
      - `noPaymentMethod` V1BillingIssueMetadataNoPaymentMethod
      - `onCreditTrial` V1BillingIssueMetadataOnCreditTrial
        - `creditAllocation` number, double
        - `lowCredit` boolean
        - `planId` string
        - `subscriptionId` string
      - `onTrial` V1BillingIssueMetadataOnTrial
        - `endDate` string, date-time
        - `gracePeriodEndDate` string, date-time
      - `paymentFailed` V1BillingIssueMetadataPaymentFailed
        - `invoices` V1BillingIssueMetadataPaymentFailedMeta[]
          - `amountDue` string
          - `currency` string
          - `dueDate` string, date-time
          - `failedOn` string, date-time
          - `gracePeriodEndDate` string, date-time
          - `invoiceId` string
          - `invoiceNumber` string
          - `invoiceUrl` string
      - `subscriptionCancelled` V1BillingIssueMetadataSubscriptionCancelled
        - `endDate` string, date-time
      - `trialCreditsDepleted` V1BillingIssueMetadataTrialCreditsDepleted
        - `depletedOn` string, date-time
        - `planId` string
        - `subscriptionId` string
      - `trialEnded` V1BillingIssueMetadataTrialEnded
        - `endDate` string, date-time
        - `gracePeriodEndDate` string, date-time
    - `org` string
    - `type` 'BILLING_ISSUE_TYPE_UNSPECIFIED' | 'BILLING_ISSUE_TYPE_ON_TRIAL' | 'BILLING_ISSUE_TYPE_TRIAL_ENDED' | 'BILLING_ISSUE_TYPE_NO_PAYMENT_METHOD' | 'BILLING_ISSUE_TYPE_NO_BILLABLE_ADDRESS' | 'BILLING_ISSUE_TYPE_PAYMENT_FAILED' | 'BILLING_ISSUE_TYPE_SUBSCRIPTION_CANCELLED' | 'BILLING_ISSUE_TYPE_NEVER_SUBSCRIBED' | 'BILLING_ISSUE_TYPE_ON_CREDIT_TRIAL' | 'BILLING_ISSUE_TYPE_TRIAL_CREDITS_DEPLETED' | 'BILLING_ISSUE_TYPE_MESSAGE'

## Other responses

- `default` — An unexpected error response.

## Changes

> 54 revisions in range; 1 could not be searched.

- **2026-06-08** (v1) `adc665ef8c17` — 1 warning, 1 info
  - added the new `BILLING_ISSUE_TYPE_MESSAGE` enum value to the `issues/items/type` response property for the response status `200`
  - added the optional property `issues/items/metadata/message` to the response with the `200` status
- **2026-05-06** (v1) `9f1bf1f2a520` — 2 warning, 2 info
  - added the new `BILLING_ISSUE_TYPE_ON_CREDIT_TRIAL` enum value to the `issues/items/type` response property for the response status `200`
  - added the new `BILLING_ISSUE_TYPE_TRIAL_CREDITS_DEPLETED` enum value to the `issues/items/type` response property for the response status `200`
  - added the optional property `issues/items/metadata/onCreditTrial` to the response with the `200` status
  - added the optional property `issues/items/metadata/trialCreditsDepleted` to the response with the `200` status
- **2025-12-11** (v1) `f317ff96998d` — 3 warning, 3 info
  - removed the optional property `issues/items/metadata/message` from the response with the `200` status
  - removed the optional property `issues/items/metadata/onCreditTrial` from the response with the `200` status
  - removed the optional property `issues/items/metadata/trialCreditsDepleted` from the response with the `200` status
  - removed the `BILLING_ISSUE_TYPE_MESSAGE` enum value from the `issues/items/type` response property for the response status `200`
  - …2 more

[Change history](https://skmtc.dev/rilldata/apis/rill-admin-api/changes/v1/orgs/:org/billing/issues/get.md)

---

[API](https://skmtc.dev/rilldata/apis/rill-admin-api.md) · [All operations](https://skmtc.dev/rilldata/apis/rill-admin-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/rilldata/rill-admin-api/revisions/abe7a430f373/schema)