Open Archives API » Stats/Records

Beware: this is the documentation of the 1.1 version of this method which uses archive_code (not archive) for archive code. The old version 1.0 is still available, see the 1.0 documentation.

Shows statistics about the records.

URL

https://api.openarch.nl/1.1/stats/records.json

Method

GET

Input

Name	Required	Description	Default
archive_code	No	Code of archive (obtain a list of valid archive codes via Stats/Archives)
callback	No	Function name to be called on JSON data (JSONP).

Output

If no archive is specified, all archives are shown with the total number of records.

Example: https://api.openarch.nl/1.1/stats/records.json outputs (pretty-printed):

[
  {
    "archive_code": "ins",
    "archive": "L'Institut national de la statistique et des études économiques (INSEE)",
    "count": 25146359
  },
  {
    "archive_code": "saa",
    "archive": "Stadsarchief Amsterdam",
    "count": 23309640
  },
  {
    "archive_code": "bhi",
    "archive": "Brabants Historisch Informatie Centrum",
    "count": 22058684
  },
  {
    "archive_code": "frl",
    "archive": "AlleFriezen",
    "count": 16790615
  },
  ...
]

If a archive code is specified, all source types available for that archive are shown with the totel number of records.

Example: https://api.openarch.nl/1.1/stats/records.json?archive_code=elo outputs:

[
  {
    "archive_code": "elo",
    "archive": "Erfgoed Leiden en omstreken",
    "count": 6980046,
    "sourcetypes": [
      {
        "sourcetype": "DTB Dopen",
        "count": 1945558
      },
      {
        "sourcetype": "BS Overlijden",
        "count": 1166676
      },
      {
        "sourcetype": "BS Geboorte",
        "count": 980350
      },
      {
        "sourcetype": "Notariële archieven",
        "count": 744365
      },
      {
        "sourcetype": "BS Huwelijk",
        "count": 644931
      },
      {
        "sourcetype": "DTB Trouwen",
        "count": 533074
      },
      {
        "sourcetype": "Bevolkingsregister",
        "count": 298903
      },
      {
        "sourcetype": "DTB Begraven",
        "count": 294009
      },
      {
        "sourcetype": "Bonboek",
        "count": 196420
      },
      {
        "sourcetype": "Militieregisters",
        "count": 110112
      },
      {
        "sourcetype": "Poorterboeken",
        "count": 57399
      },
      {
        "sourcetype": "Borgbrieven",
        "count": 4203
      },
      {
        "sourcetype": "Wees- en armboeken register",
        "count": 4045
      },
      {
        "sourcetype": "Oud Rechterlijke register",
        "count": 1
      }
    ]
  }
]

Errors

One of the following errors may be thrown:

Error code	Error message
1	Invalid archive

An example error looks (pretty-printed) like:

{
	"error_code": 1,
	"error_description": "Invalid archive"
}

Back to API documentation