> ## Documentation Index
> Fetch the complete documentation index at: https://docs.cleanview.co/llms.txt
> Use this file to discover all available pages before exploring further.

# ISO-NE Interconnection Queue

> Access real-time ISO New England interconnection queue data for all power projects

## Overview

The ISO-NE interconnection queue endpoint provides access to real-time data from ISO New England's interconnection queue, which serves all six New England states.

## Endpoint

<CodeGroup>
  ```bash cURL theme={null}
  curl -H "x-api-key: your_api_key_here" \
    "https://api.cleanview.co/api/v1/interconnection/iso-ne?limit=50"
  ```

  ```javascript JavaScript theme={null}
  const response = await fetch('https://api.cleanview.co/api/v1/interconnection/iso-ne?limit=50', {
    headers: {
      'x-api-key': 'your_api_key_here'
    }
  });
  const data = await response.json();
  ```

  ```python Python theme={null}
  import requests

  headers = {'x-api-key': 'your_api_key_here'}
  response = requests.get(
      'https://api.cleanview.co/api/v1/interconnection/iso-ne?limit=50',
      headers=headers
  )
  data = response.json()
  ```
</CodeGroup>

## Coverage Area

**States Served**: Connecticut, Maine, Massachusetts, New Hampshire, Rhode Island, and Vermont. Note: Small number of projects in New Brunswick, Canada and New York also included.

## Query Parameters

| Parameter      | Type    | Default | Description                                                        |
| -------------- | ------- | ------- | ------------------------------------------------------------------ |
| `limit`        | integer | 1000    | Number of records to return (50-5000)                              |
| `offset`       | integer | 0       | Number of records to skip                                          |
| `state`        | string  | -       | Filter by state code (MA, CT, ME, etc.) - supports comma-separated |
| `technology`   | string  | -       | Filter by standardized technology type - supports comma-separated  |
| `status`       | string  | -       | Filter by standardized status                                      |
| `min_capacity` | number  | -       | Minimum capacity in MW                                             |
| `max_capacity` | number  | -       | Maximum capacity in MW                                             |
| `developer`    | string  | -       | Filter by developer name (supports partial matches)                |

### Technology Options

