Haal je LinkedIn-campagnes op met per campagne hoeveel prospects erin zitten en hoe ver ze zijn. Handig voor een eigen overzicht of rapport naast de campagnes in de app.
GET https://leadforge.nl/api/v1/campaigns
Vraagt read
LinkedIn-campagnes van je werkruimte, nieuwste eerst.
Parameters
Geen. De lijst heeft geen paginering en geen filters, en geeft hoogstens 100 campagnes: de nieuwste. Alleen LinkedIn-campagnes komen mee.
Antwoord
Velden
| Naam | Type | Beschrijving |
|---|---|---|
| id | tekst (uuid) | Het id van de campagne. |
| name | tekst | De naam van de campagne. |
| status | tekst | active (actief), paused (gepauzeerd), draft (concept) of completed (afgerond). |
| dryRun | boolean | Of de campagne in testmodus draait. |
| reviewBeforeSend | boolean | Of berichten eerst goedgekeurd moeten worden voordat ze uitgaan. |
| createdAt | datum (ISO) | Wanneer de campagne is aangemaakt. |
| enrollments | object | Het aantal inschrijvingen per status. Zie hieronder. |
enrollments
Een inschrijving is één prospect in een campagne. enrollments telt de inschrijvingen per status, met deze sleutels:
| Sleutel | Betekenis |
|---|---|
active | Actief |
paused | Gepauzeerd |
completed | Afgerond |
replied | Beantwoord |
bounced | Gebounced |
Een status zonder inschrijvingen ontbreekt in het object; tel hem als 0. Een campagne zonder inschrijvingen heeft {}.
Voorbeeld
curl https://leadforge.nl/api/v1/campaigns \
-H "Authorization: Bearer LF_LIVE_SLEUTEL"
{
"data": [
{
"id": "<campagne-id>",
"name": "Marketingmanagers Utrecht",
"status": "active",
"dryRun": false,
"reviewBeforeSend": true,
"createdAt": "2026-10-20T09:00:00.000Z",
"enrollments": {
"active": 42,
"replied": 6,
"completed": 11
}
}
]
}
| Status | Code | Wanneer |
|---|---|---|
| 200 | De lijst met campagnes. Zonder campagnes is data een lege lijst. | |
| 401 | unauthorized | Geen geldige sleutel. |
| 403 | forbidden | De sleutel heeft geen read, of hoort niet bij één werkruimte. |
| 429 | rate_limited | Meer dan 120 verzoeken per minuut. |