> ## 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 visible locations on this network

> Lists the charging locations actually visible on a sub-network, with access rules already applied — in other words, what a driver whose token group is assigned to this sub-network can see. Useful for verifying a slice before assigning it, or for troubleshooting why a driver can't see a particular charger.



## OpenAPI

````yaml /openapi/emsp-network/openapi.yaml get /emsp/v1/networks/{network_id}/locations
openapi: 3.0.0
info:
  title: Spirii EMSP - Network & Access Control API
  description: >-
    Manages network access and location visibility for secure multi-tenant
    operation.
  version: v1
  contact: {}
servers:
  - url: https://api.spirii.com
    description: Production
security:
  - OAuth2ClientCredentials: []
tags:
  - name: Networks
    description: Network lifecycle management
paths:
  /emsp/v1/networks/{network_id}/locations:
    get:
      tags:
        - Networks
      summary: List visible locations on this network
      description: >-
        Lists the charging locations actually visible on a sub-network, with
        access rules already applied — in other words, what a driver whose token
        group is assigned to this sub-network can see. Useful for verifying a
        slice before assigning it, or for troubleshooting why a driver can't see
        a particular charger.
      operationId: NetworkController_listLocations_v1
      parameters:
        - name: Idempotency-Key
          in: header
          description: >-
            Client-generated unique key per operation intent (UUID). Same key +
            identical body replays the original response; same key + different
            body returns 409.
          required: true
          schema:
            type: string
            format: uuid
        - name: network_id
          required: true
          in: path
          description: The unique ID of the sub-network to list visible locations for.
          schema:
            type: string
            format: uuid
        - name: after
          required: false
          in: query
          description: >-
            Cursor to start fetching records after — the `pagination.end_cursor`
            of a previous response. Omit it to fetch the first page, and stop
            paging once `pagination.has_next` is false. Sending it empty is a
            400: an empty cursor is a broken cursor, not a request for the first
            page.
          schema:
            minLength: 1
            type: string
        - name: cursor
          required: false
          in: query
          deprecated: true
          description: 'Deprecated: use `after`.'
          schema:
            minLength: 1
            type: string
        - name: limit
          required: false
          in: query
          description: Results per page (1–200)
          schema:
            default: 50
            type: number
        - name: country
          required: false
          in: query
          description: >-
            Only return locations in this country. ISO 3166-1 **alpha-3** code
            (for example `DNK`, `DEU`) — not alpha-2.
          schema:
            pattern: ^[A-Z]{3}$
            type: string
      responses:
        '200':
          description: Paginated list of locations visible on the sub-network.
          content:
            application/json:
              schema:
                allOf:
                  - $ref: '#/components/schemas/PaginatedEnvelope'
                  - type: object
                    required:
                      - data
                    properties:
                      data:
                        type: array
                        items:
                          $ref: '#/components/schemas/NetworkLocationResponse'
components:
  schemas:
    PaginatedEnvelope:
      type: object
      properties:
        pagination:
          description: Pagination state for this page.
          allOf:
            - $ref: '#/components/schemas/PaginationMetaResponse'
        next_cursor:
          type: string
          nullable: true
          example: null
          deprecated: true
          description: 'Deprecated: use `pagination.end_cursor`.'
        has_next:
          type: boolean
          example: false
          deprecated: true
          description: 'Deprecated: use `pagination.has_next`.'
      required:
        - pagination
        - next_cursor
        - has_next
    NetworkLocationResponse:
      type: object
      properties:
        id:
          type: string
          format: uuid
          description: Location identifier.
        name:
          type: string
          nullable: true
          description: Location name.
        source_operator_id:
          type: string
          description: Operator ID (eMI3, e.g. `DK*SPI`) of the location owner.
        total_evses:
          type: number
          description: Total number of EVSEs at the location.
      required:
        - id
        - name
        - source_operator_id
        - total_evses
    PaginationMetaResponse:
      type: object
      properties:
        end_cursor:
          type: string
          nullable: true
          example: null
          description: >-
            Cursor for the end of the current page. Pass it back as `after` to
            fetch the next page; null on the last page.
        has_next:
          type: boolean
          example: false
          description: Whether there are more records to fetch.
      required:
        - end_cursor
        - has_next
  securitySchemes:
    OAuth2ClientCredentials:
      type: oauth2
      flows:
        clientCredentials:
          tokenUrl: /oauth/token
          scopes:
            emsp:networks:read: View network and access control configuration
            emsp:networks:write: Create/update/delete SUB networks, manage access rules
            emsp:networks:publish: Publish/drain networks (PATCH /networks/:id/publish-state)

````