> ## 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. # Get location detail ## OpenAPI ````yaml /openapi/emsp-location/openapi.yaml get /emsp/v1/locations/{location_id} 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/{location_id}: get: tags: - Locations summary: Get location detail operationId: locations_get parameters: - name: location_id required: true in: path schema: type: string format: uuid - 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 responses: '200': description: The requested location. content: application/json: schema: $ref: '#/components/schemas/LocationReadResponse' '400': description: Invalid location_id 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' '404': description: Location not found content: application/problem+json: schema: $ref: '#/components/schemas/ProblemDetailDto' components: schemas: LocationReadResponse: type: object properties: id: type: string format: uuid description: Canonical location id. cpo_id: type: string description: CPO id (eMI3, e.g. `DK*SPI`). source_id: type: string description: Operator's own id for the location. name: type: string description: Location name. address: $ref: '#/components/schemas/AddressReadResponse' parking_type: type: string enum: - ALONG_MOTORWAY - ON_DRIVEWAY - ON_STREET - OTHER - PARKING_GARAGE - PARKING_LOT - UNDERGROUND_GARAGE - UNKNOWN access_type: type: string enum: - PRIVATE - PUBLIC - RESTRICTED facilities: description: Location facilities. type: array items: type: string evses: description: The location EVSEs (each with its connectors). type: array items: $ref: '#/components/schemas/EvseReadResponse' last_updated: type: string format: date-time description: Last-update timestamp (UTC). created_at: type: string format: date-time description: Creation timestamp (UTC). required: - id - cpo_id - source_id - name - address - evses - last_updated - created_at 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 AddressReadResponse: type: object properties: address: type: string city: type: string postal_code: type: string country: type: string description: Country code. coordinates: $ref: '#/components/schemas/CoordinatesReadResponse' time_zone: type: string required: - address - city - postal_code - country - coordinates - time_zone EvseReadResponse: type: object properties: uid: type: string description: EVSE uid (OCPI natural key, unique within the location). evse_id: type: string description: OCPI EVSE id (e.g. `DK*SPI*E001*1`). status: type: string enum: - AVAILABLE - BLOCKED - CHARGING - INOPERATIVE - OUTOFORDER - PLANNED - REMOVED - RESERVED - UNKNOWN description: Current EVSE status. capabilities: description: OCPI capabilities (e.g. RFID_READER, REMOTE_START_STOP_CAPABLE). type: array items: type: string connectors: description: The EVSE connectors. type: array items: $ref: '#/components/schemas/ConnectorReadResponse' required: - uid - evse_id - status - connectors 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 CoordinatesReadResponse: type: object properties: latitude: type: string description: Latitude (decimal-degree string, canonical shape). longitude: type: string description: Longitude (decimal-degree string, canonical shape). required: - latitude - longitude ConnectorReadResponse: type: object properties: id: type: string description: Connector id (OCPI, unique within the EVSE). standard: type: string enum: - CHADEMO - CHAOJI - DOMESTIC_A - DOMESTIC_B - DOMESTIC_C - DOMESTIC_D - DOMESTIC_E - DOMESTIC_F - DOMESTIC_G - DOMESTIC_H - DOMESTIC_I - DOMESTIC_J - DOMESTIC_K - DOMESTIC_L - DOMESTIC_M - DOMESTIC_N - DOMESTIC_O - GBT_AC - GBT_DC - IEC_60309_2_single_16 - IEC_60309_2_three_16 - IEC_60309_2_three_32 - IEC_60309_2_three_64 - IEC_62196_T1 - IEC_62196_T1_COMBO - IEC_62196_T2 - IEC_62196_T2_COMBO - IEC_62196_T3A - IEC_62196_T3C - MCS - NEMA_10_30 - NEMA_10_50 - NEMA_14_30 - NEMA_14_50 - NEMA_5_20 - NEMA_6_30 - NEMA_6_50 - OTHER - PANTOGRAPH_BOTTOM_UP - PANTOGRAPH_TOP_DOWN - SAE_J3400 - TESLA_R - TESLA_S description: Connector standard. format: type: string enum: - CABLE - SOCKET description: Cable or socket. power_type: type: string enum: - AC_1_PHASE - AC_3_PHASE - DC description: AC single/three phase or DC. max_electric_power: type: number description: Maximum electric power in watts. required: - id - standard - format - power_type - max_electric_power securitySchemes: OAuth2ClientCredentials: type: oauth2 flows: clientCredentials: tokenUrl: /oauth/token scopes: emsp:locations:read: Search and view locations, EVSEs, connectors ````