> ## 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 tables



## OpenAPI

````yaml /openapi/integration-api-v2/openapi.yaml get /v2/afir/energy-infrastructure-tables
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-tables:
    get:
      tags:
        - AFIR
      summary: Get DATEX II v3 AFIR energy infrastructure tables
      operationId: AfirController_getEnergyInfrastructureTables_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 static payload
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/DatexStaticPayload'
        '304':
          description: Not modified since the provided If-Modified-Since date
components:
  schemas:
    DatexStaticPayload:
      type: object
      properties:
        payload:
          $ref: '#/components/schemas/DatexStaticPayloadContent'
      required:
        - payload
    DatexStaticPayloadContent:
      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
        aegiEnergyInfrastructureTablePublication:
          $ref: '#/components/schemas/EnergyInfrastructureTablePublication'
      required:
        - modelBaseVersionG
        - profileNameG
        - profileVersionG
        - aegiEnergyInfrastructureTablePublication
    EnergyInfrastructureTablePublication:
      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'
        publicationCreator:
          $ref: '#/components/schemas/DatexPublicationCreator'
        headerInformation:
          $ref: '#/components/schemas/DatexHeaderInformation'
        energyInfrastructureTable:
          type: array
          items:
            $ref: '#/components/schemas/EnergyInfrastructureTable'
      required:
        - lang
        - publicationTime
        - publicationCreator
        - headerInformation
        - energyInfrastructureTable
    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
    EnergyInfrastructureTable:
      type: object
      properties:
        idG:
          type: string
          description: Unique identifier
          example: spirii-table-1
        versionG:
          type: string
          description: Version
          example: '1'
        tableName:
          type: string
          description: Human-readable table name
          example: Spirii Charging Locations
        energyInfrastructureSite:
          type: array
          items:
            $ref: '#/components/schemas/EnergyInfrastructureSite'
      required:
        - idG
        - versionG
        - tableName
        - energyInfrastructureSite
    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
    EnergyInfrastructureSite:
      type: object
      properties:
        idG:
          type: string
          description: Unique identifier
          example: site-42
        versionG:
          type: string
          description: Version
          example: '1'
        name:
          description: Name of this facility
          allOf:
            - $ref: '#/components/schemas/DatexMultilingualString'
        typeOfSite:
          description: Type of site (e.g. onstreet, openSpace)
          allOf:
            - $ref: '#/components/schemas/DatexEnumValue'
        locationReference:
          $ref: '#/components/schemas/DatexLocationReference'
        operator:
          description: Site operator
          allOf:
            - $ref: '#/components/schemas/DatexInlineOrganisationWrapper'
        owner:
          description: Site owner
          allOf:
            - $ref: '#/components/schemas/DatexInlineOrganisationWrapper'
        helpdesk:
          description: Helpdesk organisation
          allOf:
            - $ref: '#/components/schemas/DatexHelpdeskOrganisationWrapper'
        operatingHours:
          $ref: '#/components/schemas/DatexOperatingHours'
        energyInfrastructureStation:
          type: array
          items:
            $ref: '#/components/schemas/EnergyInfrastructureStation'
      required:
        - idG
        - versionG
        - typeOfSite
        - locationReference
        - operator
        - energyInfrastructureStation
    DatexMultilingualString:
      type: object
      properties:
        values:
          description: Language-tagged string values
          type: array
          items:
            $ref: '#/components/schemas/DatexMultilingualStringValue'
      required:
        - values
    DatexLocationReference:
      type: object
      properties:
        locAreaLocation:
          $ref: '#/components/schemas/DatexLocAreaLocation'
      required:
        - locAreaLocation
    DatexInlineOrganisationWrapper:
      type: object
      properties:
        afacAnOrganisation:
          $ref: '#/components/schemas/DatexInlineOrganisation'
      required:
        - afacAnOrganisation
    DatexHelpdeskOrganisationWrapper:
      type: object
      properties:
        afacReferenceableOrganisation:
          $ref: '#/components/schemas/DatexReferenceableOrganisationWithUnits'
      required:
        - afacReferenceableOrganisation
    DatexOperatingHours:
      type: object
      properties:
        afacOpenAllHours:
          type: object
          description: Present (empty object) when the site is open 24/7
        afacOperatingHoursSpecification:
          $ref: '#/components/schemas/DatexOperatingHoursSpecification'
    EnergyInfrastructureStation:
      type: object
      properties:
        idG:
          type: string
          description: Unique identifier
          example: station-100
        versionG:
          type: string
          description: Version
          example: '1'
        totalMaximumPower:
          type: number
          description: Total maximum power in watts across all refill points
          example: 150000
        numberOfRefillPoints:
          type: number
          description: Number of refill points (connectors)
          example: 2
        lastUpdated:
          type: string
          description: Timestamp this station was last updated (ISO 8601)
          example: '2025-06-15T12:00:00.000Z'
        serviceType:
          type: array
          items:
            $ref: '#/components/schemas/DatexServiceType'
        refillPoint:
          type: array
          items:
            $ref: '#/components/schemas/DatexRefillPoint'
      required:
        - idG
        - versionG
        - totalMaximumPower
        - numberOfRefillPoints
        - serviceType
        - refillPoint
    DatexMultilingualStringValue:
      type: object
      properties:
        lang:
          type: string
          description: ISO 639-1 language code
          example: en
        value:
          type: string
          description: Text value in the given language
          example: Spirii
      required:
        - lang
        - value
    DatexLocAreaLocation:
      type: object
      properties:
        coordinatesForDisplay:
          $ref: '#/components/schemas/PointCoordinates'
        locLocationExtensionG:
          $ref: '#/components/schemas/DatexLocLocationExtension'
      required:
        - coordinatesForDisplay
    DatexInlineOrganisation:
      type: object
      properties:
        name:
          description: Organisation name
          allOf:
            - $ref: '#/components/schemas/DatexMultilingualString'
      required:
        - name
    DatexReferenceableOrganisationWithUnits:
      type: object
      properties:
        idG:
          type: string
          description: Unique identifier
          example: helpdesk-42
        versionG:
          type: string
          description: Version
          example: '1'
        name:
          description: Organisation name
          allOf:
            - $ref: '#/components/schemas/DatexMultilingualString'
        organisationUnit:
          type: array
          items:
            $ref: '#/components/schemas/DatexOrganisationUnit'
      required:
        - idG
        - versionG
        - name
    DatexOperatingHoursSpecification:
      type: object
      properties:
        idG:
          type: string
          description: Unique identifier
          example: hours-42
        versionG:
          type: string
          description: Version
          example: '1'
        overallPeriod:
          $ref: '#/components/schemas/DatexOverallPeriod'
      required:
        - idG
        - versionG
        - overallPeriod
    DatexServiceType:
      type: object
      properties:
        serviceType:
          description: Service type (e.g. unattended)
          allOf:
            - $ref: '#/components/schemas/DatexEnumValue'
      required:
        - serviceType
    DatexRefillPoint:
      type: object
      properties:
        aegiElectricChargingPoint:
          $ref: '#/components/schemas/DatexElectricChargingPoint'
      required:
        - aegiElectricChargingPoint
    PointCoordinates:
      type: object
      properties:
        latitude:
          type: number
          description: WGS84 latitude
          example: 55.676
        longitude:
          type: number
          description: WGS84 longitude
          example: 12.568
      required:
        - latitude
        - longitude
    DatexLocLocationExtension:
      type: object
      properties:
        FacilityLocation:
          $ref: '#/components/schemas/DatexFacilityLocation'
    DatexOrganisationUnit:
      type: object
      properties:
        contactInformation:
          type: array
          items:
            $ref: '#/components/schemas/DatexAfacContactInformation'
      required:
        - contactInformation
    DatexOverallPeriod:
      type: object
      properties:
        overallStartTime:
          type: string
          description: Start time of the overall period (ISO 8601)
          example: '2025-01-01T00:00:00.000Z'
        validPeriod:
          type: array
          items:
            $ref: '#/components/schemas/DatexValidPeriod'
      required:
        - overallStartTime
        - validPeriod
    DatexElectricChargingPoint:
      type: object
      properties:
        idG:
          type: string
          description: Unique identifier
          example: cp-12345-1
        versionG:
          type: string
          description: Version
          example: '1'
        externalIdentifier:
          type: array
          items:
            $ref: '#/components/schemas/DatexExternalIdentifier'
        deliveryUnit:
          description: Unit of energy delivery
          allOf:
            - $ref: '#/components/schemas/DatexEnumValue'
        currentType:
          description: AC or DC current type
          allOf:
            - $ref: '#/components/schemas/DatexEnumValue'
        connector:
          type: array
          items:
            $ref: '#/components/schemas/DatexConnector'
        electricEnergy:
          description: Energy rate definitions for this charging point
          type: array
          items:
            $ref: '#/components/schemas/DatexElectricEnergy'
      required:
        - idG
        - versionG
        - externalIdentifier
        - deliveryUnit
        - currentType
        - connector
    DatexFacilityLocation:
      type: object
      properties:
        address:
          $ref: '#/components/schemas/DatexAddress'
    DatexAfacContactInformation:
      type: object
      properties:
        afacContactInformation:
          $ref: '#/components/schemas/DatexContactInformation'
      required:
        - afacContactInformation
    DatexValidPeriod:
      type: object
      properties:
        recurringDayWeekMonthPeriod:
          type: array
          items:
            $ref: '#/components/schemas/DatexRecurringDayWeekMonthPeriod'
        recurringTimePeriodOfDay:
          type: array
          items:
            $ref: '#/components/schemas/DatexRecurringTimePeriodOfDay'
      required:
        - recurringDayWeekMonthPeriod
        - recurringTimePeriodOfDay
    DatexExternalIdentifier:
      type: object
      properties:
        identifier:
          type: string
          description: External identifier value
          example: DK*SPR*E001
        typeOfIdentifier:
          description: Type of external identifier
          allOf:
            - $ref: '#/components/schemas/DatexEnumValue'
      required:
        - identifier
        - typeOfIdentifier
    DatexConnector:
      type: object
      properties:
        connectorType:
          description: Type of connector (DATEX II enum)
          allOf:
            - $ref: '#/components/schemas/DatexEnumValue'
        connectorFormat:
          description: Connector format (cable/socket)
          allOf:
            - $ref: '#/components/schemas/DatexEnumValue'
        maxPowerAtSocket:
          type: number
          description: Maximum power at socket in watts
          example: 22000
        voltage:
          type: number
          description: Voltage in volts
          example: 400
        maximumCurrent:
          type: number
          description: Maximum current in amps
          example: 32
      required:
        - connectorType
        - maxPowerAtSocket
    DatexElectricEnergy:
      type: object
      properties:
        energyRate:
          description: Energy rate definitions for this charging point
          type: array
          items:
            $ref: '#/components/schemas/DatexEnergyRate'
    DatexAddress:
      type: object
      properties:
        postcode:
          type: string
          description: Postal/zip code
          example: '2200'
        city:
          description: City name
          allOf:
            - $ref: '#/components/schemas/DatexMultilingualString'
        countryCode:
          type: string
          description: ISO 3166-1 alpha-2 country code
          example: DK
        addressLine:
          type: array
          items:
            $ref: '#/components/schemas/DatexAddressLine'
    DatexContactInformation:
      type: object
      properties:
        telephoneNumber:
          type: string
          description: Telephone number
          example: '+4512345678'
      required:
        - telephoneNumber
    DatexRecurringDayWeekMonthPeriod:
      type: object
      properties:
        comDayWeekMonth:
          $ref: '#/components/schemas/DatexComDayWeekMonth'
      required:
        - comDayWeekMonth
    DatexRecurringTimePeriodOfDay:
      type: object
      properties:
        startTimeOfPeriod:
          type: string
          description: Start time (HH:mm)
          example: '08:00'
        endTimeOfPeriod:
          type: string
          description: End time (HH:mm)
          example: '20:00'
      required:
        - startTimeOfPeriod
        - endTimeOfPeriod
    DatexEnergyRate:
      type: object
      properties:
        idG:
          type: string
          description: Unique identifier for this energy rate
          example: energy-rate-abc123
        ratePolicy:
          description: 'Rate policy: contract-based or ad-hoc'
          example:
            value: adHoc
          allOf:
            - $ref: '#/components/schemas/DatexEnumValue'
        lastUpdated:
          type: string
          description: Timestamp this rate was last updated (ISO 8601)
          example: '2025-06-15T12:00:00.000Z'
        applicableCurrency:
          description: ISO 4217 currency codes applicable for this rate
          example:
            - DKK
          type: array
          items:
            type: string
        energyPrice:
          description: Price breakdown for this rate
          type: array
          items:
            $ref: '#/components/schemas/DatexEnergyPrice'
      required:
        - idG
        - ratePolicy
        - lastUpdated
        - applicableCurrency
    DatexAddressLine:
      type: object
      properties:
        order:
          type: number
          description: Display order of this line
          example: 0
        type:
          description: Type of address line (e.g. street, houseNumber)
          allOf:
            - $ref: '#/components/schemas/DatexEnumValue'
        text:
          description: Address line text
          allOf:
            - $ref: '#/components/schemas/DatexMultilingualString'
      required:
        - order
        - type
        - text
    DatexComDayWeekMonth:
      type: object
      properties:
        applicableDay:
          description: Applicable days of the week
          type: array
          items:
            $ref: '#/components/schemas/DatexEnumValue'
      required:
        - applicableDay
    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

````