> For clean Markdown of any page, append .md to the page URL.
> For a complete documentation index, see https://api.lemmy.be/llms.txt.
> For AI client integration (Claude Code, Cursor, etc.), connect to the MCP server at https://api.lemmy.be/_mcp/server.

# Quickstart

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.

#### 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](/authentication) for details.

#### Check your connection

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

```bash
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](/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](/pagination).

```bash
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:

```json
{
  "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](/authentication).

## Next steps

#### [Pagination](/pagination)

Learn how to page through large result sets — up to 50 records at a time.

#### [API Reference](/api-reference)

Browse every endpoint, with request parameters and response schemas.