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

# Je eerste API-aanroep doen

> Doe je eerste API-aanroep en vraag je lijsten op, direct op deze site of vanaf je eigen computer.

De snelste manier om te zien of alles werkt, is het opvragen van je lijsten. Die aanroep verandert niets aan je account en geeft meteen antwoord. Je kunt deze aanroep hier op de site doen of vanaf je eigen computer.

## Aanroep doen via deze site

#### Maak een API-sleutel aan

Maak in je account een sleutel aan onder ‘Koppelingen’. Een nieuwe sleutel is maar één keer zichtbaar, dus bewaar hem meteen. Zie: [API-sleutel aanmaken](/hoe-kom-ik-aan-een-api-sleutel).

#### Open het endpoint

Ga naar [Alle lijsten opvragen](/lijsten/alle-lijsten-opvragen).

#### Vul je sleutel in en verstuur

Klik rechts bij het codevoorbeeld op ‘Try it’ en vul je sleutel in bij ‘api_key’. Klik daarna op versturen. Meer over dit veld en deze knop lees je bij [API uitproberen met Try it](/api-uitproberen).

#### Lees het antwoord

Je krijgt een `200`-antwoord met al je lijsten in `data`. Het `list_id` dat je daar ziet, heb je bij bijna elke andere aanroep nodig.

> **Warning**
>
> Je doet hiermee een echte aanroep. Hoe je veilig test, staat bij [API uitproberen met Try it](/api-uitproberen).

## Aanroep doen vanaf je eigen systeem

Hoe je je sleutel meestuurt, lees je bij [Authenticatie met je API-sleutel](/api-authenticatie).

**`curl`**

```bash title="curl"
curl https://api.laposta.nl/v2/list \
  -u JOUW_API_SLEUTEL:
```

Met de PHP-bibliotheek is dat:

**`PHP`**

```php title="PHP"
$laposta = new Laposta('JOUW_API_SLEUTEL');
$lijsten = $laposta->listApi()->all();
```

Een antwoord ziet er zo uit, ingekort tot één lijst:

```json
{
  "data": [
    {
      "list": {
        "list_id": "BaImMu3JZA",
        "name": "Nieuwsbrief",
        "state": "active",
        "members": { "active": 1232, "unsubscribed": 113, "cleaned": 14 }
      }
    }
  ]
}
```

## Een relatie toevoegen

De aanroep die je daarna waarschijnlijk nodig hebt, is het toevoegen van een relatie. Naast het e-mailadres is het IP-adres verplicht, want daarmee leg je vast waar de aanmelding vandaan kwam.

**`curl`**

```bash title="curl"
curl https://api.laposta.nl/v2/member \
  -u JOUW_API_SLEUTEL: \
  -d list_id=BaImMu3JZA \
  -d ip=198.51.100.10 \
  -d email=nieuwe.relatie@example.net \
  -d custom_fields[voornaam]=Sanne
```

**`PHP`**

```php title="PHP"
$laposta->memberApi()->create('BaImMu3JZA', [
    'ip' => '198.51.100.10',
    'email' => 'nieuwe.relatie@example.net',
    'custom_fields' => ['voornaam' => 'Sanne'],
]);
```

De sleutels binnen `custom_fields` zijn de `custom_name` van je eigen velden. Die kun je eenmalig ophalen met [Alle velden opvragen](/velden/alle-velden-opvragen) en in je eigen code bewaren.

## Gerelateerde artikelen

#### [Hoe werkt authenticatie met je API-sleutel?](/api-authenticatie)

De API gebruikt basic auth, met je sleutel als gebruikersnaam en een leeg wachtwoord.

#### [De API uitproberen met Try it](/api-uitproberen)

Verstuur vanuit je browser een echte aanroep naar de Laposta API, zonder iets te…

#### [Relaties synchroniseren via de API](/relaties-synchroniseren-via-de-api)

Houd je lijst gelijk aan je webshop of CRM: toevoegen, bijwerken, afmelden en fouten…