---
title: "First name frequency statistics for a given place and year"
method: GET
path: "/stats/firstnames.json"
tags: ["Stats"]
---

# First name frequency statistics for a given place and year

`GET /stats/firstnames.json`

## Request

- Base URL: `https://api.openarchieven.nl/1.1`
- URL: `https://api.openarchieven.nl/1.1/stats/firstnames.json`
- Auth: none declared

Returns the top-X list of first names in the specified place and year. When a person has multiple forenames, only the first is counted. Currently only Amsterdam is available as a place.

## Query parameters

- `eventplace` string, required
- `eventyear` integer, required
- `number_show` integer
- `callback` string

## Response `200`

Request echo and map of first name to occurrence count

- FirstNamesResponse: Response for the FirstNames statistics endpoint.
  - `request` object
    - `eventplace` string
    - `eventyear` integer
    - `number_show` integer
  - `response` object
    - `firstnames` object: Map of first name to occurrence count.

## Other responses

- `400`: Invalid parameters
- `429`: Too Many Requests — rate limit of 4 requests per second per IP exceeded.

---

[API](https://skmtc.dev/openarchieven/apis/open-archives-api.md) · [All operations](https://skmtc.dev/openarchieven/apis/open-archives-api/llms.txt) · [OpenAPI document](https://skmtc.dev/openarchieven/apis/open-archives-api/revisions/4ff4685dd9e9?raw)