ampr docs

Sockets

Connector/socket state and details

GET /chargers/{charger_id}/sockets List connectors for a charger

Parameters

Name In Type Required Description
charger_id path string required

Responses

200 Socket list

PropertyTypeRequiredDescription
dataarray<Socket>
PropertyTypeRequiredDescription
idstringrequired
connector_idintegerrequiredPhysical connector number on the charger (1, 2, etc.)
typeenum
  • Type1
  • Type2
  • CCS1
  • CCS2
  • CHAdeMO
  • Other
required
statusConnectorStatus
  • Available
  • Preparing
  • Charging
  • SuspendedEV
  • SuspendedEVSE
  • Finishing
  • Faulted
  • Unavailable
required
current_session_idstringnullable

401 Missing or invalid API key application/problem+json

PropertyTypeRequiredDescription
typestringformat: urirequired
titlestringrequired
statusintegerrequired
detailstringnullable
instancestringnullable

404 Resource not found application/problem+json

PropertyTypeRequiredDescription
typestringformat: urirequired
titlestringrequired
statusintegerrequired
detailstringnullable
instancestringnullable

Request example

curl -X GET "https://api.ampr.dev/v1/chargers/chg_example/sockets" \
  -H "Authorization: Bearer $AMPR_API_KEY"
Note
This endpoint requires an API key. Send it as a Bearer token in the Authorization header.

GET /chargers/{charger_id}/sockets/{socket_id} Get connector detail with live state

Parameters

Name In Type Required Description
charger_id path string required
socket_id path string required

Responses

200 Socket detail

PropertyTypeRequiredDescription
dataSocket
PropertyTypeRequiredDescription
idstringrequired
connector_idintegerrequiredPhysical connector number on the charger (1, 2, etc.)
typeenum
  • Type1
  • Type2
  • CCS1
  • CCS2
  • CHAdeMO
  • Other
required
statusConnectorStatus
  • Available
  • Preparing
  • Charging
  • SuspendedEV
  • SuspendedEVSE
  • Finishing
  • Faulted
  • Unavailable
required
current_session_idstringnullable

401 Missing or invalid API key application/problem+json

PropertyTypeRequiredDescription
typestringformat: urirequired
titlestringrequired
statusintegerrequired
detailstringnullable
instancestringnullable

404 Resource not found application/problem+json

PropertyTypeRequiredDescription
typestringformat: urirequired
titlestringrequired
statusintegerrequired
detailstringnullable
instancestringnullable

Request example

curl -X GET "https://api.ampr.dev/v1/chargers/chg_example/sockets/skt_example" \
  -H "Authorization: Bearer $AMPR_API_KEY"
Note
This endpoint requires an API key. Send it as a Bearer token in the Authorization header.