Make your first API request

Create an API key and request a Texas queue record from Berkeley Lab's published compilation. Then open the source row.

Before you begin

You need a Gridstate account that can create an API key. The request uses a fixed API version.

Create and export a key

Create a key in the Gridstate console. Copy it when it appears because the console shows it once.

export GRIDSTATE_API_KEY="your_gridstate_api_key_here"
export GRIDSTATE_API_BASE="https://api.gridstatelabs.com"

Request queue records

Ask for an 800 MW project in Fisher County, Texas:

curl -G "$GRIDSTATE_API_BASE/v1/queue-records" \
  -d state=TX \
  -d county=Fisher \
  -d min_capacity_mw=800 \
  -d max_capacity_mw=800 \
  -d source_id=src_lbnl_queued_up_2026 \
  -d limit=1 \
  -H "Authorization: Bearer $GRIDSTATE_API_KEY" \
  -H "Gridstate-Version: 2026-08-24"

Find the source

Each record includes the exact source location and a URL for more source details:

{
  "data": [
    {
      "id": "queue_95f0cb3b99dac39c5cf2723b",
      "sourceId": "src_lbnl_queued_up_2026",
      "market": "ercot",
      "projectName": "Indigo Solar 3",
      "requestedCapacityMw": 800,
      "sourceLocator": "lbnl-queued-up-through-2025.xlsx#03. Complete Queue Data!row:35409",
      "evidenceUrl": "/v1/queue-records/queue_95f0cb3b99dac39c5cf2723b/evidence",
      "qualityFlags": []
    }
  ],
  "meta": {
    "hasMore": false,
    "limit": 1,
    "order": "id_asc"
  }
}

Read qualityFlags before you use a value. Gridstate lists problems in the source instead of hiding or replacing them.

Next steps

Connect an AI agent

Let an AI agent search Gridstate.

Open the source

Find the file and exact row behind a value.

Get more results

Move through a long list of records.