> ## Documentation Index > Fetch the complete documentation index at: https://chargecloud.dev/llms.txt > Use this file to discover all available pages before exploring further. # ChargePoints / List > Lists the charging points visible to the authenticated client. Optionally filter by station_id, controller_id, or location_id. Required permission: asset:chargepoints:list. Available contexts: API Key, User. ## OpenAPI ````yaml /api/core-api/crmiapi.json get /api/v1/assets/chargepoints 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/chargepoints: get: tags: - ChargePoints summary: ChargePoints / List description: >- Lists the charging points visible to the authenticated client. Optionally filter by station_id, controller_id, or location_id. Required permission: asset:chargepoints:list. Available contexts: API Key, User. operationId: /api/v1/assets/chargepoints_GET parameters: - name: evse_id in: query description: >- Restricts the list to the charge point carrying this EVSE ID. Separators are ignored, so DE*ABC*E1234, DE-ABC-E1234 and DEABCE1234 all resolve to the same charge point. required: false schema: type: string minLength: 3 maxLength: 100 description: >- Restricts the list to the charge point carrying this EVSE ID. Separators are ignored, so DE*ABC*E1234, DE-ABC-E1234 and DEABCE1234 all resolve to the same charge point. - name: station_uuid in: query description: >- Restricts the list to the charge points of this station. The station 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 charge points of this station. The station must belong to the authenticated client; an unknown UUID returns 404. - name: controller_uuid in: query description: >- Restricts the list to the charge points 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 charge points 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 charge points 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 charge points 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: - chargepoints properties: chargepoints: 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 charge point, automatically assigned by the system upon creation. Use this UUID to retrieve or reference the charge point in subsequent API calls. created_at: type: string format: date pattern: ^\d{4}-\d{2}-\d{2}$ description: >- Date the charging point was first created. Set automatically and cannot be modified. updated_at: type: string format: date pattern: ^\d{4}-\d{2}-\d{2}$ description: >- Date the charging point was last updated. Set automatically on every change. modification_date: type: string format: date pattern: ^\d{4}-\d{2}-\d{2}$ description: Date of the most recent modification. status_modified: type: string format: date pattern: ^\d{4}-\d{2}-\d{2}$ description: Date the status last changed. status: type: string enum: - Available - Reserved - Occupied - Faulted - Unavailable - Charging - Finishing - Preparing - SuspendedEV - SuspendedEVSE - Undefined description: >- Current operational state, set automatically from incoming OCPP messages reported by the controller. Allowed values: Available (ready), Preparing (session starting), Charging (energy flowing), SuspendedEV (vehicle not drawing), SuspendedEVSE (EVSE not delivering), Finishing (session terminating), Reserved, Occupied, Faulted, Unavailable, Undefined. evse: type: string maxLength: 50 description: >- Internal EVSE reference string used for cross-referencing within the chargecloud system. chargepoint_type: type: string enum: - internal - hubject - ochp - ocpi description: >- The integration type of this charge point, indicating whether it is managed internally or connected via a roaming protocol (internal, hubject, ochp, ocpi). 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 charge point belongs to. Cannot be changed 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 chargepoint. Must match the OCPP configuration on the physical device to ensure correct communication. Set at creation and cannot be changed via update. station_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 charging station this charge point is part of. Set at creation and cannot be changed via update. export: type: boolean default: true description: >- Controls whether this charging point is included in interface outputs such as the Whitelabel app and POI data. Set to false to hide it from all public-facing outputs. Defaults to true. evse_id: type: string maxLength: 100 description: >- Globally unique EVSE-ID following the format defined by the BDEW and exposed to roaming partners. Each EVSE-ID can only be assigned once. example: DE*CHC*E0001*0001 phase: type: string enum: - ac - dc description: >- Electrical phase type. Must match the hardware configuration and is used for power calculation, app display, and transmission to roaming partners. Allowed values: ac (alternating current), dc (direct current). example: ac position: type: string maxLength: 255 description: >- Free-text physical position on site, e.g. "left wall, slot 3". example: left connector parking_space_numbers: type: string maxLength: 20 description: >- Assigned parking space number(s), comma-separated for multiple values. Sequential numbering is recommended when multiple stations share a location and is required for Hectronic payment terminal integrations. reserved_parking: type: integer format: int64 minimum: 0 description: >- Number of parking spaces at this charging point that are reserved. A value of 0 means no spaces are reserved. access: type: string enum: - private - public - parapublic - carsharing - employee - homecharger - fleet description: >- Who may use the charging point. Public charging points must be reported to national access points as required by AFIR. Allowed values: private, public, parapublic (e.g. retail parking during opening hours), carsharing, employee, homecharger, fleet. example: fleet user: type: string maxLength: 100 description: >- Optional free-text label for the intended user group or operator responsible for this charging point (e.g. for home chargers). name: type: string maxLength: 100 description: >- Optional display name for identifying the charging point in the backend. Does not need to be unique. connector_id: type: integer format: int32 minimum: 0 description: >- OCPP connector ID identifying the connector in OCPP messages between the controller and the backend. example: '1' sms_id: type: integer format: int32 description: >- Optional ID for SMS-based charging session initiation. Required only when the charging point supports SMS as an access method. reservable: type: boolean default: false description: >- Whether the charging point can be reserved in advance via the app. Requires the station to support the OCPP reservation feature. Defaults to false. remote_stop_capable: type: boolean default: false description: >- Whether a charging session can be stopped remotely via the app or direct payment interface. Must be explicitly enabled per charging point. Defaults to false. in_roaming: type: boolean default: false description: >- Whether the charging point is enabled for roaming, making it accessible to drivers using third-party EMP apps via platforms such as Hubject, OCPI, or OCHP. The access type and roaming settings together determine visibility in roaming networks. Defaults to false. access_types: type: array items: type: object properties: access_type: type: string enum: - rfid - sms - key - free - app - other description: >- Authorization method accepted at this charge point. Allowed values: rfid (RFID card or token), sms (authorization via SMS), key (physical key), free (charging without authorization), app (mobile app), other (any method not listed). required: - access_type description: AccessType description: >- The access types that can be used to authorize a charging session at this charge point (rfid, sms, key, free, app, other). SMS is only available with the SMS module. adhoc_type: type: string enum: - free - none - standard description: >- How ad-hoc charging is offered. Allowed values: none (not offered), standard (paid), free. adhoc_sticker: type: boolean default: false description: >- Whether a physical ad-hoc payment sticker (QR / NFC) has been applied. Mandatory for publicly accessible charging points and must be ordered separately. Defaults to false. serial_number: type: integer format: int32 description: Hardware serial number from the manufacturer. article_number: type: integer format: int32 description: Manufacturer SKU identifying the model. parking_restrictions: type: string maxLength: 100 description: >- Free-text parking restrictions (e.g. customers only, max duration). Transmitted to roaming partners and displayed in the app where supported. unlock_capable: type: boolean default: false description: >- Whether the connector can be unlocked remotely via the backend, for example when a cable becomes stuck. Defaults to false. public_comment: type: string maxLength: 255 description: >- Public-facing comment displayed in the Whitelabel app and transmitted via web services (POI data). Use it for information relevant to end users, such as access instructions or local restrictions. required: - uuid - created_at - updated_at - modification_date - location_uuid - controller_uuid - station_uuid - evse_id - connector_id description: >- The charge point record with its EVSE ID, status, access settings and station assignment. description: The charging points in this page. Empty when no matches. 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 points visible to the authenticated client. '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:chargepoints components: securitySchemes: bearer: type: http description: OAuth2 Bearer Authorization scheme: bearer bearerFormat: JWT ```` ## Related topics - [ChargePoints / Delete](https://chargecloud.dev/api-reference/chargepoints/chargepoints-delete.md) - [ChargePoints / Health](https://chargecloud.dev/api-reference/chargepoints/chargepoints-health.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.