Skip to main content
GET
Get all data center campuses

Overview

A campus is a site with one or more data center buildings or phases. This endpoint returns one record per campus, with its status, capacity, building count, tenants, location and grid connection rolled up from its buildings. The buildings themselves are on the Data Centers endpoint, where each carries its campus’s campus_id. This is a “download link” style endpoint that returns all records in a single response. There is no pagination - every campus record is returned at once.

Which Campuses Are Included

Campuses that have passed Cleanview’s review and have at least one building that isn’t canceled. Canceled buildings are left out of every figure: status, capacity, counts, years, size and tenants. A campus whose buildings are all canceled isn’t returned.

Status Values

A campus’s status is rolled up from its buildings, ignoring canceled ones. A campus with operating buildings and a phase under construction is Under Construction.

Capacity

Capacity is facility power: the total power the campus draws from the grid, not its IT load. total_capacity_mw sums the campus’s buildings, and operating_capacity_mw, under_construction_capacity_mw and planned_capacity_mw split that sum by building status, so the three add up to the total. Sums use the buildings that have a capacity. When buildings_with_capacity is less than building_count, some buildings have no known capacity and the totals are a lower bound. A capacity field is null when no building in it has a capacity, including when the campus has no buildings with that status. IT capacity is on each building in Data Centers (it_capacity_mw). To total IT capacity by campus, join the buildings on campus_id and leave out canceled ones.

Grid Connection and On-Site Gas

  • has_onsite_gas is true when an on-site, behind-the-meter gas plant serves the campus.
  • The utility and balancing authority fields are set only when known with high confidence; null means unknown. A campus’s buildings in Data Centers carry the same values.

Example Requests

Returns all campus records in a single response.

Response Schema

Response Fields

Metadata Section

Campus Fields

Null Values: Fields are null when the information isn’t available. The capacity fields are null when no building in them has a capacity, first_operating_year and last_operating_year when no building has an operating year, and latitude and longitude for the few campuses without coordinates. tenant_name and end_user_name are only populated where a tenant or end user has been publicly identified. The utility and balancing authority fields are null unless known with high confidence.

Data Updates

Campus figures are computed from the building records in Data Centers on every request, so the two endpoints always agree.

Authorizations

x-api-key
string
header
required

API key authentication using x-api-key header

Response

Successful response with all data center campuses

success
boolean
required

Always true for successful responses

Example:

true

metadata
object
required
customer
object
required

Customer information for the API key

data
object[]
required

Array of all data center campus records