> ## 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 DATEX II v3 AFIR energy infrastructure statuses



## OpenAPI

````yaml /openapi/integration-api-v2/openapi.yaml get /v2/afir/energy-infrastructure-statuses
openapi: 3.0.0
info:
  title: Spirii API
  description: Spirii API
  version: 2.10.0
  contact: {}
servers:
  - url: https://api.spirii.com
security: []
tags: []
paths:
  /v2/afir/energy-infrastructure-statuses:
    get:
      tags:
        - AFIR
      summary: Get DATEX II v3 AFIR energy infrastructure statuses
      operationId: AfirController_getEnergyInfrastructureStatuses_v2
      parameters:
        - name: customerIds
          required: false
          in: query
          description: >-
            List of IDs of customers that 'own' the locations. The 'customerIds'
            are unique identifiers for customers. The 'customers' can be found
            in the Connect Customer management page. These customer IDs
            correspond with the customer IDs that can be retrieved from the
            Customer v2 API.
          schema:
            example:
              - 123
              - 456
              - 789
            type: array
            items:
              type: number
        - name: cpoId
          required: false
          in: query
          description: Charge Point Operator (CPO) ID, also known as Operator
          schema:
            example: 42
            type: number
        - name: countryIsos
          required: false
          in: query
          description: Country ISO codes (ISO 3166-1 alpha-2).
          schema:
            example:
              - DK
              - FR
              - DE
            type: array
            items:
              type: string
        - name: If-Modified-Since
          in: header
          description: Return 304 if data has not changed since this date
          required: false
          schema:
            type: string
      responses:
        '200':
          description: Gzipped DATEX II v3 dynamic payload
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/DatexDynamicPayload'
        '304':
          description: Not modified since the provided If-Modified-Since date
