Skip to navigation

Quickstart

Make your first request and read live data from Lemmy
View as Markdown

This guide walks you through your first call to the Lemmy API — reading the list of customer groups from your company. It takes just a few minutes.

1

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.

2

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.

3

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"
4

Read the response

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

{
"IsSuccess": true,
"ErrorMessages": [],
"Payload": [
{
"Code": "RETAIL",
"Description": "Retail customers",
"PaymentCondition": "30 days",
"DeliveryCondition": "Standard",
"Active": true
}
]
}

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

Next steps