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

# List available facility types



## OpenAPI

````yaml /openapi/emsp-location/openapi.yaml get /emsp/v1/locations/facilities
openapi: 3.0.0
info:
  title: Spirii EMMS - Location Discovery API
  description: Real-time charging locations, EVSE availability, and geospatial search
  version: v1
  contact: {}
servers:
  - url: https://api.spirii.com
    description: Production
security:
  - OAuth2ClientCredentials:
      - emsp:locations:read
tags:
  - name: Locations
    description: Location discovery and search operations
paths:
  /emsp/v1/locations/facilities:
    get:
      tags:
        - Locations
      summary: List available facility types
      operationId: locations_list_facilities
      parameters:
        - name: token_id
          required: false
          in: query
          description: >-
            End-user token id; resolves through its token group to the reachable
            SUB networks.
          schema:
            type: string
        - name: token_group_id
          required: false
          in: query
          description: >-
            Token group id (peer to token_id); resolves to its assigned SUB
            networks.
          schema:
            type: string
        - name: language
          required: false
          in: query
          description: >-
            Preferred label language (ISO 639-1 with optional region, e.g.
            `en-US`). Accepted for forward compatibility; labels are
            English-only for now, so it currently has no effect.
          schema:
            type: string
        - name: countries
          required: false
          in: query
          description: >-
            Restrict the counts to locations in these countries. ISO 3166-1
            alpha-3 codes (e.g. `DNK`, `DEU`) — not alpha-2 — matching how
            country is stored across the topology layer. Matches any listed
            value.
          schema:
            type: array
            items:
              type: string
      responses:
        '200':
          description: Available facility types with their location counts.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/FacilitiesResponse'
        '400':
          description: Invalid query parameters
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetailDto'
        '401':
          description: Missing or invalid credentials
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetailDto'
        '403':
          description: Insufficient scope
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetailDto'
components:
  schemas:
    FacilitiesResponse:
      type: object
      properties:
        facilities:
          description: The facility catalogue with visible-location counts.
          type: array
          items:
            $ref: '#/components/schemas/FacilityResponse'
      required:
        - facilities
    ProblemDetailDto:
      type: object
      properties:
        type:
          type: string
          example: about:blank
          description: >-
            URI identifying the problem type (about:blank until the docs site is
            live)
        title:
          type: string
          example: Tenant not found
        status:
          type: number
          example: 404
        detail:
          type: string
          example: No tenant exists with id 0192...c3.
        instance:
          type: string
          example: /v1/tenant/profile
        code:
          type: string
          example: tenant_not_found
          description: Stable machine-readable error code
        trace_id:
          type: string
          example: abc123def456
          description: Correlation id; matches dd.trace_id in Datadog
        timestamp:
          type: string
          example: '2026-06-10T09:30:00.000Z'
          format: date-time
        errors:
          description: Field-level validation errors (validation failures only)
          type: array
          items:
            $ref: '#/components/schemas/ProblemFieldErrorDto'
      required:
        - type
        - title
        - status
        - detail
        - instance
        - code
        - trace_id
        - timestamp
    FacilityResponse:
      type: object
      properties:
        facility_type:
          type: string
          description: Machine-readable OCPI facility type key.
          example: WIFI
        label:
          type: string
          description: Human-readable label (English for now).
          example: Wi-Fi
        description:
          type: string
          nullable: true
          description: OCPI 2.3.0 facility description, or null.
          example: Wifi or other type of internet available.
        icon_hint:
          type: string
          nullable: true
          description: Suggested icon name (Material Icons convention), or null.
          example: wifi
        location_count:
          type: number
          description: Number of visible locations offering this facility.
      required:
        - facility_type
        - label
        - description
        - icon_hint
        - location_count
    ProblemFieldErrorDto:
      type: object
      properties:
        field:
          type: string
          example: workspace_id
        code:
          type: string
          example: is_uuid
        message:
          type: string
          example: workspace_id must be a UUID
      required:
        - field
        - code
        - message
  securitySchemes:
    OAuth2ClientCredentials:
      type: oauth2
      flows:
        clientCredentials:
          tokenUrl: /oauth/token
          scopes:
            emsp:locations:read: Search and view locations, EVSEs, connectors

````