---
title: "List Block Contracts"
method: GET
path: "/api/v1/block/contracts"
tags: ["User APIs", "block-data"]
---

# List Block Contracts

`GET /api/v1/block/contracts`

The caller's own active Block contracts for the Block Admin Dashboard's
Active Contracts section (E1). Client-scoped by ``user.client_id`` (never
input) and CLIENT-SAFE — no Stripe ids. Keyed by ``block_request_id`` so the
UI joins it onto the request row it already renders.

Block-Admin only: contract billing detail (amounts, invoice status) is
admin-facing, matching the rest of this dashboard and the UI's ``isBlockAdmin``
tab gate — a plain Block user must not read it via the API.

## Response `200`

Successful Response

- BlockClientContractListResponse
  - `items` BlockClientContract[], required
    - `block_request_id` string, uuid, required
    - `dataset_id` string, required
    - `dataset_label` string, nullable
    - `cut` string, nullable
    - `fee_type` string, required
    - `monthly_amount` string, nullable
    - `annual_amount` string, nullable
    - `contract_started_at` string, date-time, nullable
    - `contract_ended_at` string, date-time, nullable
    - `last_invoice_status` string, nullable
    - `last_invoice_due_date` string, date-time, nullable
    - `next_invoice_date` string, date-time, nullable
    - `applied_tokens` string
    - `contract_term_months` integer, nullable
    - `next_invoice_seq` integer, nullable
    - `invoice_line_item` string, nullable
    - `period_applied_tokens` BlockClientPeriodTokens[]
      - `period_seq` integer, required
      - `applied_tokens` string
    - `issued_invoices` BlockClientIssuedInvoice[]
      - `period_seq` integer, required
      - `invoice_url` string, required
  - `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)