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

# PlugTypes / List

> Reference list of supported plug types and their default electrical parameters. Required permission: asset:plug_types:list. Available contexts: API Key, User.



## OpenAPI

````yaml /api/core-api/crmiapi.json get /api/v1/assets/plug-types
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/plug-types:
    get:
      tags:
        - PlugTypes
      summary: PlugTypes / List
      description: >-
        Reference list of supported plug types and their default electrical
        parameters. Required permission: asset:plug_types:list. Available
        contexts: API Key, User.
      operationId: /api/v1/assets/plug-types_GET
      parameters:
        - 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:
                  - plug_types
                properties:
                  plug_types:
                    type: array
                    items:
                      type: object
                      properties:
                        id:
                          type: integer
                          format: int32
                          description: >-
                            Numeric identifier of the plug type. Used as type_id
                            when creating or updating a plug.
                        name:
                          type: string
                          maxLength: 100
                          description: >-
                            Display name of the plug type (e.g. "Type 2", "CCS",
                            "CHAdeMO").
                        standard:
                          type: string
                          maxLength: 100
                          description: >-
                            Connector standard identifier used in roaming
                            protocols (e.g. OCPI).
                        oicp:
                          type: string
                          maxLength: 100
                          description: OICP plug type code used for Hubject roaming.
                        default_ampere:
                          type: integer
                          format: int32
                          minimum: 0
                          description: Default current rating in amperes.
                        default_voltage:
                          type: integer
                          format: int32
                          minimum: 0
                          description: Default nominal voltage in volts.
                        default_phase:
                          type: string
                          enum:
                            - ac1
                            - ac3
                            - dc
                          description: >-
                            Default electrical phase wiring. Allowed values: ac1
                            (single-phase AC), ac3 (three-phase AC), dc (direct
                            current / fast charging).
                        default_max_power:
                          type: number
                          format: float
                          minimum: 0
                          description: Default maximum charging power in watts.
                        default_fixable:
                          type: boolean
                          default: false
                          description: >-
                            Default value for the plug's "fixable" flag
                            (mechanical locking).
                        default_with_cable:
                          type: boolean
                          default: false
                          description: >-
                            Default value for the plug's "with_cable" flag. True
                            for tethered connectors, false for sockets.
                        default_cable_length:
                          type: integer
                          format: int32
                          minimum: 0
                          description: >-
                            Default cable length in centimeters for tethered
                            plugs.
                      required:
                        - id
                        - name
                        - standard
                        - oicp
                        - default_ampere
                        - default_voltage
                        - default_phase
                        - default_max_power
                        - default_fixable
                        - default_with_cable
                        - default_cable_length
                      description: PlugType
                    description: All supported plug types.
          description: Plug type 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
        '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
      security:
        - bearer:
            - asset:plug_types
components:
  securitySchemes:
    bearer:
      type: http
      description: OAuth2 Bearer Authorization
      scheme: bearer
      bearerFormat: JWT

````

## Related topics

- [Plugs / List](https://chargecloud.dev/api-reference/plugs/plugs-list.md)
- [Plugs / Update](https://chargecloud.dev/api-reference/plugs/plugs-update.md)
- [Plugs / Create](https://chargecloud.dev/api-reference/plugs/plugs-create.md)


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