Open Charge Map Comment API

The Comment API from Open Charge Map — 1 operation(s) for comment.

Documentation GitHub OpenAPI

Operations 1

POST /comment Submit Comment or Checkin #

Specifications

https://raw.githubusercontent.com/api-evangelist/openchargemap/refs/heads/main/openapi/openchargemap-comment-api-openapi.yml

Work with this as data

Every API here is available over the APIs.io API and to AI agents over MCP.

MCP server

One button, every client — Claude, Cursor, VS Code and the rest.

https://apis.io/mcp

Tools for apis

7 MCP tools reach this

find_apisBrowse and filter every API in the catalog.
get_api_artifactsOne API's artifacts, grouped by type.
get_openapiThe primary OpenAPI for this API.
find_similar_apisAPIs that look like this one.
apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.
resolveTurn a domain, URL or GitHub org into the provider it belongs to.
find_cohortsEvery scored population of providers in the catalog.

All 92 tools →

Call it yourself

curl for this page

This API

curl "https://apis.io/api/v1/apis/openchargemap-comment-api"

All apis

curl "https://apis.io/api/v1/apis?limit=25"

Discovery needs no key. Ratings and market analysis are Pro.

Get an API key

Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.

GitHub Google LinkedIn

A second provider on the same verified email joins the account you already have.

OpenAPI Specification

openapi: 3.2.0
info:
  title: Open Charge Map Comment API
  version: '3.1'
  termsOfService: https://openchargemap.org/site/about/terms
  contact:
    name: Contact
    url: https://openchargemap.org/site/about
  description: The Open Charge Map API provides access to the worlds largest registry of charging locations as Open Data.
servers:
- url: https://api.openchargemap.io/v3
  description: API Base URL
security:
- APIKeyQueryString: []
- APIKeyHeader: []
tags:
- name: Comment
paths:
  /comment:
    post:
      summary: Submit Comment or Checkin
      operationId: post-comment
      responses:
        '200':
          description: OK
          content:
            application/json:
              schema:
                description: ''
                type: object
                properties:
                  status:
                    type: string
                    minLength: 1
                  description:
                    type: string
                    minLength: 1
                required:
                - status
                - description
                x-examples:
                  example-1:
                    status: OK
                    description: OK
              examples:
                example-response:
                  value:
                    status: OK
                    description: OK
        '400':
          description: Bad Request
      description: Submit a user comment or checkin for a specific charging location
      security:
      - UserAuthentication: []
      requestBody:
        content:
          application/json:
            schema:
              description: ''
              type: object
              x-examples:
                example-1:
                  ChargePointID: 12345
                  CommentTypeID: 10
                  UserName: A. Nickname
                  Comment: This place is awesome, free cake for EV owners!
                  Rating: 5
                  RelatedURL: http://awesomevplace.com
                  CheckinStatusTypeID: 0
              properties:
                chargePointID:
                  type: integer
                  description: This must be a valid POI ID
                commentTypeID:
                  type: integer
                  description: This must be a valid Comment Type ID as per UserCommentTypes found in Core Reference Data. If left as null then General Comment will be used.
                userName:
                  type: string
                  minLength: 1
                  description: This is an optional name to associate with the submission, for authenticated users their profile username is used.
                  maxLength: 100
                comment:
                  type: string
                  minLength: 1
                  maxLength: 4000
                  description: This is an optional comment to describe the charging experience, may include guidance for future users.
                rating:
                  type: integer
                  example: 3
                  description: Optional integer rating between 1 = Worst, 5 = Best.
                relatedURL:
                  type: string
                  minLength: 1
                  description: Optional website URL for related information
                  maxLength: 500
                checkinStatusTypeID:
                  type: integer
                  description: Optional valid CheckStatusTypeID to indicate overall catgeory and success/failure to use equipment e.g. 10 = Charged Successfully.
              required:
              - chargePointID
            examples:
              example-1:
                value:
                  chargePointID: 0
                  commentTypeID: 0
                  userName: string
                  comment: string
                  rating: 3
                  relatedURL: string
                  checkinStatusTypeID: 0
      tags:
      - Comment
components:
  securitySchemes:
    APIKeyQueryString:
      name: key
      type: apiKey
      in: query
      description: API Key supplied as query string parameter
    APIKeyHeader:
      name: X-API-Key
      type: apiKey
      in: header
    UserAuthentication:
      type: http
      scheme: bearer