> ## Documentation Index > Fetch the complete documentation index at: https://chargecloud.dev/llms.txt > Use this file to discover all available pages before exploring further. # Plugs / List > Lists plugs owned by the authenticated client. Optionally filter by chargepoint. Required permission: asset:plugs:list. Available contexts: API Key, User. ## OpenAPI ````yaml /api/core-api/crmiapi.json get /api/v1/assets/plugs 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/plugs: get: tags: - Plugs summary: Plugs / List description: >- Lists plugs owned by the authenticated client. Optionally filter by chargepoint. Required permission: asset:plugs:list. Available contexts: API Key, User. operationId: /api/v1/assets/plugs_GET parameters: - name: chargepoint_uuid in: query description: >- Restricts the list to the plugs of 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 plugs of 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: - plugs properties: plugs: 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 plug, automatically assigned by the system upon creation. Use this UUID to retrieve or reference the plug in subsequent API calls. created_at: type: string format: date pattern: ^\d{4}-\d{2}-\d{2}$ description: Creation timestamp of the plug record. updated_at: type: string format: date pattern: ^\d{4}-\d{2}-\d{2}$ description: Last-write timestamp of the plug record. plug_type: type: object properties: id: type: integer format: int32 description: >- Internal numeric identifier of the plug type. Same value as plug.type_id. name: type: string maxLength: 50 description: >- Human-readable name of the plug type (e.g., "Type 2", "CCS Combo 2"). standard: type: string maxLength: 64 description: >- Standard identifier used by roaming protocols (OCHP / OCPI), e.g. "IEC_62196_T2", "Chademo", "MCS". required: - id - name description: PlugTypeReference 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 plug is physically attached to. Set at creation and cannot be changed via update. Each plug must always be linked to exactly one charge point. type_id: type: integer format: int32 minimum: 1 description: >- Identifier of the plug type (e.g. Type 2, CCS, CHAdeMO). Allowed values come from PlugTypes / List; unknown ids are rejected with a 422 response. An incorrect plug type may cause the connector to fail quality checks and be excluded from public outputs and roaming platforms. phase: type: string enum: - ac1 - ac3 - dc description: >- Electrical phase wiring. Allowed values: ac1 (single-phase AC), ac3 (three-phase AC), dc (direct current / fast charging). example: ac3 ampere: type: integer format: int32 minimum: 0 maximum: 9999 description: >- Maximum supported current in amperes. Displayed in the app and transmitted to roaming partners. Typical values: 16A (Schuko), 32A (Type 2), 200A (CHAdeMO), 600A (CCS2). voltage: type: integer format: int32 minimum: 0 maximum: 9999 description: >- Nominal voltage in volts. Displayed in the app and transmitted to roaming partners. Typical values: 230V (Type 1/Schuko), 400V (Type 2 AC), up to 1000V (DC fast charging). max_power: type: number format: float minimum: 0 description: >- The maximum charging power of this plug in kilowatts. One of the most important fields for end users, as drivers filter charge points by this value when searching for a suitable location. active: type: boolean default: true description: >- Whether the plug is in service. Inactive plugs are excluded from public visibility and roaming. fixable: type: boolean default: true description: >- Whether the plug can be mechanically locked during a session. with_cable: type: boolean default: false description: >- True for tethered plugs with a fixed cable, false for sockets. cable_length: type: integer format: int32 minimum: 0 description: >- Cable length in centimeters. Only meaningful when with_cable is true. comment: type: string maxLength: 255 description: >- Free-form internal note, visible only to back-office users. export: type: boolean default: false description: >- Whether the plug is advertised through outbound roaming and public APIs (OICP, OCPI). serial_number: type: string maxLength: 25 description: Hardware serial number of the plug. article_number: type: string maxLength: 25 description: Manufacturer article (model) number. required: - uuid - created_at - updated_at - plug_type - chargepoint_uuid - type_id - phase - ampere - voltage - max_power - active - fixable - with_cable - cable_length - export description: >- The plug record of a charge point with its plug type and electrical ratings. description: Plugs in this page. Empty when no plugs 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 plug 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:plugs components: securitySchemes: bearer: type: http description: OAuth2 Bearer Authorization scheme: bearer bearerFormat: JWT ```` ## Related topics - [PlugTypes / List](https://chargecloud.dev/api-reference/plugtypes/plugtypes-list.md) - [Plugs / Delete](https://chargecloud.dev/api-reference/plugs/plugs-delete.md) - [Plugs / Update](https://chargecloud.dev/api-reference/plugs/plugs-update.md) This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.