---
title: "List Active Contract Billing"
method: GET
path: "/api/v1/admin/block/active-contracts"
tags: ["Admin APIs", "block-data-approvals"]
---

# List Active Contract Billing

`GET /api/v1/admin/block/active-contracts`

Active Block contracts with per-contract Stripe billing for the Active
Contracts tab. One row per active contract (keyed by ``block_request_id``
so the UI joins it onto the request row it already renders). Subscription
status + next-invoice date are fetched live from Stripe on view, best-effort
— a Stripe miss falls back to the stored denormalized fields.

## Response `200`

Successful Response

- BlockActiveContractBillingListResponse
  - `items` BlockActiveContractBilling[], required
    - `block_request_id` string, uuid, required
    - `block_contract_id` string, uuid, required
    - `client_id` string, uuid, required
    - `client_name` string, nullable
    - `stripe_customer_id` string, nullable
    - `dataset_id` string, required
    - `dataset_label` string, nullable
    - `cut` string, nullable
    - `fee_type` string, required
    - `s3_auto_apply_enabled` boolean
    - `stripe_subscription_id` string, nullable
    - `stripe_product_id` string, nullable
    - `stripe_product_name` string, nullable
    - `monthly_amount` string, nullable
    - `annual_amount` string, nullable
    - `contract_started_at` string, date-time, nullable
    - `contract_ended_at` string, date-time, nullable
    - `next_invoice_date` string, date-time, nullable
    - `last_invoice_id` string, nullable
    - `last_invoice_status` string, nullable
    - `last_invoice_due_date` string, date-time, nullable
    - `lifecycle_badge` string, nullable
    - `access_ends_at` string, date-time, nullable
    - `in_grace` boolean
    - `grace_days_remaining` integer, nullable
    - `original_term_end` string, date-time, nullable
  - `total` integer, required

---

[API](https://skmtc.net/carbonarc/apis/carbon-arc-client-admin-api.md) · [All operations](https://skmtc.net/carbonarc/apis/carbon-arc-client-admin-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/carbonarc/carbon-arc-client-admin-api/revisions/a8ca30023371/schema)