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

# Retrieves operator IDs

> Retrieves the operator IDs available for the authenticated client. The returned `id` can be used directly as `operator_id` when creating a location via POST /api/v1/assets/locations. Required permission: asset:operators:list



## OpenAPI

````yaml /api/core-api/crmiapi.json get /api/v1/assets/operators
openapi: 3.1.1
info:
  title: chargecloud - Core API
  summary: chargecloud Core API. All around CRM, Asset Management and more.
  version: 1.125.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/operators:
    get:
      tags:
        - Operators
      summary: Retrieves operator IDs
      description: >-
        Retrieves the operator IDs available for the authenticated client. The
        returned `id` can be used directly as `operator_id` when creating a
        location via POST /api/v1/assets/locations. Required permission:
        asset:operators:list
      operationId: /api/v1/assets/operators_GET
      responses:
        '200':
          content:
            application/json:
              schema:
                type: object
                required:
                  - operators
                properties:
                  operators:
                    type: array
                    items:
                      type: object
                      properties:
                        id:
                          type: integer
                          format: int32
                          description: >-
                            The unique internal identifier of the operator-ID
                            relation. Use this value directly as `operator_id`
                            when creating a location via POST
                            /api/v1/assets/locations.
                        operator_id_code:
                          type: string
                          maxLength: 3
                          description: >-
                            The three-character operator ID code as defined by
                            the OCPI/OCHP roaming standards (e.g. "CHC").
                          example: CHC
                        name:
                          type: string
                          maxLength: 100
                          description: >-
                            The name of the operator. Useful for display and
                            disambiguation when multiple tenants share the same
                            code.
                      required:
                        - id
                        - operator_id_code
                        - name
                      description: Operator
                    description: Operators
          description: Operator collection
        '401':
          content:
            application/json:
              schema:
                type: object
                required:
                  - error
                properties:
                  error:
                    type: string
                    description: Error message
          description: Unauthorized
        '403':
          content:
            application/json:
              schema:
                type: object
                required:
                  - error
                properties:
                  error:
                    type: string
                    description: Error message
          description: Forbidden
        '404':
          content:
            application/json:
              schema:
                type: object
                required:
                  - error
                properties:
                  error:
                    type: string
                    description: Error message
          description: Not found
        '405':
          content:
            application/json:
              schema:
                type: object
                required:
                  - error
                properties:
                  error:
                    type: string
                    description: Error message
          description: Method not allowed
        '422':
          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
        '429':
          content:
            application/json:
              schema:
                type: object
                required:
                  - error
                properties:
                  error:
                    type: string
                    description: Error message
          description: Too many requests
      security:
        - bearer:
            - asset:operators
components:
  securitySchemes:
    bearer:
      type: http
      description: OAuth2 Bearer Authorization
      scheme: bearer
      bearerFormat: JWT

````

## Related topics

- [Asset management](/asset-management.md)
- [Retrieves controllers](/api-reference/controllers/retrieves-controllers.md)
- [Retrieves details of a controller](/api-reference/controllers/retrieves-details-of-a-controller.md)