> ## Documentation Index > Fetch the complete documentation index at: https://chargecloud.dev/llms.txt > Use this file to discover all available pages before exploring further. # Sensors / List > Lists parking sensors owned by the authenticated client. Optionally filter by chargepoint. Required permission: asset:sensors:list. Available contexts: API Key, User. ## OpenAPI ````yaml /api/core-api/crmiapi.json get /api/v1/assets/sensors 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/sensors: get: tags: - Sensors summary: Sensors / List description: >- Lists parking sensors owned by the authenticated client. Optionally filter by chargepoint. Required permission: asset:sensors:list. Available contexts: API Key, User. operationId: /api/v1/assets/sensors_GET parameters: - name: chargepoint_uuid in: query description: >- Restricts the list to the parking sensors linked to this charge point. The charge point 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 parking sensors linked to this charge point. The charge point 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: - sensors properties: sensors: 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 parking sensor, automatically assigned by the system upon creation. Use this UUID to retrieve or reference the sensor in subsequent API calls. modification_date: type: string description: >- Last modification timestamp, maintained by the database. last_status_changed_at: type: string format: date-time pattern: >- ^\d{4}-\d{2}-\d{2}T\d{2}:\d{2}:\d{2}(Z|[+-]\d{2}:\d{2})$ description: Timestamp when last_status last changed (RFC 3339). last_status: type: string enum: - Available - Occupied - Parked - Unavailable - Unknown description: >- Most recent occupancy status reported by the sensor. Allowed values: Available (spot free), Occupied (vehicle charging), Parked (vehicle blocks the spot without charging), Unavailable (sensor or spot out of service), Unknown (no valid status yet). example: Occupied name: type: string maxLength: 255 description: Human-readable label of the sensor. example: Sensor Bay 3 interface_name: type: string maxLength: 255 description: >- Name of the external interface delivering sensor data, identifying which partner system or sensor provider is the source of the status updates. ext_id: type: string maxLength: 255 description: >- Identifier of the sensor in the upstream system or hardware vendor. chargepoint_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 charge point this sensor is assigned to. Each chargepoint can have at most one parking sensor. required: - uuid - chargepoint_uuid description: >- The parking sensor record with its charge point assignment and last reported status. description: Sensors in this page. Empty when no sensors match. 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 parking-sensor collection. '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:sensors components: securitySchemes: bearer: type: http description: OAuth2 Bearer Authorization scheme: bearer bearerFormat: JWT ```` ## Related topics - [Sensors / Delete](https://chargecloud.dev/api-reference/sensors/sensors-delete.md) - [Sensors / Read](https://chargecloud.dev/api-reference/sensors/sensors-read.md) - [Sensors / Update](https://chargecloud.dev/api-reference/sensors/sensors-update.md) This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.