---
title: "Get Infrastructure"
method: GET
path: "/v1/organizations/infrastructure/summary"
tags: ["Organization Infrastructure"]
---

# Get Infrastructure

`GET /v1/organizations/infrastructure/summary`

## Request

- Base URL: `https://api.mixpeek.com`
- URL: `https://api.mixpeek.com/v1/organizations/infrastructure/summary`
- Auth: HTTP bearer

Get infrastructure summary for an enterprise single-tenant deployment.

Returns compute profiles for each extractor, cloud cost breakdown
with transparent margin, and the billing period summary for the
requested (default: current) month. Enterprise-only endpoint.

## Query parameters

- `billing_month` string, nullable: Billing month to inspect (YYYY-MM). Defaults to the current month. Past months return the same category + line-item granularity as the current month.

## Response `200`

Successful Response

- InfrastructureSummaryResponse
  - `tenant_id` string, required
  - `namespace` string, nullable
  - `region` string
  - `billing_mode` string
  - `extractors` ExtractorComputeSummary[]
    - `extractor_name` string, required
    - `version` string, required
    - `gke_profile` string, required
    - `workload_type` string, required
    - `head` ResourceAllocation, required
      - `cpu_request` string, required
      - `cpu_limit` string, required
      - `memory_request` string, required
      - `memory_limit` string, required
      - `gpu` integer
    - `cpu_workers` ResourceAllocation, required
      - `cpu_request` string, required
      - `cpu_limit` string, required
      - `memory_request` string, required
      - `memory_limit` string, required
      - `gpu` integer
    - `cpu_worker_scaling` ScalingConfig, required
      - `min_replicas` integer, required
      - `max_replicas` integer, required
    - `gpu_workers` ResourceAllocation, required
      - `cpu_request` string, required
      - `cpu_limit` string, required
      - `memory_request` string, required
      - `memory_limit` string, required
      - `gpu` integer
    - `gpu_worker_scaling` ScalingConfig, required
      - `min_replicas` integer, required
      - `max_replicas` integer, required
    - `cost_per_hour_usd` number, required
  - `data_plane_components` DataPlaneComponentSummary[]
    - `component` string, required
    - `component_label` string, required
    - `replicas` integer, required
    - `scaling` ScalingConfig
      - `min_replicas` integer, required
      - `max_replicas` integer, required
    - `resources` ResourceAllocation, required
      - `cpu_request` string, required
      - `cpu_limit` string, required
      - `memory_request` string, required
      - `memory_limit` string, required
      - `gpu` integer
  - `cost_breakdown` CostBreakdownSummary, required
    - `billing_month` string, required
    - `cloud_provider` string, required
    - `data_as_of` string, nullable
    - `data_delay_note` string, nullable
    - `cost_unavailable` boolean
    - `attribution_scope` string
    - `total_cloud_cost_usd` number
    - `margin_pct` number
    - `total_margin_usd` number
    - `platform_fee_usd` number
    - `platform_fee_billed_externally` boolean
    - `total_invoice_usd` number
    - `categories` CloudCostCategorySummary[]
      - `category` string, required
      - `category_label` string, required
      - `cloud_cost_usd` number, required
      - `margin_usd` number, required
      - `total_usd` number, required
      - `line_items` CloudCostLineItem[], required
        - `service` string, required
        - `description` string, required
        - `category` string, required
        - `cloud_cost_usd` number, required
        - `margin_usd` number, required
        - `total_usd` number, required
        - `usage_amount` number, nullable
        - `usage_unit` string, nullable
        - `region` string, nullable
    - `all_line_items` CloudCostLineItem[]
      - `service` string, required
      - `description` string, required
      - `category` string, required
      - `cloud_cost_usd` number, required
      - `margin_usd` number, required
      - `total_usd` number, required
      - `usage_amount` number, nullable
      - `usage_unit` string, nullable
      - `region` string, nullable
  - `compute_costs` ComputeCostSummary
    - `cpu_hours` number
    - `gpu_hours` number
    - `base_cost_usd` number
    - `daily_breakdown` object[]
  - `billing_period` BillingPeriodSummary
    - `billing_month` string, required
    - `platform_fee_usd` number
    - `compute_base_cost_usd` number
    - `usage_cost_usd` number
    - `total_base_cost_usd` number
    - `note` string

## Other responses

- `400`: Bad Request
- `401`: Unauthorized
- `403`: Forbidden
- `404`: Not Found
- `422`: Unprocessable Entity
- `429`: Too Many Requests
- `500`: Internal Server Error
- `503`: Service Unavailable

## Changes

- **2026-10-09** `61a175e8eb9a`: 1 warning, 5 info
  - removed the optional property `detail` from the response with the `422` status
  - added the non-success response with the status `429`
  - added the non-success response with the status `503`
  - added the optional property `success` to the response with the `422` status
  - …2 more
- **2026-08-09** `5d4c905106b4`: 1 info
  - the endpoint scheme security `BearerAuth` was added to the API
- **2026-08-06** `aefce63dddc6`: 2 info
  - added the new optional `query` request parameter `billing_month`
  - added the optional property `cost_breakdown/platform_fee_billed_externally` to the response with the `200` status

[Operation history](https://skmtc.dev/mixpeek/apis/mixpeek-api/changes/v1/organizations/infrastructure/summary/get.md)

---

[API](https://skmtc.dev/mixpeek/apis/mixpeek-api.md) - [All operations](https://skmtc.dev/mixpeek/apis/mixpeek-api/llms.txt) - [OpenAPI document](https://skmtc.dev/mixpeek/apis/mixpeek-api/revisions/790bc16455f6?raw)