components:
  schemas:
    DatexDynamicPayload:
      type: object
      properties:
        messageContainer:
          $ref: '#/components/schemas/DatexMessageContainer'
      required:
        - messageContainer
    DatexMessageContainer:
      type: object
      properties:
        payload:
          type: array
          items:
            $ref: '#/components/schemas/DatexDynamicPayloadItem'
        exchangeInformation:
          $ref: '#/components/schemas/DatexExchangeInformation'
      required:
        - payload
        - exchangeInformation
    DatexDynamicPayloadItem:
      type: object
      properties:
        modelBaseVersionG:
          type: string
          description: DATEX II model base version
          example: '3'
        profileNameG:
          type: string
          description: DATEX II profile name
          example: AFIR Energy Infrastructure
        profileVersionG:
          type: string
          description: DATEX II profile version
          example: 01-00-00
        aegiEnergyInfrastructureStatusPublication:
          $ref: '#/components/schemas/EnergyInfrastructureStatusPublication'
      required:
        - modelBaseVersionG
        - profileNameG
        - profileVersionG
        - aegiEnergyInfrastructureStatusPublication
    DatexExchangeInformation:
      type: object
      properties:
        exchangeContext:
          $ref: '#/components/schemas/DatexExchangeContext'
        dynamicInformation:
          $ref: '#/components/schemas/DatexDynamicInformation'
      required:
        - exchangeContext
        - dynamicInformation
    EnergyInfrastructureStatusPublication:
      type: object
      properties:
        lang:
          type: string
          description: ISO 639-1 language code
          example: en
        publicationTime:
          type: string
          description: Publication timestamp (ISO 8601)
          example: '2025-06-15T12:00:00.000Z'
        tableReference:
          description: >-
            References to the static tables whose sites are included in this
            publication
          type: array
          items:
            $ref: '#/components/schemas/DatexReference'
        publicationCreator:
          $ref: '#/components/schemas/DatexPublicationCreator'
        headerInformation:
          $ref: '#/components/schemas/DatexHeaderInformation'
        energyInfrastructureSiteStatus:
          type: array
          items:
            $ref: '#/components/schemas/EnergyInfrastructureSiteStatus'
      required:
        - lang
        - publicationTime
        - publicationCreator
        - headerInformation
        - energyInfrastructureSiteStatus
    DatexExchangeContext:
      type: object
      properties:
        codedExchangeProtocol:
          description: Exchange protocol type
          example:
            value: snapshotPull
          allOf:
            - $ref: '#/components/schemas/DatexEnumValue'
        exchangeSpecificationVersion:
          type: string
          description: >-
            The version of the protocol used for the exchange as by standard or
            as agreed among client and supplier
          example: '3.0'
        supplierOrCisRequester:
          type: object
          description: >-
            It defines the supplier or CIS requester information of the exchange
            context
          example: {}
      required:
        - codedExchangeProtocol
        - exchangeSpecificationVersion
        - supplierOrCisRequester
    DatexDynamicInformation:
      type: object
      properties:
        exchangeStatus:
          description: Exchange session status
          example:
            value: online
          allOf:
            - $ref: '#/components/schemas/DatexEnumValue'
        messageGenerationTimestamp:
          type: string
          description: Timestamp when this message was generated (ISO 8601)
          example: '2025-06-15T12:00:00.000Z'
      required:
        - exchangeStatus
        - messageGenerationTimestamp
    DatexReference:
      type: object
      properties:
        targetClass:
          type: string
          description: DATEX II target class
          example: FacilityObject
        idG:
          type: string
          description: Global ID of the referenced object
          example: <domain-identifier>-1234
        versionG:
          type: string
          description: Version of the referenced object
          example: '1'
      required:
        - targetClass
        - idG
    DatexPublicationCreator:
      type: object
      properties:
        country:
          type: string
          description: ISO 3166-1 alpha-2 country code
          example: DK
        nationalIdentifier:
          type: string
          description: National identifier of the data provider
          example: DK-NAP-SPIRII
      required:
        - country
        - nationalIdentifier
    DatexHeaderInformation:
      type: object
      properties:
        confidentiality:
          description: Confidentiality level
          allOf:
            - $ref: '#/components/schemas/DatexEnumValue'
        informationStatus:
          description: Information status
          allOf:
            - $ref: '#/components/schemas/DatexEnumValue'
      required:
        - confidentiality
        - informationStatus
    EnergyInfrastructureSiteStatus:
      type: object
      properties:
        reference:
          description: Reference to the corresponding static site
          allOf:
            - $ref: '#/components/schemas/DatexReference'
        lastUpdated:
          type: string
          description: Timestamp this site was last updated (ISO 8601)
          example: '2025-06-15T12:00:00.000Z'
        energyInfrastructureStationStatus:
          type: array
          items:
            $ref: '#/components/schemas/EnergyInfrastructureStationStatus'
      required:
        - reference
        - lastUpdated
        - energyInfrastructureStationStatus
    DatexEnumValue:
      type: object
      properties:
        value:
          type: string
          description: DATEX II enumeration value
          example: available
        extendedValueG:
          type: string
          description: Extended value for enumerations not in the base spec
          example: customValue
      required:
        - value
    EnergyInfrastructureStationStatus:
      type: object
      properties:
        reference:
          description: Reference to the corresponding static station
          allOf:
            - $ref: '#/components/schemas/DatexReference'
        lastUpdated:
          type: string
          description: Timestamp this station was last updated (ISO 8601)
          example: '2025-06-15T12:00:00.000Z'
        refillPointStatus:
          type: array
          items:
            $ref: '#/components/schemas/RefillPointStatus'
      required:
        - reference
        - lastUpdated
        - refillPointStatus
    RefillPointStatus:
      type: object
      properties:
        aegiElectricChargingPointStatus:
          $ref: '#/components/schemas/ElectricChargingPointStatus'
      required:
        - aegiElectricChargingPointStatus
    ElectricChargingPointStatus:
      type: object
      properties:
        reference:
          description: Reference to the corresponding static charging point
          allOf:
            - $ref: '#/components/schemas/DatexReference'
        status:
          description: Current status of the charging point
          allOf:
            - $ref: '#/components/schemas/DatexEnumValue'
        lastUpdated:
          type: string
          description: Timestamp this charging point was last updated (ISO 8601)
          example: '2025-06-15T12:00:00.000Z'
        energyRateUpdate:
          description: Dynamic tariff/pricing updates for this charging point
          type: array
          items:
            $ref: '#/components/schemas/DatexEnergyRateUpdate'
      required:
        - reference
        - status
        - lastUpdated
    DatexEnergyRateUpdate:
      type: object
      properties:
        lastUpdated:
          type: string
          description: Timestamp of the last rate update (ISO 8601)
          example: '2025-06-15T12:00:00.000Z'
        energyRateReference:
          description: Reference to the static EnergyRate object this update applies to
          allOf:
            - $ref: '#/components/schemas/DatexReference'
        energyPrice:
          description: Applicable prices for this rate
          type: array
          items:
            $ref: '#/components/schemas/DatexEnergyPrice'
      required:
        - lastUpdated
        - energyRateReference
    DatexEnergyPrice:
      type: object
      properties:
        priceType:
          description: Type of price (pricePerKWh, pricePerMinute, flatRate, etc.)
          allOf:
            - $ref: '#/components/schemas/DatexEnumValue'
        value:
          type: number
          description: Price amount in the applicable currency
          example: 0.37
        taxIncluded:
          type: boolean
          description: Whether the listed price already includes tax
          example: true
        taxRate:
          type: number
          description: Tax rate as a percentage (e.g. 25 for 25%)
          example: 25
        overallPeriod:
          description: Validity period for this price
          allOf:
            - $ref: '#/components/schemas/DatexPriceOverallPeriod'
        timeBasedApplicability:
          description: Time-based charging duration applicability (minutes)
          allOf:
            - $ref: '#/components/schemas/DatexTimeBasedApplicability'
        energyBasedApplicability:
          description: Energy-based applicability (kWh)
          allOf:
            - $ref: '#/components/schemas/DatexEnergyBasedApplicability'
      required:
        - priceType
        - value
    DatexPriceOverallPeriod:
      type: object
      properties:
        overallStartTime:
          type: string
          description: Start of validity period (ISO 8601)
          example: '2025-01-01T00:00:00Z'
        overallEndTime:
          type: string
          description: End of validity period (ISO 8601)
          example: '2025-12-31T23:59:59Z'
        validPeriod:
          type: array
          items:
            $ref: '#/components/schemas/DatexPriceValidPeriod'
      required:
        - overallStartTime
    DatexTimeBasedApplicability:
      type: object
      properties:
        fromMinute:
          type: number
          description: Price valid from this minute of charging
          example: 240
        toMinute:
          type: number
          description: Price valid up to this minute of charging
          example: 480
    DatexEnergyBasedApplicability:
      type: object
      properties:
        fromKWh:
          type: number
          description: Price valid from this kWh amount
          example: 0
        toKWh:
          type: number
          description: Price valid up to this kWh amount
          example: 50
    DatexPriceValidPeriod:
      type: object
      properties:
        recurringDayWeekMonthPeriod:
          type: array
          items:
            $ref: '#/components/schemas/DatexPriceRecurringDayWeekMonthPeriod'
        recurringTimePeriodOfDay:
          type: array
          items:
            $ref: '#/components/schemas/DatexPriceTimePeriodOfDay'
    DatexPriceRecurringDayWeekMonthPeriod:
      type: object
      properties:
        comDayWeekMonth:
          $ref: '#/components/schemas/DatexPriceDayWeekMonth'
      required:
        - comDayWeekMonth
    DatexPriceTimePeriodOfDay:
      type: object
      properties:
        startTimeOfPeriod:
          type: string
          description: Start time (HH:mm)
          example: '09:00'
        endTimeOfPeriod:
          type: string
          description: End time (HH:mm)
          example: '17:00'
      required:
        - startTimeOfPeriod
        - endTimeOfPeriod
    DatexPriceDayWeekMonth:
      type: object
      properties:
        applicableDay:
          description: Applicable days of the week
          type: array
          items:
            $ref: '#/components/schemas/DatexEnumValue'
      required:
        - applicableDay

````