Start a charge

Description#

This endpoint is used to initiate a remote charge.

If you want to know more about the remote charge workflow, take a look to this guide.

Request format#

Method: POST

Endpoint: https://dev.api.thor.tools/latest/integration/charges/start

Body format: JSON

Key	Type	Description
chargebox	String	The unique chargebox identifier.
connector	Integer	The connector where you want to start the charge.

Request schema:

{
    "$schema": "http://json-schema.org/draft-04/schema",
    "id": "http://example.com/example.json",
    "type": "object",
    "title": "The root schema",
    "description": "The root schema comprises the entire JSON document.",
    "default": {},
    "required": [
        "chargebox",
        "connector",
    ],
    "properties": {
        "chargebox": {
            "id": "http://example.com/properties/chargebox",
            "type": "string",
            "title": "The chargebox schema",
            "description": "The chargebox identifier.",
            "default": ""
        },
        "connector": {
            "id": "http://example.com/properties/connector",
            "type": "integer",
            "title": "The connector schema",
            "description": "The connector where you want to start the transaction.",
            "default": 0
        },
    },
    "additionalProperties": true
}

Response format#

The response is a JSON containing the following fields:

Field name	Type	Description
id_tag	String	The identifier that the chargebox must use to start a transaction.

A succesful response is returned with an HTTP status code 200 - OK

Example response#

{
    "id_tag": "173e7b23d0egv0yjtc4q"
}

Error response#

The following errors are returned if something went wrong while processing the request:

HTTP status code	Message	Description
400	ConnectorNotValid	The connector value is lesser than or equal to zero or is greater than the number of connectors that the chargebox has.
400	AlreadyInTransaction	The given connector of the given chargebox is already involved in a transaction.
402	ChargeboxNotFree	Chargebox has a custom payment type that is not Free or you have set a global non Free payment type for the car/bicycle chargeboxes.
403	APIKeyNotFound	An invalid API key was given in the header of the request.
403	RestAPINotEnabled	REST API integration is set as disabled in the administration dashboard.
403	InvalidSourceIPAddr	The request comes from an IP address that is different from the one given in the REST API integration configuration.
403	ChargeboxNotActive	Chargebox is not set as active in the administration dashboard.
404	ChargeboxNotFound	No chargebox with the give identifier was found.
429	TooManyRequests	Too many start charge requests on the given chargebox and connector.
500	InternalServerError	Something unexpected went wrong while executing the request.