Customer License table API

The Management API exposes a read-only, customer-scoped License table for Vendor Console. Tenant identity comes only from the authenticated user or service-account context.

GET /api/v1/customers/organizations/{organizationId}/licenses/table?offset=0&limit=50
Permission: customers.read

offset defaults to 0. limit defaults to 50 and accepts 1..200. Ordering is fixed: createdAtUtc descending, then licenseId ascending. Every stored lifecycle and migration state remains visible.

Each BC-LIC row is enriched with the same-Tenant Product label, VCM tariff and commercial renewal state, DEV device counts, and USG availability. Expected missing or inconsistent owner data uses explicit resolution statuses. The current usage state is NotAvailable, with all measurement fields present and null; no value is inferred from devices, Analytics, or import receipts.

An authoritative owner outage, missing result, duplicate result, or foreign License ID fails the whole request with 503 and customer_license_table_dependency_unavailable; partial 200 pages are not returned. Invalid identity or paging returns customer_license_table_invalid_request, and an absent or wrong-Tenant customer returns customer_license_table_not_found.

The response never includes plaintext keys, hashes, provider references, or internal Product/License codes. The table is informational and cannot authorize Runtime or Edge rights.