---
title: "Get counts for given contribution type and sitting date range."
method: GET
path: "/timeline-stats.{format}"
tags: ["TimelineStats"]
---

# Get counts for given contribution type and sitting date range.

`GET /timeline-stats.{format}`

Get counts for given contribution type and sitting date range.
Counts are by given TimelineGroupingSize (Day, Month or Year), house, contribution type,
search term, optional memberid and whether this is a debates search
<br /><br /><br />
The search term can be simple text or it can contain directives for advanced searches.<br />
you can also connect multiple search directives with AND<br />
use spokenby:name to count times when named person spoke<br />
use debate:debate to count debates matching supplied text<br />
use words:words to count occurrences of specified words<br />

## Path parameters

- `format` string, required

## Query parameters

- `contributionType` 'Spoken' | 'Written' | 'Corrections' | 'Petitions' | 'WrittenAnswers' | 'Divisions'
- `isDebatesSearch` boolean
- `queryParameters.house` string
- `queryParameters.startDate` string, date-time
- `queryParameters.endDate` string, date-time
- `queryParameters.date` string
- `queryParameters.memberId` integer
- `queryParameters.divisionId` integer
- `queryParameters.hansardIdentifier` string
- `queryParameters.searchTerm` string
- `queryParameters.skip` integer
- `queryParameters.take` integer
- `queryParameters.memberIds` string
- `queryParameters.department` string
- `queryParameters.debateType` string
- `queryParameters.includeFormer` boolean
- `queryParameters.includeCurrent` boolean
- `queryParameters.withDivision` boolean
- `queryParameters.seriesNumber` integer
- `queryParameters.volumeNumber` integer
- `queryParameters.columnNumber` string
- `queryParameters.committeeTitle` string
- `queryParameters.committeeType` integer
- `queryParameters.includeCommitteeDivisions` boolean
- `queryParameters.section` integer
- `queryParameters.outputType` string
- `queryParameters.debateSectionId` integer
- `queryParameters.timelineGroupingSize` 'Day' | 'Month' | 'Year'
- `queryParameters.orderBy` 'SittingDateAsc' | 'SittingDateDesc'

## Response `200`

OK

- QueryResultTimelineDataItem
  - `Results` TimelineDataItem[]
    - `GroupingDate` string, date-time
    - `GroupingSize` integer
    - `Count` integer
  - `TotalResultCount` integer

---

[API](https://skmtc.net/parliament/apis/hansard-api.md) · [All operations](https://skmtc.net/parliament/apis/hansard-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/parliament/hansard-api/revisions/3b1458d7709c/schema)