<Tip>
  Use standardized technology names for consistent filtering. See our [Interconnection Reference](/api-reference/interconnection-codes#technology-classifications) for all available options.
</Tip>

| Technology                 | Description                                           |
| -------------------------- | ----------------------------------------------------- |
| `Solar`                    | Solar photovoltaic projects                           |
| `Wind`                     | Wind turbine projects (onshore)                       |
| `Battery`                  | Battery energy storage systems                        |
| `Hybrid - Solar + Storage` | Combined solar and battery projects                   |
| `Hybrid - Wind + Storage`  | Combined wind and battery projects                    |
| `Natural Gas`              | Natural gas generation (combined cycle, gas turbines) |
| `Nuclear`                  | Nuclear power plants                                  |
| `Hydro`                    | Hydroelectric generation                              |
| `Other`                    | Other technologies                                    |

### Status Options

| Status      | Count | Description                                        |
| ----------- | ----- | -------------------------------------------------- |
| `Planned`   | 93    | Active projects currently in interconnection queue |
| `Operating` | 351   | Projects that achieved commercial operation        |
| `Cancelled` | 1,308 | Projects withdrawn from queue                      |

### Top States by Project Count

| State         | Project Count | Top Technologies      |
| ------------- | ------------- | --------------------- |
| Massachusetts | \~600         | Solar, Hybrid Storage |
| Connecticut   | \~400         | Solar, Natural Gas    |
| Maine         | \~300         | Solar, Wind           |
| New Hampshire | \~200         | Solar                 |
| Rhode Island  | \~150         | Solar                 |
| Vermont       | \~100         | Solar, Wind, Hydro    |

## Example Requests

<AccordionGroup>
  <Accordion title="Get Active Solar Projects in Maine">
    ```bash theme={null}
    curl -H "x-api-key: your_api_key_here" \
      "https://api.cleanview.co/api/v1/interconnection/iso-ne?technology=Solar&status=Planned&state=ME&limit=50"
    ```

    Returns active solar projects in ISO-NE's queue. Uses `technology=Solar` for standardized filtering.
  </Accordion>

  <Accordion title="Get Hybrid Solar + Storage Projects">
    ```bash theme={null}
    curl -H "x-api-key: your_api_key_here" \
      "https://api.cleanview.co/api/v1/interconnection/iso-ne?technology=Hybrid - Solar + Storage&limit=50"
    ```

    Finds projects combining solar PV with battery storage, common in ISO-NE's interconnection queue.
  </Accordion>

  <Accordion title="Get Projects with CNR Service Type">
    ```bash theme={null}
    curl -H "x-api-key: your_api_key_here" \
      "https://api.cleanview.co/api/v1/interconnection/iso-ne?status=Planned&limit=200"
    ```

    Filter for Capacity Network Resource (CNR) projects in the response. CNR is the most common service type for battery storage in New England.
  </Accordion>

  <Accordion title="Get Brookfield Projects">
    ```bash theme={null}
    curl -H "x-api-key: your_api_key_here" \
      "https://api.cleanview.co/api/v1/interconnection/iso-ne?developer=Brookfield&limit=50"
    ```

    Filters for projects developed by Brookfield. Uses partial matching to find all Brookfield projects across New England.
  </Accordion>

  <Accordion title="Get Projects by Multiple Technologies">
    ```bash theme={null}
    curl -H "x-api-key: your_api_key_here" \
      "https://api.cleanview.co/api/v1/interconnection/iso-ne?technology=Solar,Wind,Battery&limit=50"
    ```

    Uses comma-separated values for multiple technology filtering.
  </Accordion>
</AccordionGroup>

## Response Schema

<ResponseExample>
  ```json Example Response theme={null}
  {
    "success": true,
    "iso": "NEISO",
    "summary": {
      "limit": 50,
      "offset": 0,
      "total_results": 1752,
      "has_more": true,
      "current_page": 1,
      "total_pages": 36
    },
    "filters": {
      "state": null,
      "technology": null,
      "status": null,
      "min_capacity": null,
      "max_capacity": null,
      "developer": null
    },
    "data": [
      {
        "iso": "ISNE",
        "queue_id": "1021_emery_meadow_solar_req20200427_ME_york_poicmp_345_kv_section_182",
        "project_name": "Emery Meadow Solar",
        "capacity_mw": 16.425,
        "technology": "G",
        "fuel": "SUN",
        "status": "Planned",
        "detailed_status": null,
        "operating_date": "2026-09-30T07:00:00.000Z",
        "request_date": "2020-04-27T07:00:00.000Z",
        "county": "York",
        "state": "ME",
        "queue_position": "1021",
        "neiso_developer": "PD",
        "developer": "Glenvale Solar",
        "data_source": "active",
        "balancing_authority_code": "ISNE",
        "technology_normalized": "Solar",
        "project_id": "1021_emery_meadow_solar_req20200427_ME_york_poicmp_345_kv_section_182",
        "cluster": null,
        "last_updated": "2024-07-11T20:30:33.089Z",
        "project_type": "G",
        "requested_date": "2020-04-27T07:00:00.000Z",
        "unit_id": "PV",
        "fuel_type": "SUN",
        "summer_capacity_mw": 16.425,
        "winter_capacity_mw": 16.425,
        "operation_date": "2026-09-30T07:00:00.000Z",
        "synchronization_date": "2026-08-01T07:00:00.000Z",
        "withdrawal_date": null,
        "interconnection_location": "CMP 34.5 kV, Section 182",
        "service_type": "CNR",
        "sis_complete": true,
        "i39": true,
        "to_report": "ISO-NE",
        "zone": "ME",
        "fs": null,
        "sis": "Document Posted",
        "os": null,
        "fac": null,
        "ia": "Executed"
      },
      {
        "iso": "ISNE",
        "queue_id": "1138_husky_solar_req20210603_CT_windham_poithe_poi_will_be_located_about_69_miles_from_the_16071505_line_row_exeter_tap_and_about_11_miles_from_the_exeter_sub_54n_along_the_115_kv_underground_line_to_the_exeter_sub_54n",
        "project_name": "Husky Solar",
        "capacity_mw": 50.159,
        "technology": "G",
        "fuel": "SUN",
        "status": "Planned",
        "detailed_status": null,
        "operating_date": "2029-05-10T07:00:00.000Z",
        "request_date": "2021-06-03T07:00:00.000Z",
        "county": "Windham",
        "state": "CT",
        "queue_position": "1138",
        "neiso_developer": "PD",
        "developer": "Brookfield",
        "data_source": "active",
        "balancing_authority_code": "ISNE",
        "technology_normalized": "Solar",
        "project_id": "1138_husky_solar_req20210603_CT_windham_poithe_poi_will_be_located_about_69_miles_from_the_16071505_line_row_exeter_tap_and_about_11_miles_from_the_exeter_sub_54n_along_the_115_kv_underground_line_to_the_exeter_sub_54n",
        "cluster": null,
        "last_updated": "2025-10-17T20:47:49.473Z",
        "project_type": "G",
        "requested_date": "2021-06-03T07:00:00.000Z",
        "unit_id": "PV",
        "fuel_type": "SUN",
        "summer_capacity_mw": 50.159,
        "winter_capacity_mw": 50.159,
        "operation_date": "2029-05-10T07:00:00.000Z",
        "synchronization_date": "2029-05-01T07:00:00.000Z",
        "withdrawal_date": null,
        "interconnection_location": "The POI will be located about 6.9 miles from the 1607/1505 line ROW (Exeter Tap) and about 1.1 miles from the Exeter Sub 54N along the 115 kV underground line to the Exeter Sub 54N.",
        "service_type": "NR",
        "sis_complete": true,
        "i39": true,
        "to_report": "ISO-NE",
        "zone": "CT",
        "fs": "Document Posted",
        "sis": "Document Posted",
        "os": "Not Required",
        "fac": "Not Required",
        "ia": "Executed"
      }
    ]
  }
  ```
</ResponseExample>

<Note>
  **Complete Upstream Data**: Each project includes all 41 database columns from ISO-NE's interconnection queue at the top level. This provides complete transparency with both standardized fields (normalized across all ISOs) and ISO-NE-specific raw fields like `fs`, `sis`, `os`, `fac`, `ia` (five-phase study process), `i39` (small generator designation), and `service_type` (CNR, NR, etc.).
</Note>

## Response Fields

### Core Identification Fields

| Field                      | Type   | Description                                                                  |
| -------------------------- | ------ | ---------------------------------------------------------------------------- |
| `iso`                      | string | Always "ISNE" for ISO New England data                                       |
| `queue_id`                 | string | Unique project identifier combining queue position, technology, location     |
| `project_id`               | string | Alias for queue\_id (standardized across all ISOs)                           |
| `project_name`             | string | Official project name in ISO-NE queue                                        |
| `queue_position`           | string | Numeric queue position assigned when interconnection request deemed complete |
| `balancing_authority_code` | string | Always "ISNE"                                                                |
| `last_updated`             | date   | Timestamp of last data update in Cleanview database                          |

### Capacity & Technology

| Field                   | Type   | Description                                                                                            |
| ----------------------- | ------ | ------------------------------------------------------------------------------------------------------ |
| `capacity_mw`           | number | Primary nameplate capacity rating in MW                                                                |
| `summer_capacity_mw`    | number | Summer-rated capacity (typically lower due to heat derating)                                           |
| `winter_capacity_mw`    | number | Winter-rated capacity (typically higher in New England climate)                                        |
| `technology`            | string | Raw project type code (G=Generation, TS=Transmission Service, ETU=Elective Transmission Upgrade)       |
| `technology_normalized` | string | Standardized technology category for cross-ISO filtering                                               |
| `fuel`                  | string | Raw fuel type code (SUN, WND, BAT, etc., space-separated for hybrids)                                  |
| `fuel_type`             | string | Detailed fuel type with hybrid combinations                                                            |
| `unit_id`               | string | Unit type identifier (PV, WT, OT, CC, GT, ST, HD, HW, IC, FC, PS)                                      |
| `project_type`          | string | Project classification: G (Generation), TS (Transmission Service), ETU (Elective Transmission Upgrade) |

### Project Status & Dates

| Field                  | Type   | Description                                                                |
| ---------------------- | ------ | -------------------------------------------------------------------------- |
| `status`               | string | Standardized status (Planned, Operating, Cancelled, Inactive)              |
| `detailed_status`      | string | Original ISO-NE detailed status (typically null, enriched in data\_source) |
| `request_date`         | date   | Date interconnection request submitted to ISO-NE                           |
| `requested_date`       | date   | Alias for request\_date                                                    |
| `operating_date`       | date   | Projected commercial operation date                                        |
| `operation_date`       | date   | Alias for operating\_date                                                  |
| `synchronization_date` | date   | Date project synchronized to the grid                                      |
| `withdrawal_date`      | date   | Date project withdrew from queue (null if not withdrawn)                   |

### Location

| Field                      | Type   | Description                                                                                |
| -------------------------- | ------ | ------------------------------------------------------------------------------------------ |
| `state`                    | string | Two-letter state code (MA, CT, ME, NH, RI, VT, plus NB \[Canada], NY)                      |
| `county`                   | string | County within state where project is located                                               |
| `zone`                     | string | ISO-NE load zone (13 zones: BOST, CT, ME, NH, RI, VT, SEMA, WMA, NOR, CMA, SME, SWCT, BHE) |
| `interconnection_location` | string | Detailed point of interconnection description                                              |

### Study Process (Five-Phase Sequence)

| Field | Type   | Description                                                                               |
| ----- | ------ | ----------------------------------------------------------------------------------------- |
| `fs`  | string | Feasibility Study status (Not Started, In Progress, Document Posted, Not Required)        |
| `sis` | string | System Impact Study status (adds ISA Not Executed option for projects without signed ISA) |
| `os`  | string | Optional Study status (Document Posted, Not Required - rarely needed)                     |
| `fac` | string | Facilities Study status (engineering design and cost estimates)                           |
| `ia`  | string | Interconnection Agreement status (adds IA Filed Unexecuted, Executed options)             |

### Grid Connection & Service

| Field          | Type    | Description                                                                         |
| -------------- | ------- | ----------------------------------------------------------------------------------- |
| `service_type` | string  | Type of interconnection service (CNR, NR, CNI, NI, ES, MIS, NS)                     |
| `sis_complete` | boolean | Indicates whether System Impact Study has been completed                            |
| `i39`          | boolean | Indicates if project follows I.3.9 small generator (≤20 MW) interconnection process |

### Developer Information

| Field             | Type   | Description                                                        |
| ----------------- | ------ | ------------------------------------------------------------------ |
| `neiso_developer` | string | Developer name from original ISO-NE queue data                     |
| `developer`       | string | Cleanview-enriched developer name with corporate hierarchy mapping |

### ISO-NE Specific Fields

| Field         | Type   | Description                                                                             |
| ------------- | ------ | --------------------------------------------------------------------------------------- |
| `data_source` | string | Source dataset lifecycle (active, withdrawn, commercial)                                |
| `to_report`   | string | Reporting entity/transmission owner (ISO-NE, BHE, CMP, MPS, NGRID, NSTAR, NU, TEUS, UI) |
| `cluster`     | string | Cluster study group assignment (typically null)                                         |

## ISO-NE Queue Terminology

Understanding ISO New England's specific interconnection processes and terminology is essential for working with their queue data.

### I.3.9 Interconnection Process

Section I.3.9 of ISO-NE's Open Access Transmission Tariff (OATT) governs the interconnection process for small generators (≤20 MW capacity). This expedited process is designed for smaller distributed generation projects. Projects are assigned numeric queue positions (e.g., "1000", "1021") when their interconnection application is deemed complete by ISO-NE.

### Study Process Phases

ISO-NE uses a comprehensive five-phase study sequence for interconnection projects. Each phase has specific deliverables and status values:

| Phase                         | Field | Possible Values                                                                        | Description                                                                    |
| ----------------------------- | ----- | -------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------ |
| **Feasibility Study**         | `fs`  | Not Started, In Progress, Document Posted, Not Required                                | Initial assessment of interconnection feasibility and system impacts           |
| **System Impact Study**       | `sis` | Not Started, In Progress, Document Posted, Not Required, ISA Not Executed              | Detailed reliability analysis requiring Interconnection System Agreement (ISA) |
| **Optional Study**            | `os`  | Document Posted, Not Required                                                          | Additional studies requested by customer (rarely required)                     |
| **Facilities Study**          | `fac` | Not Started, In Progress, Document Posted, Not Required                                | Engineering design and cost estimates for required interconnection facilities  |
| **Interconnection Agreement** | `ia`  | Not Started, In Progress, Document Posted, Not Required, IA Filed Unexecuted, Executed | Final agreement governing interconnection terms and conditions                 |

**Study Status Details:**

* **Not Started**: Study phase has not yet begun
* **In Progress**: Study currently being conducted by ISO-NE or transmission owner
* **Document Posted**: Study completed and results published
* **Not Required**: Study phase not needed for this project type
* **ISA Not Executed**: (SIS only) Study cannot proceed without signed Interconnection System Agreement
* **IA Filed Unexecuted**: (IA only) Agreement filed with FERC but not yet executed by all parties
* **Executed**: (IA only) Final agreement signed by all parties

### Service Types

ISO-NE offers seven types of interconnection service, determining how the project participates in New England's wholesale electricity markets:

| Code    | Full Name                      | Description                                                           | Common Use Cases                                                   |
| ------- | ------------------------------ | --------------------------------------------------------------------- | ------------------------------------------------------------------ |
| **CNR** | Capacity Network Resource      | Full network interconnection service with capacity supply rights      | Battery storage projects (30+ active CNR projects)                 |
| **NR**  | Network Resource               | Energy delivery service via transmission network                      | Solar projects (22+ active NR projects)                            |
| **CNI** | Capacity Network Import        | Network import service with capacity designation                      | Imports from neighboring regions with capacity rights              |
| **NI**  | Network Import                 | Import interconnection from external areas                            | Energy imports from New York, Canada, or Maritime provinces        |
| **ES**  | Energy Service                 | Energy-only interconnection without capacity rights                   | Projects selling energy only, not participating in capacity market |
| **MIS** | Market Interconnection Service | Historical service type for capacity increases at existing facilities | Legacy designation for uprates and expansions                      |
| **NS**  | Network Service                | Legacy network service designation                                    | Older projects predating current service type structure            |

### Load Zones

ISO-NE divides New England into 13 load zones for locational pricing and resource planning:

| Zone Code | Geographic Area               | Description                                     |
| --------- | ----------------------------- | ----------------------------------------------- |
| **BOST**  | Boston                        | Metro Boston area, Massachusetts                |
| **CT**    | Connecticut                   | Connecticut aggregate zone                      |
| **ME**    | Maine                         | Maine aggregate zone                            |
| **NH**    | New Hampshire                 | New Hampshire aggregate zone                    |
| **RI**    | Rhode Island                  | Rhode Island aggregate zone                     |
| **VT**    | Vermont                       | Vermont aggregate zone                          |
| **SEMA**  | Southeast Massachusetts       | Cape Cod and southeastern Massachusetts         |
| **WMA**   | Western/Central Massachusetts | Western and central Massachusetts regions       |
| **NOR**   | Northeast Massachusetts       | Northeast Massachusetts                         |
| **CMA**   | Central Massachusetts         | Central Massachusetts                           |
| **SME**   | Southern Maine                | Southern Maine region                           |
| **SWCT**  | Southwest Connecticut         | Southwest Connecticut                           |
| **BHE**   | Bangor Hydro Electric         | Northern Maine (Bangor Hydro service territory) |

### Project Classifications

ISO-NE categorizes projects into three main types:

**Project Types** (`project_type` field):

* **G (Generation)**: New generation facilities - represents vast majority of queue
* **TS (Transmission Service)**: Transmission-only interconnection requests
* **ETU (Elective Transmission Upgrade)**: Merchant transmission upgrades proposed by developers

**Unit Types** (`unit_id` field - 11 codes):

* **PV**: Photovoltaic (solar)
* **WT**: Wind Turbines
* **OT**: Other (typically used for batteries)
* **CC**: Combined Cycle (natural gas)
* **GT**: Gas Turbines
* **ST**: Steam Turbines
* **HD**: Hydraulic/Hydro
* **HW**: Hydro Water Wheels
* **IC**: Internal Combustion
* **FC**: Fuel Cells
* **PS**: Pumped Storage

### Seasonal Capacity Ratings

New England experiences significant temperature variations affecting equipment performance. ISO-NE therefore tracks both summer and winter capacity ratings:

* **Summer Capacity** (`summer_capacity_mw`): Capacity rating during hot weather, typically lower due to heat derating of transformers and transmission equipment
* **Winter Capacity** (`winter_capacity_mw`): Capacity rating during cold weather, typically higher as equipment operates more efficiently at lower temperatures

Winter capacity is particularly important in New England due to peak electricity demand occurring during cold weather events when natural gas is also needed for heating.

### Fuel Type Hybrid Notation

ISO-NE represents hybrid projects using space-separated fuel codes in the `fuel` and `fuel_type` fields:

* **"SUN BAT"**: Solar + Battery hybrid
* **"WND BAT"**: Wind + Battery hybrid
* **"NG SUN BAT"**: Natural Gas + Solar + Battery multi-technology project

This differs from other ISOs that may use different delimiters or create separate records for each technology component.

### Data Source Lifecycle

The `data_source` field tracks projects through their lifecycle:

* **active**: Projects currently in interconnection queue or under development (93 projects)
* **withdrawn**: Projects that withdrew from the queue before achieving commercial operation (1,308 projects - 75% of total)
* **commercial**: Projects that successfully achieved commercial operation (351 projects)

The 75% withdrawal rate reflects the speculative nature of many interconnection requests and the challenges of project development in New England.

### Transmission Owners

The `to_report` field identifies the reporting entity or transmission owner responsible for the interconnection. Nine entities report to ISO-NE:

**Transmission Owners**:

* **ISO-NE**: ISO New England itself (for system-level projects)
* **BHE**: Bangor Hydro Electric (Northern Maine)
* **CMP**: Central Maine Power
* **MPS**: Massachusetts Power Supply (historical)
* **NGRID**: National Grid (Massachusetts, Rhode Island)
* **NSTAR**: Eversource (previously NSTAR, Eastern Massachusetts)
* **NU**: Northeast Utilities/Eversource (Connecticut, New Hampshire)
* **TEUS**: Transmission Enhancement Services
* **UI**: United Illuminating (Connecticut)

<Note>
  **Data Updates**: ISO-NE queue data is updated based on ISO New England's interconnection queue reports published periodically.
</Note>

<Warning>
  **Developer Field Limitations**: The `neiso_developer` field often contains "PD" (Protected Developer) for confidentiality. The enriched `developer` field provides better corporate entity mapping but may still have limited coverage for smaller developers.
</Warning>

<Info>
  **Geographic Edge Cases**: While ISO-NE primarily serves the six New England states, a small number of projects are located in New Brunswick, Canada (state code "NB") and New York (state code "NY") that interconnect to the New England grid system.
</Info>


## OpenAPI

````yaml GET /interconnection/iso-ne
openapi: 3.0.0
info:
  title: Cleanview Public API
  version: 0.1.0
  description: >-
    RESTful API for accessing clean energy data including EIA capacity and ISO
    queue information
  contact:
    name: Cleanview Energy
    url: https://cleanview.co/demo
servers:
  - url: https://api.cleanview.co/api/v1
    description: Production server
security:
  - ApiKeyAuth: []
paths:
  /interconnection/iso-ne:
    get:
      tags:
        - Interconnection
      summary: Get ISO-NE interconnection queue data
      description: Retrieve real-time interconnection queue data from ISO New England
      parameters:
        - in: query
          name: limit
          schema:
            type: integer
            minimum: 50
            maximum: 5000
            default: 50
          description: Number of records to return
        - in: query
          name: offset
          schema:
            type: integer
            default: 0
          description: Number of records to skip
        - in: query
          name: state
          schema:
            type: string
          description: Filter by state code
        - in: query
          name: technology
          schema:
            type: string
          description: Filter by technology type
        - in: query
          name: min_capacity
          schema:
            type: number
          description: Minimum capacity in MW
        - in: query
          name: max_capacity
          schema:
            type: number
          description: Maximum capacity in MW
      responses:
        '200':
          description: Successful response with ISO-NE interconnection queue data
          content:
            application/json:
              schema:
                type: object
                properties:
                  iso:
                    type: string
                    example: ISO-NE
                  summary:
                    $ref: '#/components/schemas/Summary'
                  filters:
                    type: object
                    description: Applied filters for the request
                  data:
                    type: array
                    description: Array of interconnection queue records
                    items:
                      type: object
        '401':
          description: Unauthorized
        '500':
          description: Internal server error
      security:
        - ApiKeyAuth: []
components:
  schemas:
    Summary:
      type: object
      description: Summary metadata for pagination
      properties:
        limit:
          type: integer
          description: Number of records per page
        offset:
          type: integer
          description: Number of records to skip
        total_results:
          type: integer
          description: Total number of records matching the query
        has_more:
          type: boolean
          description: Whether additional records exist beyond this page
        current_page:
          type: integer
          description: Current page number (1-indexed)
        total_pages:
          type: integer
          description: Total number of pages available
  securitySchemes:
    ApiKeyAuth:
      type: apiKey
      in: header
      name: x-api-key
      description: API key authentication using x-api-key header

````