Open Archieven

Basisadres

https://api.openarchieven.nl/1.1

Endpoints 14

• GET/records/search.jsonZoeken op naam (ook twee namen met & en een jaar of periode); filters op archief, brontype, plaats, geboorteplaats, rol en land. Totaal in response.number_found.
• GET/records/show.jsonEén record volgens het A2A-model (archive + identifier). Ook als .xml, .gedcom, .ttl en .nt door de extensie te veranderen.
• GET/records/match.jsonEen persoon (naam + geboortejaar) koppelen aan geboorte- en overlijdensakten.
• GET/records/getBirths.json, /getDeaths.json, /getMarriages.jsonGeboorte-, overlijdens- en huwelijksakten op naam, jaar en plaats.
• GET/stats/archives.jsonAlle archieven met archive_code, ISIL-code, naam en website.
• GET/stats/records.jsonAantal records per archief en per brontype binnen dat archief (archive_code= voor één archief).
• GET/stats/sources.json, /stats/events.json, /stats/comments.jsonAantallen per brontype, per gebeurtenis en opmerkingen. Gaven op 16 okt 2026 een lege lijst.
• GET/stats/breakdown.jsonKruistabel: tellen per archief, brontype, gebeurtenis, plaats of jaar (1500 tot 1960) met filters. Gaf op 16 okt 2026 HTTP 503 (error_code 52).
• GET/stats/familynames.json, /stats/firstnames.json, /stats/professions.jsonMeest voorkomende achternamen, voornamen en beroepen voor een plaats en periode.
• GET/related/weather.jsonHistorisch KNMI-weer op een datum en plek (waarden in tienden, met uitleg per veld).
• GET/related/census.jsonNederlandse volkstellingsgegevens voor een plaats en jaar.
• GET/transcriptions/search.json, /browse.json, /show.jsonVolledige tekst van getranscribeerde pagina's doorzoeken, bladeren per archief en inventaris, één transcriptie ophalen.
• GEThttps://sparql.openarchieven.nl/{oa-a2a|oa-pico|oa-pico-recon}Drie SPARQL-endpoints (QLever): records (A2A), persoonsvermeldingen volgens PiCo, en gereconstrueerde personen.
• GEThttps://api.openarchieven.nl/oai-pmh/?verb=…OAI-PMH 2.0, formaat oai_a2a, 115 sets (één per archief), datums als YYYY-MM-DD.

Filteren uit de beschrijving

Losse queryparameters per endpoint (name, archive_code, sourcetype, eventplace …). Voor vragen over verbanden en tellingen over alles: SPARQL op sparql.openarchieven.nl.

Parameters 13

Velden in de antwoorden (selectie) 11

Limieten en valkuilen

• 4 verzoeken per seconde per IP-adres (OpenAPI-beschrijving); meer kan in overleg. uit de beschrijving
• Zoeken: max 100 per pagina en offset tot 10.000 (daarboven HTTP 400, error_code 50). Voor alles: OAI-PMH of de bestandsexports. getest
• SPARQL: zware vragen (GROUP BY over alle triples van oa-a2a of oa-pico) gaven na 30 seconden HTTP 502 (proxy). Een LIMIT-vraag of een vraag op één onderwerp antwoordt binnen een seconde. getest
• stats/sources.json gaf op 16 okt 2026 na 10 seconden een lege lijst, stats/breakdown.json HTTP 503 met error_code 52 ('Service temporarily unavailable'). stats/records.json werkte en telt per archief én per brontype. getest
• Fouten komen als JSON met error_code en error_description; de HTTP-status klopt (400, 503). getest
• API-versie 1.1 gebruikt archive_code; oudere voorbeelden met archive= werken niet voor search.json. uit de beschrijving
• Records zijn geen personen: één persoon staat in veel akten. Gereconstrueerde personen staan in oa-pico-recon (schema:spouse, parent, children, sibling). getest
• Er is ook een MCP-server (mcp.openarchieven.nl) en OpenSearch-beschrijvingen per taal. uit de beschrijving

Probeer het HTTP 200 · 397 ms · 16 okt

https://api.openarchieven.nl/1.1/records/search.json?name=Huizinga&eventplace=Groningen&number_show=3&lang=nl

{
  "query": {
    "eventplace": "Groningen",
    "name": "Huizinga",
    "only_results_with_scans": false,
    "start": 0,
    "number_show": 3,
    "sort": 1,
    "language": "nl"
  },
  "response": {
    "number_found": 5891,
    "docs": [
      {
        "pid": "Person1",
        "identifier": "182dc2c2-3c73-4103-a6bf-1eedb05dc8b1",
        "archive_code": "gra",
        "archive_org": "AlleGroningers",
        "archive": "AlleGroningers",
        "personname": "A. Huizinga",
        "relationtype": "Geregistreerde",
        "_relationtype": "Geregistreerde",
        "eventtype": "Registratie",
        "_eventtype": "Registratie",
        "eventplace": [
          "Groningen"
        ],
        "sourcetype": "Inschrijving gevangene",
        "url": "https://www.openarchieven.nl/gra:182dc2c2-3c73-4103-a6bf-1eedb05dc8b1"
      },
      {
        "pid": "Person1",
        "identifier": "AA10953C-AAB1-41D9-9365-C608085BD972",
        "archive_code": "gra",
        "archive_org": "AlleGroningers",
        "archive": "AlleGroningers",
        "personname": "A. Huizinga",
        "relationtype": "Geregistreerde",
        "_relationtype": "Geregistreerde",
        "eventtype": "Registratie",

Ingekort antwoord, opgeslagen bij het oogsten. Klik op het adres voor het echte, actuele antwoord.