---
title: "AI data centers"
method: GET
path: "/api/v2/epoch/data-centers"
tags: ["AI Compute"]
---

# AI data centers

`GET /api/v2/epoch/data-centers`

Epoch AI data-center registry (CC-BY 4.0) — the largest AI compute clusters with power (MW), H100-equivalent compute, capital cost ($B), owner, chip types, and named users. Rows sort by compute (H100e) descending. Includes a per-country rollup (`by_country`) and dataset totals (`totals`). Requires a plan with AI compute & models access (`can_use_epoch_ai`) — the Corporate & Supply Chain and Global Intelligence plans. Response echoes `applied_filters`.

## Query parameters

- `country` string
- `owner` string
- `limit` integer
- `cursor` string
- `offset` integer

## Response `200`

A page of data centers plus a country rollup and totals. Envelope: `{ success, data, by_country, totals, pagination, applied_filters }`.

- object
  - `success` boolean
  - `data` object[]
    - `name` string
    - `owner` string, nullable
    - `current_power_mw` number, nullable
    - `current_h100e` number, nullable
    - `current_capital_cost_busd` number, nullable
    - `country` string, nullable
    - `users` string, nullable
    - `current_chip_types` string, nullable
    - `entity_id` string
    - `entity_page_name` string
  - `by_country` object[]
    - `country` string
    - `data_centers` integer
    - `power_mw_total` number
    - `h100e_total` number
    - `capital_cost_busd_total` number
  - `totals` object
    - `n` integer
    - `power_mw` number
    - `h100e` number
    - `capital_cost_busd` number
  - `pagination` object
    - `limit` integer
    - `offset` integer
    - `next_cursor` string, nullable — Canonical page token — pass it back as `cursor` to fetch the next page (uniform across all list endpoints). `null` when there are no more rows.
    - `next_offset` integer, nullable — Legacy — prefer `next_cursor` (still returned). Numeric row offset of the next page.
  - `applied_filters` object
    - `country` string
    - `owner` string
    - `ignored` object

## Other responses

- `401` — Missing/invalid API key
- `403` — Plan required (PLAN_REQUIRED) — the caller's plan does not carry the required source entitlement.
- `500` — Server error

---

[API](https://skmtc.net/gdeltcloud/apis/gdelt-cloud-api-v2.md) · [All operations](https://skmtc.net/gdeltcloud/apis/gdelt-cloud-api-v2/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/gdeltcloud/gdelt-cloud-api-v2/revisions/01aaa6255180/schema)