> ## 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 / Read

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



## OpenAPI

````yaml /api/core-api/crmiapi.json get /api/v1/assets/sensors/{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/sensors/{uuid}:
    get:
      tags:
        - Sensors
      summary: Sensors / Read
      description: >-
        Retrieves details for a sensor. Required permission: asset:sensors:read.
        Available contexts: API Key, User.
      operationId: /api/v1/assets/sensors/{uuid}_GET
      parameters:
        - name: uuid
          in: path
          description: UUID of the Sensor
          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 Sensor
        - 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:
                  - sensor
                properties:
                  sensor:
                    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: Single parking sensor.
        '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 / Create](https://chargecloud.dev/api-reference/sensors/sensors-create.md)
- [Sensors / Update](https://chargecloud.dev/api-reference/sensors/sensors-update.md)
- [Sensors / List](https://chargecloud.dev/api-reference/sensors/sensors-list.md)


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