---
title: "Count bills by status, type, source or period"
method: GET
path: "/v1/bill-breakdown"
tags: ["Bills"]
---

# Count bills by status, type, source or period

`GET /v1/bill-breakdown`

## Request

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

How many bills fall in each bucket of one dimension, for any filter list_bills accepts. The answer to '¿cuántos se aprobaron?', '¿cuántos por tipo?', '¿cómo se reparten los del partido X?' — questions that otherwise mean paging every matching bill and tallying by hand (4,088 rows for one Colombian legislature, 50 at a time).

`by` is one of: `status` (where each bill currently stands — the latest tramitación's state), `type` (ley ordinaria, acto legislativo…), `source` (which body the record came from), `legislative_period`.

⚠️ `source` is where Dapper ingested the record, NOT the bill's constitutional origin. It does not reliably separate government bills from congressional ones; say so instead of inferring it.

`by=origin` is the one that does separate them, and only in Chile: Moción (congressional) vs Mensaje (government) is recorded for 100% of Chilean bills. The other eleven countries do not model it, so their bills land in the null bucket — a coverage gap, not 'origin unknown'.

Buckets with a null key are bills with no value recorded for that dimension — a coverage gap, not a category.

## Query parameters

- `by` 'status' | 'type' | 'source' | 'legislative_period' | 'origin': Dimension to group by: status | type | source | legislative_period | origin.
- `since` string, date, nullable: Bills filed on or after this date.
- `until` string, date, nullable: Bills filed on or before this date.
- `commission_id` integer, nullable: Only bills referred to this commission. Discover ids with list_commissions(country_code=...).
- `party_id` integer, nullable: Only bills with at least one author in this party.
- `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

- object

## 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)