> ## 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 / List > Lists the charging stations visible to the authenticated client. Optionally filter by controller_id and / or location_id. Required permission: asset:stations:list. Available contexts: API Key, User. ## OpenAPI ````yaml /api/core-api/crmiapi.json get /api/v1/assets/stations 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: get: tags: - Stations summary: Stations / List description: >- Lists the charging stations visible to the authenticated client. Optionally filter by controller_id and / or location_id. Required permission: asset:stations:list. Available contexts: API Key, User. operationId: /api/v1/assets/stations_GET parameters: - name: controller_uuid in: query description: >- Restricts the list to the stations connected to this controller. The controller must belong to the authenticated client; an unknown UUID returns 404. required: false 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: >- Restricts the list to the stations connected to this controller. The controller must belong to the authenticated client; an unknown UUID returns 404. - name: location_uuid in: query description: >- Restricts the list to the stations at this location. The location must belong to the authenticated client; an unknown UUID returns 404. required: false 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: >- Restricts the list to the stations at this location. The location must belong to the authenticated client; an unknown UUID returns 404. - name: limit in: query description: Maximum number of items per page. Maximum value is 25. required: false schema: type: integer format: int64 minimum: 1 maximum: 25 description: Maximum number of items per page. Maximum value is 25. example: '10' - name: page in: query description: Page number to retrieve (starting from 1). required: false schema: type: integer format: int64 minimum: 1 description: Page number to retrieve (starting from 1). example: '1' - 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: - stations properties: stations: type: array items: 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 stations in this page. pagination: type: object properties: page: type: integer format: int64 description: Current page number (starting from 1). example: '1' total_pages: type: integer format: int64 description: Total number of available pages. example: '5' page_size: type: integer format: int64 description: Number of items returned per page. example: '10' has_more: type: boolean default: true description: >- Indicates whether more pages are available after the current page. example: 'true' description: Pagination description: Paginated list of charging stations. '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 / List](https://chargecloud.dev/api-reference/meters/meters-list.md) - [Stations / Delete](https://chargecloud.dev/api-reference/stations/stations-delete.md) - [ChargePoints / List](https://chargecloud.dev/api-reference/chargepoints/chargepoints-list.md) This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.