---
title: "Top entities by activity count"
method: GET
path: "/v1/entities/top"
tags: ["Reference"]
---

# Top entities by activity count

`GET /v1/entities/top`

## Request

- Base URL: `https://api.dapperglobal.com`
- URL: `https://api.dapperglobal.com/v1/entities/top`
- Auth: API key in header `X-API-Key`

Aggregated count of regulations/consultations per issuing entity, ranked descending — for 'most active entities'/'who issued the most regulations' type questions, without paging through raw rows and counting client-side.

`domain` selects which activity to count (`regulations` or `consultations`, required). `since`/`until` (YYYY-MM-DD) bound the window — e.g. the last 10 days. `country_code` is comma-separated; omit for all accessible countries.

⚠️ Not available for bills/news/schedules/votes/actors/interventions/transcripts — none of them carry an entity (or any other categorical field) to group by, so there's no structural 'top entity'/'top topic' for those domains; that still requires paging + client-side synthesis.

**Data sources:** reference catalogs derived from the official registries behind each domain — issuing entities from gazette attributions, commissions and parties from the congress rosters. These are internal lookup values (entity_id, commission_id, etc.), not citable documents themselves — cite the regulation/bill/actor record that uses them instead.

## Query parameters

- `domain` 'regulations' | 'consultations', required: Which domain's activity to count.
- `since` string, date, nullable: Count activity on or after this date (YYYY-MM-DD).
- `until` string, date, nullable: Count activity on or before this date (YYYY-MM-DD).
- `limit` integer: How many entities to return, ranked by activity in the window (1-50).
- `country_code` string, nullable: Comma-separated country codes, e.g. BR,CO,CL.
- `country_id` string, nullable: Deprecated alias: comma-separated numeric ids, e.g. 8,2,6.

## Response `200`

Successful response (real sample data)

- EntityCount[]
  - `dapper_url` string, nullable: This record's page in the Dapper platform (dapperglobal.com) — hand this to a person who wants the full detail. Use it as given; the routes are not derivable from the payload. `null` means the record has no page (see the field's per-domain notes), not that the link is missing. Distinct from `external_link`/`congress_records[].link`, which point at the original official document.
  - `country_code` string, nullable
  - `country_id` integer, nullable
  - `id` integer, required
  - `name` string, nullable
  - `long_name` string, nullable
  - `count` integer, required

## Other responses

- `422`: Validation Error

---

[API](https://skmtc.dev/dapperglobal/apis/dapper-political-intelligence-api.md) · [All operations](https://skmtc.dev/dapperglobal/apis/dapper-political-intelligence-api/llms.txt) · [OpenAPI document](https://skmtc.dev/dapperglobal/apis/dapper-political-intelligence-api/revisions/f34d9e6a2b0e?raw)