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

# Stations / Read

> Retrieves details for a station. Required permission: asset:stations:read. Available contexts: API Key, User.



## OpenAPI

````yaml /api/core-api/crmiapi.json get /api/v1/assets/stations/{uuid}
openapi: 3.2.0
info:
  title: chargecloud - Core API
  summary: chargecloud Core API. All around CRM, Asset Management and more.
  version: 1.141.0
  description: chargecloud Core API. All around CRM, Asset Management and more.
servers:
  - url: https://api.chargecloud.dev
    description: Production - chargecloud Core API
  - url: https://demo.chargecloud.de
    description: Sandbox/Dev - chargecloud Core API
security: []
paths:
  /api/v1/assets/stations/{uuid}:
    get:
      tags:
        - Stations
      summary: Stations / Read
      description: >-
        Retrieves details for a station. Required permission:
        asset:stations:read. Available contexts: API Key, User.
      operationId: /api/v1/assets/stations/{uuid}_GET
      parameters:
        - name: uuid
          in: path
          description: UUID of the Station
          required: true
          schema:
            type: string
            pattern: >-
              ^[a-f0-9]{8}\-[a-f0-9]{4}\-4[a-f0-9]{3}\-[89ab][a-f0-9]{3}\-[a-f0-9]{12}$
            description: UUID of the Station
        - name: Accept-Language
          in: header
          description: BCP 47 language tag for content negotiation (e.g. en, de-DE).
          required: false
          schema:
            type: string
            description: BCP 47 language tag for content negotiation (e.g. en, de-DE).
            example: en
      responses:
        '200':
          headers:
            Content-Language:
              description: The locale of the response content (BCP 47 language tag).
              required: false
              schema:
                type: string
                example: en
          content:
            application/json:
              schema:
                type: object
                required:
                  - station
                properties:
                  station:
                    type: object
                    properties:
                      uuid:
                        type: string
                        pattern: >-
                          ^[a-f0-9]{8}\-[a-f0-9]{4}\-4[a-f0-9]{3}\-[89ab][a-f0-9]{3}\-[a-f0-9]{12}$
                        description: >-
                          The unique identifier of the station, automatically
                          assigned by the system upon creation. Use this UUID to
                          retrieve or reference the station in subsequent API
                          calls.
                      created_at:
                        type: string
                        format: date
                        pattern: ^\d{4}-\d{2}-\d{2}$
                        description: >-
                          Date the station was first created. Set automatically
                          and cannot be modified.
                      updated_at:
                        type: string
                        format: date
                        pattern: ^\d{4}-\d{2}-\d{2}$
                        description: Date of the last user-driven update.
                      modification_date:
                        type: string
                        format: date
                        pattern: ^\d{4}-\d{2}-\d{2}$
                        description: >-
                          Date refreshed on every persisted change to the row
                          (YYYY-MM-DD).
                      chargepoints:
                        type: array
                        items:
                          type: object
                          properties:
                            chargepoint_evse_id:
                              type: string
                              description: >-
                                EVSE ID of a charging point (e.g.
                                "DE*ABC*E12345*1").
                          required:
                            - chargepoint_evse_id
                        description: >-
                          EVSE IDs of the charging points belonging to this
                          station.
                      location_uuid:
                        type: string
                        pattern: >-
                          ^[a-f0-9]{8}\-[a-f0-9]{4}\-4[a-f0-9]{3}\-[89ab][a-f0-9]{3}\-[a-f0-9]{12}$
                        description: >-
                          The UUID of the location this station belongs to. A
                          station must always be assigned to exactly one
                          location and cannot be reassigned after creation.
                      controller_uuid:
                        type: string
                        pattern: >-
                          ^[a-f0-9]{8}\-[a-f0-9]{4}\-4[a-f0-9]{3}\-[89ab][a-f0-9]{3}\-[a-f0-9]{12}$
                        description: >-
                          The UUID of the controller managing this station.
                          Links the station to the hardware device responsible
                          for OCPP communication with the backend.
                      export:
                        type: boolean
                        default: true
                        description: >-
                          Whether the station is included in interface outputs
                          such as the Whitelabel app and POI data (e.g. Google
                          Maps). Set to false to hide it from all public-facing
                          outputs. Defaults to true.
                      evse:
                        type: string
                        description: Evses of the chargepoints
                      charging_technology:
                        type: string
                        enum:
                          - inductive
                          - conductive
                        description: >-
                          Charging technology. Allowed values: conductive
                          (cable-based), inductive (wireless).
                      position:
                        type: string
                        maxLength: 100
                        description: >-
                          Physical position on the site (e.g. "Parking deck
                          level 2, bay 14").
                        example: parking bay 3
                      vehicle_type:
                        type: string
                        enum:
                          - ruralenergy
                          - omnibus
                          - four_wheeled
                          - two_wheeled
                        description: >-
                          Primary vehicle category. Allowed values: ruralenergy
                          (shore power), omnibus (buses), four_wheeled (cars),
                          two_wheeled (motorcycles, e-bikes).
                        example: four_wheeled
                      status:
                        type: string
                        enum:
                          - in_planning
                          - under_construction
                          - factory_acceptance_test
                          - demo
                          - active
                          - defect
                          - out_of_order
                          - removed
                          - undefined
                        description: >-
                          Current lifecycle state of the station. Allowed
                          values: in_planning, under_construction,
                          factory_acceptance_test, demo, active (in operation),
                          defect, out_of_order, removed (decommissioned),
                          undefined.
                      start_date:
                        type: string
                        format: date
                        pattern: ^\d{4}-\d{2}-\d{2}$
                        description: >-
                          Planned start or project kick-off date for the
                          station, used for internal planning and project
                          tracking.
                      target_date:
                        type: string
                        format: date
                        pattern: ^\d{4}-\d{2}-\d{2}$
                        description: >-
                          Target commissioning date by which the station should
                          be operational, used for installation scheduling.
                      active_date:
                        type: string
                        format: date
                        pattern: ^\d{4}-\d{2}-\d{2}$
                        description: >-
                          Date the station was officially put into operation.
                          Relevant for billing, reporting, and lifecycle
                          tracking.
                      out_of_order_date:
                        type: string
                        format: date
                        pattern: ^\d{4}-\d{2}-\d{2}$
                        description: Date the station was taken out of order.
                      ip_protection_type:
                        type: string
                        maxLength: 5
                        description: >-
                          IP rating of the enclosure (e.g. "IP54", "IP65"),
                          indicating resistance to dust and water ingress.
                      particularities:
                        type: string
                        maxLength: 64
                        description: >-
                          Remarks about hardware specifics or installation
                          peculiarities.
                      manufacturer:
                        type: string
                        maxLength: 100
                        description: Hardware manufacturer (e.g. ABB, Mennekes, Compleo).
                      model:
                        type: string
                        maxLength: 100
                        description: Hardware model name.
                      green_power:
                        type: boolean
                        default: false
                        description: >-
                          Whether the station is supplied with certified green
                          electricity. Transmitted to roaming partners and may
                          be shown in the app.
                      vehicle_communication_type_id:
                        type: integer
                        format: int32
                        description: >-
                          Identifies the vehicle-to-station communication
                          standard (e.g. ISO 15118, IEC 61851), used for
                          advanced features such as Plug & Charge.
                      serial_number:
                        type: integer
                        format: int32
                        description: Manufacturer-assigned serial number.
                      mounting_type:
                        type: string
                        enum:
                          - ''
                          - free_standing
                          - wall
                        description: >-
                          Physical mounting style. Allowed values: free_standing
                          (pole/pillar), wall (wallbox).
                        example: wall
                      sticker:
                        type: string
                        maxLength: 100
                        description: >-
                          Identifier printed on the physical sticker on the
                          station.
                      color:
                        type: string
                        maxLength: 50
                        description: Colour of the enclosure (e.g. "RAL 7016 anthracite").
                      automatic_rebootable_rccb:
                        type: boolean
                        default: false
                        description: >-
                          Whether the RCCB can be reset automatically by the
                          controller after a trip.
                      house_connection_box:
                        type: boolean
                        default: false
                        description: >-
                          Whether the station has a dedicated house connection
                          box (Hausanschlusskasten).
                      connection_cable:
                        type: string
                        maxLength: 100
                        description: >-
                          Connection cable specification (length, cross-section,
                          type).
                      closing:
                        type: string
                        maxLength: 200
                        description: Lock / closing mechanism (e.g. lock cylinder code).
                        example: padlock type
                      building_level:
                        type: string
                        maxLength: 20
                        description: >-
                          Building floor / level (e.g. "B1", "Ground", "Level
                          3").
                        example: UG1
                      parking_fees:
                        type: string
                        maxLength: 200
                        description: Parking fees that apply when using the station.
                      crash_protection:
                        type: boolean
                        default: false
                        description: >-
                          Whether crash protection (bollards, barriers) is
                          installed.
                      mark:
                        type: string
                        maxLength: 200
                        description: >-
                          Marking / labelling on the enclosure used for asset
                          tracking.
                      comment:
                        type: string
                        maxLength: 500
                        description: Comment shown to operators.
                      ceiling_height:
                        type: number
                        format: float
                        description: >-
                          Ceiling clearance above the station in metres.
                          Relevant for indoor installations with vehicle height
                          restrictions.
                      investment_manager:
                        type: string
                        maxLength: 64
                        description: >-
                          Person or department responsible for the capex /
                          investment side.
                      project:
                        type: string
                        maxLength: 64
                        description: Name of the rollout project the station belongs to.
                      order_number:
                        type: string
                        maxLength: 64
                        description: Purchase order number for the station hardware.
                      notification_number:
                        type: string
                        maxLength: 64
                        description: >-
                          Reference number used for official network operator
                          notifications.
                      internal_comment:
                        type: string
                        maxLength: 500
                        description: Internal comment. Not exported to public feeds.
                      upstream_supply_network:
                        type: string
                        maxLength: 32
                        description: >-
                          Identifies the upstream supply network feeding the
                          station (e.g. transformer / feeder).
                      protective_switching_devices:
                        type: string
                        maxLength: 64
                        description: >-
                          Protective switch devices (RCCBs, MCBs) in the supply
                          circuit.
                        example: circuit breakers
                      full_safeguarding:
                        type: number
                        format: float
                        description: Supply protection rating in amperes (Vorsicherung).
                      open_24_7:
                        type: boolean
                        default: false
                        description: >-
                          Whether the station is publicly accessible around the
                          clock. When false, specific opening hours should be
                          configured.
                      block_reservation:
                        type: boolean
                        default: false
                        description: >-
                          Whether the station is blocked from reservation
                          outside its opening hours. When true, the station
                          cannot be reserved during those periods.
                      article_number:
                        type: string
                        maxLength: 16
                        description: Manufacturer / supplier article number.
                      conform_with_calibration_law:
                        type: boolean
                        default: false
                        description: >-
                          Whether the station is compliant with the German
                          calibration law (Eichrecht). Required for legally
                          compliant billing and must reflect the actual hardware
                          certification status.
                      has_payment_terminal:
                        type: boolean
                        default: false
                        description: >-
                          Whether the station has an integrated payment terminal
                          for direct card or contactless payment, enabling
                          ad-hoc payment without app or RFID.
                      iso_instance:
                        type: string
                        maxLength: 64
                        description: >-
                          Identifies the ISO 15118 instance configured on the
                          station. Required for Plug & Charge and
                          vehicle-to-grid communication.
                      calibration_law_deadline:
                        type: string
                        format: date
                        pattern: ^\d{4}-\d{2}-\d{2}$
                        description: >-
                          Expiry date of the calibration-law certification.
                          After this date the station may not be used for
                          legally compliant billing until recertified.
                    required:
                      - uuid
                      - created_at
                      - updated_at
                      - modification_date
                      - chargepoints
                      - location_uuid
                      - controller_uuid
                    description: >-
                      The charging station record with its charge points,
                      location, controller and hardware data.
          description: The requested charging station.
        '401':
          headers:
            Content-Language:
              description: The locale of the response content (BCP 47 language tag).
              required: false
              schema:
                type: string
                example: en
          content:
            application/json:
              schema:
                type: object
                required:
                  - error
                properties:
                  error:
                    type: string
                    description: Error message
          description: Unauthorized
        '403':
          headers:
            Content-Language:
              description: The locale of the response content (BCP 47 language tag).
              required: false
              schema:
                type: string
                example: en
          content:
            application/json:
              schema:
                type: object
                required:
                  - error
                properties:
                  error:
                    type: string
                    description: Error message
          description: Forbidden
        '404':
          headers:
            Content-Language:
              description: The locale of the response content (BCP 47 language tag).
              required: false
              schema:
                type: string
                example: en
          content:
            application/json:
              schema:
                type: object
                required:
                  - error
                properties:
                  error:
                    type: string
                    description: Error message
          description: Not found
        '405':
          headers:
            Content-Language:
              description: The locale of the response content (BCP 47 language tag).
              required: false
              schema:
                type: string
                example: en
          content:
            application/json:
              schema:
                type: object
                required:
                  - error
                properties:
                  error:
                    type: string
                    description: Error message
          description: Method not allowed
        '422':
          headers:
            Content-Language:
              description: The locale of the response content (BCP 47 language tag).
              required: false
              schema:
                type: string
                example: en
          content:
            application/json:
              schema:
                type: object
                required:
                  - errors
                properties:
                  errors:
                    type: array
                    items:
                      type: object
                      properties:
                        errorKey:
                          type: string
                          description: A key identifying the error
                        message:
                          type: string
                          description: The error message
                        parameter:
                          type: string
                          description: The parameter that caused the error, if any
                      required:
                        - errorKey
                        - message
                        - parameter
                      description: Error
                    description: List of errors
          description: Request validation failed
      security:
        - bearer:
            - asset:stations
components:
  securitySchemes:
    bearer:
      type: http
      description: OAuth2 Bearer Authorization
      scheme: bearer
      bearerFormat: JWT

````

## Related topics

- [Meters / Read](https://chargecloud.dev/api-reference/meters/meters-read.md)
- [Parking / Read](https://chargecloud.dev/api-reference/parking/parking-read.md)
- [ChargePoints / Read](https://chargecloud.dev/api-reference/chargepoints/chargepoints-read.md)


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.