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

# List pricing locations

> List pricing locations for a market such as ERCOT.



## OpenAPI

````yaml GET /v1/pricing_locations
openapi: 3.1.0
info:
  title: GridCertainty Public API
  description: >-
    Read-only public API for ERCOT datasets, pricing locations, reports, and
    system metadata.
  version: 1.0.0
servers:
  - url: https://api.felixfusion.ai
    description: Production public API
  - url: http://localhost:8001
    description: Local public API
security:
  - ApiKeyHeader: []
  - ApiKeyQuery: []
paths:
  /v1/pricing_locations:
    get:
      tags:
        - Pricing Locations
      summary: List pricing locations
      description: List pricing locations for a market such as ERCOT.
      operationId: list_pricing_locations
      parameters:
        - $ref: '#/components/parameters/sort_column'
        - $ref: '#/components/parameters/sort_order'
        - $ref: '#/components/parameters/isos'
        - $ref: '#/components/parameters/search'
        - $ref: '#/components/parameters/zones'
        - $ref: '#/components/parameters/status'
        - $ref: '#/components/parameters/location_types'
        - $ref: '#/components/parameters/has_geo_data'
      responses:
        '200':
          description: Pricing location list
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/PricingLocationListResponse'
components:
  parameters:
    sort_column:
      name: sort_column
      in: query
      schema:
        type: string
      description: Sort column for pricing locations.
    sort_order:
      name: sort_order
      in: query
      schema:
        type: string
        enum:
          - asc
          - desc
      description: Sort order for pricing locations.
    isos:
      name: isos
      in: query
      schema:
        type: string
        default: ercot
      description: Comma-separated ISO codes. The first value is used as the market code.
    search:
      name: search
      in: query
      schema:
        type: string
      description: Free-text search for pricing locations.
    zones:
      name: zones
      in: query
      schema:
        type: string
      description: Comma-separated zone filter.
    status:
      name: status
      in: query
      schema:
        type: string
      description: Comma-separated status filter.
    location_types:
      name: location_types
      in: query
      schema:
        type: string
      description: Comma-separated location type filter.
    has_geo_data:
      name: has_geo_data
      in: query
      schema:
        type: boolean
      description: Filter by whether geo coordinates exist.
  schemas:
    PricingLocationListResponse:
      type: object
      properties:
        items:
          type: array
          items:
            $ref: '#/components/schemas/PricingLocation'
        total_items:
          type: integer
        facets:
          type: object
          additionalProperties: true
    PricingLocation:
      type: object
      properties:
        gs_entity_id:
          type: string
        location:
          type: string
        location_type:
          type:
            - string
            - 'null'
        market_id:
          type:
            - string
            - 'null'
        baa:
          type:
            - string
            - 'null'
        zone:
          type:
            - string
            - 'null'
        zone_type:
          type:
            - string
            - 'null'
        latitude:
          type:
            - number
            - 'null'
        longitude:
          type:
            - number
            - 'null'
        pricing_datasets:
          type: array
          items:
            type: string
        earliest_seen_utc:
          type:
            - string
            - 'null'
        latest_seen_utc:
          type:
            - string
            - 'null'
        status_threshold_days:
          type:
            - number
            - 'null'
        status:
          type:
            - string
            - 'null'
      additionalProperties: true
  securitySchemes:
    ApiKeyHeader:
      type: apiKey
      in: header
      name: x-api-key
    ApiKeyQuery:
      type: apiKey
      in: query
      name: api_key

````