Skip to content
/Location

Epic-Charging Server Application Report API (v1)

Epic-Charging API

Welcome to the Epic-Charging API documentation. This API gives you full control over your EV charging infrastructure, allowing you to manage chargers, monitor sessions, and generate reports.

Getting Started

To use the Epic-Charging API, you'll need:

  • An API Key (see the Authentication section)
  • A basic understanding of the resources available through the API

Base URL

All API URLs referenced in this documentation are relative to:

https://{{tenant}}.epiccharging.com/api/external/v1/

Authentication

The Epic-Charging API uses API keys for authentication. Include your API key in all requests using the Token-Authorization header:

curl -X GET https://{{tenant}}.epiccharging.com/api/external/v1/charger/ \
  -H "Token-Authorization: your_api_key_here"

Your API key carries privileges, so keep it secure. Do not share it in publicly accessible areas such as GitHub, client-side code, or public forums.

Rate Limiting

API requests may be subject to rate limiting. If you exceed the rate limit, the API will respond with a 429 Too Many Requests status code.

Error Responses

The API uses standard HTTP response codes to indicate success or failure:

  • 2xx: Success
  • 4xx: Client errors (invalid request, unauthorized, etc.)
  • 5xx: Server errors

Error responses include a JSON body with details about the error.

Download OpenAPI description
index.json
index.yaml
Languages
Servers
Server

https://{tenant}.epiccharging.com/api/external/v1/

Charger Port

Charger Ports represent the individual connector points where vehicles can be connected for charging.

Use these endpoints to:

  • List all available charger ports across your network
  • Get detailed information about specific ports
  • Update port settings and configurations
  • Reserve ports for future use
  • Start and stop charging sessions
  • Cancel reservations

Each charger port belongs to a parent charger and can have different connector types (J1772, CCS, CHADEMO, etc.) and power capacities. Ports also maintain status information about current charging activities.

Operations

Charger

Chargers are the physical stations containing one or more charging ports.

These endpoints allow you to:

  • List all chargers in your network with their current statuses
  • Get detailed information about specific chargers
  • View power, connectivity, and location information
  • See all ports associated with a charger
  • Create bulk chargers

Chargers contain important metadata about locations, payment types, power capabilities, and operating temperatures. A single charger typically houses multiple charging ports.

Operations

Report

The reporting API provides comprehensive data and metrics about your charging network.

Use these endpoints to:

  • Get real-time status information for all chargers
  • Generate comprehensive charger reports
  • View detailed charging session history
  • Analyze fault data and error conditions
  • Track energy usage and transactions

These endpoints support filtering by date ranges, chargers, and other parameters to help you generate specific reports for business intelligence, maintenance planning, and usage analytics.

Operations

User

The User API allows you to manage and retrieve information about system users.

These endpoints enable you to:

  • List all users with access to your charging network
  • View user details including attached ID tags and accessible chargers
  • See authorization levels and access rights

User management is essential for controlling access to chargers and tracking usage patterns across your charging infrastructure.

Operations

Location

Locations represent physical places where chargers are installed.

Use these endpoints to:

  • Create multiple locations in a single operation
  • Manage location information including address, contact details, and coordinates
  • Associate chargers with specific locations

Locations provide important context for chargers and help with geographic organization of your charging infrastructure.

Operations

Create Multiple Locations

Request

Creates multiple locations in a single transaction. All locations must pass validation for the operation to succeed.

Security
BearerAuth
Bodyapplication/jsonrequired
locationsArray of objects(LocationCreate)required
locations[].​custom_idstringrequired

Custom identifier for the location

locations[].​formatted_addressstringrequired

Formatted address of the location

locations[].​company_namestring

Name of the company

locations[].​websitestring

Company website

locations[].​contact_namestring

Contact person name

locations[].​contact_phonestring

Contact phone number

locations[].​is_members_onlyboolean

Location Available only for tenants users

locations[].​contact_emailstring(email)

Contact email address

locations[].​locationArray of numbers

Geographic coordinates [latitude, longitude]

locations[].​places_api_dataobjectrequired
locations[].​places_api_data.​place_idstringrequired

Google Places API place ID

locations[].​places_api_data.​formatted_addressstringrequired

Formatted address from Places API

locations[].​places_api_data.​geometryobjectrequired
locations[].​places_api_data.​geometry.​locationobjectrequired
locations[].​places_api_data.​geometry.​location.​latnumberrequired

Latitude

locations[].​places_api_data.​geometry.​location.​lngnumberrequired

Longitude

locations[].​places_api_data.​address_componentsArray of objects
locations[].​places_api_data.​utc_offsetinteger

UTC offset in minutes

locations[].​connectivity_writeArray of objects
curl -i -X POST \
  https://demo.epiccharging.com/api/external/v1/locations \
  -H 'Content-Type: application/json' \
  -H 'Token-Authorization: YOUR_API_KEY_HERE' \
  -d '{
    "locations": [
      {
        "custom_id": "Location 1",
        "formatted_address": "123 Main Street, New York, NY 10001, USA",
        "company_name": "EV Charging Corp",
        "contact_name": "John Smith",
        "contact_email": "john.smith@example.com",
        "is_members_only": false,
        "places_api_data": {
          "place_id": "ChIJiZ6E4gyuEmsRCHbfpbXvAAU",
          "formatted_address": "123 Main Street, New York, NY 10001, USA",
          "geometry": {
            "location": {
              "lat": 40.7128,
              "lng": -74.006
            }
          },
          "address_components": [
            {
              "long_name": "123",
              "short_name": "123",
              "types": [
                "street_number"
              ]
            },
            {
              "long_name": "Main Street",
              "short_name": "Main St",
              "types": [
                "route"
              ]
            },
            {
              "long_name": "New York",
              "short_name": "NY",
              "types": [
                "locality",
                "political"
              ]
            }
          ],
          "utc_offset": -240
        }
      },
      {
        "custom_id": "Location 2",
        "formatted_address": "456 Oak Avenue, Los Angeles, CA 90001, USA",
        "company_name": "Green Energy Solutions",
        "contact_name": "Jane Doe",
        "contact_email": "jane.doe@example.com",
        "places_api_data": {
          "place_id": "ChIJK3cjPxWsEmsRAJxpbXvRAAM",
          "formatted_address": "456 Oak Avenue, Los Angeles, CA 90001, USA",
          "geometry": {
            "location": {
              "lat": 34.0522,
              "lng": -118.2437
            }
          },
          "address_components": [
            {
              "long_name": "456",
              "short_name": "456",
              "types": [
                "street_number"
              ]
            },
            {
              "long_name": "Oak Avenue",
              "short_name": "Oak Ave",
              "types": [
                "route"
              ]
            },
            {
              "long_name": "Los Angeles",
              "short_name": "LA",
              "types": [
                "locality",
                "political"
              ]
            }
          ],
          "utc_offset": -420
        }
      }
    ]
  }'

Responses

Created

Bodyapplication/json
locationsArray of objects(Location)
Response
application/json
{
  "locations": [
    { … }
  ]
}

Location-discounts

Operations
Terms
© 2025 Epic Charging.