JouloDocs

List MID charger models

Lists the charger models in the Joulo catalog that carry a MID meter, sorted by brand and model. Use the catalog_charger_id with POST /v1/chargers. Any valid CPO token may call this route, whatever its scopes.

GET
/v1/catalog/chargers
AuthorizationBearer <token>

OAuth 2.0 client credentials for a CPO client bound to one partner. Request a token with grant_type client_credentials and send client_id and client_secret in the body, as JSON or form data. The token endpoint does not accept HTTP Basic client authentication. The token lasts one hour and has no refresh token. Omit scope to get every scope your client holds. The /v1 routes refuse user tokens and personal API tokens.

In: header

Query Parameters

search?string

Case-insensitive substring match on brand or model. The server trims it, keeps the first 80 characters and replaces the characters % _ , ( ) with spaces.

limit?integer

Page size. A value above 200 becomes 200, and a negative value becomes 1. A missing, zero or non-numeric value uses 100.

Default100
Range1 <= value <= 200

Response Body

curl -X GET "https://api.joulo.nl/functions/v1/api/v1/catalog/chargers?search=string&limit=100"
{
  "models": [
    {
      "catalog_charger_id": "45aeec55-e46d-42b6-a990-2b5f65ab05a6",
      "brand": "string",
      "model": "string"
    }
  ],
  "count": 0
}
{
  "error": "Missing or invalid API token"
}
{
  "error": "cpo_token_required",
  "detail": "string",
  "required_scope": "string"
}
{
  "error": "Too many requests",
  "retry_after_seconds": 0
}
{
  "error": "catalog_lookup_failed",
  "detail": "string"
}
{
  "error": "string"
}