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

# Parking / List

> Lists the parking spots visible to the authenticated client. Required permission: asset:parkings:list. Available contexts: API Key, User.



## OpenAPI

````yaml /api/core-api/crmiapi.json get /api/v1/assets/parking
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/parking:
    get:
      tags:
        - Parking
      summary: Parking / List
      description: >-
        Lists the parking spots visible to the authenticated client. Required
        permission: asset:parkings:list. Available contexts: API Key, User.
      operationId: /api/v1/assets/parking_GET
      parameters:
        - name: location_uuid
          in: query
          description: >-
            Restricts the list to the parking spots 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 parking spots 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:
                  - parking
                properties:
                  parking:
                    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: >-
                            Stable UUID of the parking spot, generated on
                            creation and used as the public identifier for
                            cross-system referencing and AFIR-compliant
                            transmission to national access points (NAP).
                        created_at:
                          type: string
                          format: date
                          pattern: ^\d{4}-\d{2}-\d{2}$
                          description: Date the parking spot was created.
                        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).
                        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 parking space belongs
                            to. Parking spaces are always assigned to a location
                            and are managed within that location's
                            infrastructure.
                        physical_reference:
                          type: string
                          maxLength: 12
                          description: >-
                            Physical reference / signage label (e.g. bay number
                            "A-12").
                          example: A-03
                        max_vehicle_weight_kg:
                          type: integer
                          format: int32
                          minimum: 0
                          description: >-
                            Maximum allowed vehicle weight in kilograms.
                            Required for AFIR compliance and transmitted to the
                            national access point (NAP).
                        max_vehicle_height_cm:
                          type: integer
                          format: int32
                          minimum: 0
                          description: >-
                            Maximum allowed vehicle height in centimetres.
                            Particularly relevant for covered or underground
                            parking. Required for AFIR compliance and
                            transmitted to the national access point (NAP).
                        max_vehicle_length_cm:
                          type: integer
                          format: int32
                          minimum: 0
                          description: >-
                            Maximum allowed vehicle length in centimetres.
                            Required for AFIR compliance and transmitted to the
                            national access point (NAP).
                        max_vehicle_width_cm:
                          type: integer
                          format: int32
                          minimum: 0
                          description: >-
                            Maximum allowed vehicle width in centimetres.
                            Required for AFIR compliance and transmitted to the
                            national access point (NAP).
                        dangerous_goods_allowed:
                          type: boolean
                          default: false
                          description: >-
                            Whether vehicles transporting dangerous goods (ADR)
                            are allowed.
                        drive_through:
                          type: boolean
                          default: false
                          description: >-
                            Whether the bay is a drive-through position, where a
                            vehicle can pull in, charge, and drive out without
                            reversing. Must apply to all vehicle types assigned
                            to this spot.
                        restricted_to_type:
                          type: boolean
                          default: false
                          description: >-
                            Whether the parking spot is restricted to the
                            vehicle types listed in vehicle_type.
                        reservation_required:
                          type: boolean
                          default: false
                          description: Whether drivers must reserve the bay before parking.
                        time_limit_minutes:
                          type: integer
                          format: int32
                          description: >-
                            Maximum allowed parking duration in minutes. When
                            set, drivers must vacate the spot after this limit,
                            regardless of whether charging is still in progress.
                        roofed:
                          type: boolean
                          default: false
                          description: >-
                            Whether the parking spot is covered by a roof /
                            canopy.
                        lighting:
                          type: boolean
                          default: false
                          description: Whether the parking spot is illuminated at night.
                        vehicle_type:
                          type: array
                          items:
                            type: object
                            properties:
                              vehicle_type:
                                type: string
                                description: >-
                                  Name of a parking vehicle type permitted on
                                  this parking spot.
                          description: >-
                            Vehicle types permitted on this parking spot.
                            Combined with restricted_to_type to enforce the
                            restriction. Required for AFIR compliance and used
                            to filter parking spots by vehicle category in
                            public outputs.
                        parking_direction:
                          type: string
                          enum:
                            - PARALLEL
                            - PERPENDICULAR
                            - ANGLE
                          description: >-
                            Orientation of the parking spot relative to the
                            charging station, helping drivers position the
                            vehicle correctly when pulling in to charge. Allowed
                            values: PARALLEL (parallel to the station),
                            PERPENDICULAR (at a right angle), ANGLE (angled).
                        chargepoints:
                          type: array
                          items:
                            type: object
                            properties:
                              chargepoints:
                                type: string
                                maxLength: 36
                                description: >-
                                  UUID of a charging point associated with the
                                  parking spot.
                            required:
                              - chargepoints
                          description: >-
                            UUIDs of the charging points associated with this
                            parking spot. A spot may be linked to one or more
                            charging points at the same location, and appears
                            subordinated to the connector in the infrastructure
                            overview.
                      required:
                        - uuid
                        - created_at
                        - modification_date
                        - location_uuid
                        - physical_reference
                        - max_vehicle_weight_kg
                        - max_vehicle_height_cm
                        - max_vehicle_length_cm
                        - max_vehicle_width_cm
                        - parking_direction
                      description: >-
                        The parking spot record with its location, vehicle
                        restrictions and charge points.
                    description: The parking spots 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 parking spots.
        '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:parkings
components:
  securitySchemes:
    bearer:
      type: http
      description: OAuth2 Bearer Authorization
      scheme: bearer
      bearerFormat: JWT

````

## Related topics

- [Sensors / List](https://chargecloud.dev/api-reference/sensors/sensors-list.md)
- [Parking / Delete](https://chargecloud.dev/api-reference/parking/parking-delete.md)
- [Facility Types / List](https://chargecloud.dev/api-reference/facility-types/facility-types-list.md)


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