Naar de inhoud
PARTYPPLDevelopers
EnglishNaar partyppl.nl

Referentie

Meta

De API over zichzelf: de specificatie en de voorwaarden. Zonder token.

The API describing itself.

De beschrijvingen van de endpoints komen uit de specificatie en zijn in het Engels.

GET/terms

Terms of use

Toegang
Geen token nodig
operationId
getTerms

What you agree to by using this API: attribution, what you may not redistribute, the limits and where the data comes from. Needs no token, so you can read it before you ask for one.

Voorbeeldverzoek

curl
curl -s "https://api.partyppl.nl/v1/terms"
JavaScript
const res = await fetch("https://api.partyppl.nl/v1/terms");
if (!res.ok) throw new Error((await res.json()).error.message);
const { data, meta } = await res.json();
Python
import os
import requests

res = requests.get(
    "https://api.partyppl.nl/v1/terms",
    timeout=30,
)
res.raise_for_status()
payload = res.json()
Toon het voorbeeldantwoord
200 · Voorbeeldantwoord
{
  "data": {
    "version": "2026-09-22",
    "attribution": {
      "text": "Event data from PartyPPL. Link back to the event page on partyppl.nl.",
      "url": "https://partyppl.nl",
      "terms": "https://api.partyppl.nl/v1/terms"
    },
    "rules": [
      "Credit PartyPPL wherever you show this data, with a link back to the event's page on partyppl.nl."
    ],
    "rate_limits": {
      "per_minute": 120,
      "per_day": 10000
    },
    "data_sources": "Organisers who publish with us, and the public agendas we import from.",
    "sources_url": "https://partyppl.nl/bronnen",
    "contact": "api@partyppl.nl",
    "provider": {
      "name": "PartyPPL",
      "chamber_of_commerce": "97359866",
      "vat": "NL005264805B67",
      "address": "Pater R.D. Kloegstraat 7, 5684 TK Best, the Netherlands"
    }
  },
  "meta": {
    "request_id": "9f1c2b4a-7e3d-4a10-9c2f-6b8d1e5a0c33",
    "attribution": {
      "text": "Event data from PartyPPL. Link back to the event page on partyppl.nl.",
      "url": "https://partyppl.nl",
      "terms": "https://api.partyppl.nl/v1/terms"
    }
  }
}

Statussen

  • 200Terms of use
  • 400The request is wrong. error.details.params names every bad parameter.
  • 500Something went wrong on our side. Quote request_id.

GET/openapi.json

The OpenAPI document

Toegang
Geen token nodig
operationId
getOpenApi

This API as OpenAPI 3.1, generated from the same declarations the router dispatches on. Needs no token. Not wrapped in the envelope: it is the specification itself.

Voorbeeldverzoek

curl
curl -s "https://api.partyppl.nl/v1/openapi.json"
JavaScript
const res = await fetch("https://api.partyppl.nl/v1/openapi.json");
if (!res.ok) throw new Error((await res.json()).error.message);
const { data, meta } = await res.json();
Python
import os
import requests

res = requests.get(
    "https://api.partyppl.nl/v1/openapi.json",
    timeout=30,
)
res.raise_for_status()
payload = res.json()
Toon het voorbeeldantwoord
200 · Voorbeeldantwoord
{
  "openapi": "3.1.0",
  "info": {
    "title": "PartyPPL API",
    "version": "1.0.0"
  }
}

Statussen

  • 200The OpenAPI document
  • 400The request is wrong. error.details.params names every bad parameter.
  • 500Something went wrong on our side. Quote request_id.

De specificatie als JSON