Quickstart

Get your API key and company ID

Generate an API key in In-Motion Online under Configuratie → Integraties → API Keys, and grab your companyid from any In-Motion Online URL. See Authentication for details.

Check your connection

Call the Ping endpoint to confirm your API key works. It returns Pong.

$
curl https://app.inmotionsoftware.be/Lemmy_API_IS/rest/v1/Ping \
>
  -H "x-api-key: your-api-key"

A Pong response means your key is valid and you’re ready to make real requests. A 401 Unauthorized means the key is missing or invalid — see Authentication.

Make a request

Call the GetCustomerGroups endpoint with your API key and company ID. It’s a read-only request, so it’s a safe first call. Like every GET endpoint, it requires the x-page-offset and x-page-limit pagination headers.

$
curl https://app.inmotionsoftware.be/Lemmy_API_IS/rest/v1/GetCustomerGroups \
>
  -H "x-api-key: your-api-key" \
>
  -H "x-company-id: 1234" \
>
  -H "x-page-offset: 0" \
>
  -H "x-page-limit: 50"

Read the response

A successful request returns 200 OK and a JSON object containing your customer groups:

1
{
2
  "IsSuccess": true,
3
  "ErrorMessages": [],
4
  "Payload": [
5
    {
6
      "Code": "RETAIL",
7
      "Description": "Retail customers",
8
      "PaymentCondition": "30 days",
9
      "DeliveryCondition": "Standard",
10
      "Active": true
11
    }
12
  ]
13
}

If you get a 401 Unauthorized instead, double-check your API key and the x-company-id header — see Authentication.