---
title: "Returns the share of a benchmark's votes falling in each demographic bucket."
method: GET
path: "/benchmark/{benchmarkId}/demographics"
tags: ["Benchmark"]
---

# Returns the share of a benchmark's votes falling in each demographic bucket.

`GET /benchmark/{benchmarkId}/demographics`

The same vote-level filters as the standings query apply. Every dimension closes with an
 unknown bucket for votes with no recorded value, and its shares sum to 1. Benchmarks
 without granular votes return a zero-vote, empty-dimension response.

## Path parameters

- `benchmarkId` string, required

## Query parameters

- `country` object
  - `eq` string
  - `neq` string
  - `gt` string
  - `gte` string
  - `lt` string
  - `lte` string
  - `contains` string
  - `starts_with` string
  - `ends_with` string
  - `in` string[]
  - `not_contains` string
- `language` object
  - `eq` string
  - `neq` string
  - `gt` string
  - `gte` string
  - `lt` string
  - `lte` string
  - `contains` string
  - `starts_with` string
  - `ends_with` string
  - `in` string[]
  - `not_contains` string
- `gender` object
  - `eq` string
  - `neq` string
  - `gt` string
  - `gte` string
  - `lt` string
  - `lte` string
  - `contains` string
  - `starts_with` string
  - `ends_with` string
  - `in` string[]
  - `not_contains` string
- `age_bucket` object
  - `eq` string
  - `neq` string
  - `gt` string
  - `gte` string
  - `lt` string
  - `lte` string
  - `contains` string
  - `starts_with` string
  - `ends_with` string
  - `in` string[]
  - `not_contains` string
- `occupation` object
  - `eq` string
  - `neq` string
  - `gt` string
  - `gte` string
  - `lt` string
  - `lte` string
  - `contains` string
  - `starts_with` string
  - `ends_with` string
  - `in` string[]
  - `not_contains` string
- `tags` object
  - `eq` string
  - `neq` string
  - `gt` string
  - `gte` string
  - `lt` string
  - `lte` string
  - `contains` string
  - `starts_with` string
  - `ends_with` string
  - `in` string[]
  - `not_contains` string
- `participant_id` object
  - `eq` string
  - `neq` string
  - `gt` string
  - `gte` string
  - `lt` string
  - `lte` string
  - `contains` string
  - `starts_with` string
  - `ends_with` string
  - `in` string[]
  - `not_contains` string
- `leaderboard_id` object
  - `eq` string
  - `neq` string
  - `gt` string
  - `gte` string
  - `lt` string
  - `lte` string
  - `contains` string
  - `starts_with` string
  - `ends_with` string
  - `in` string[]
  - `not_contains` string
- `run_id` object
  - `eq` string
  - `neq` string
  - `gt` string
  - `gte` string
  - `lt` string
  - `lte` string
  - `contains` string
  - `starts_with` string
  - `ends_with` string
  - `in` string[]
  - `not_contains` string
- `prompt_identifier` object
  - `eq` string
  - `neq` string
  - `gt` string
  - `gte` string
  - `lt` string
  - `lte` string
  - `contains` string
  - `starts_with` string
  - `ends_with` string
  - `in` string[]
  - `not_contains` string
- `voted_at` object
  - `eq` string
  - `neq` string
  - `gt` string
  - `gte` string
  - `lt` string
  - `lte` string
  - `contains` string
  - `starts_with` string
  - `ends_with` string
  - `in` string[]
  - `not_contains` string
- `logic` 'and' | 'or'

## Response `200`

OK

- GetBenchmarkDemographicsEndpointOutput — The demographic composition of a benchmark's votes.
  - `totalVotes` integer, required — The total votes behind the composition.
  - `dimensions` GetBenchmarkDemographicsEndpointOutputDimensionSet, required
    - `ageBucket` GetBenchmarkDemographicsEndpointOutputBucket[], required
      - `value` string, required
      - `votes` integer, required
      - `share` number, double, required
    - `gender` GetBenchmarkDemographicsEndpointOutputBucket[], required
      - `value` string, required
      - `votes` integer, required
      - `share` number, double, required
    - `occupation` GetBenchmarkDemographicsEndpointOutputBucket[], required
      - `value` string, required
      - `votes` integer, required
      - `share` number, double, required
    - `country` GetBenchmarkDemographicsEndpointOutputBucket[], required
      - `value` string, required
      - `votes` integer, required
      - `share` number, double, required
    - `language` GetBenchmarkDemographicsEndpointOutputBucket[], required
      - `value` string, required
      - `votes` integer, required
      - `share` number, double, required

## Other responses

- `400` — Bad Request
- `401` — Unauthenticated
- `403` — Forbidden

---

[API](https://skmtc.net/rapidata/apis/rapidata-api.md) · [All operations](https://skmtc.net/rapidata/apis/rapidata-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/rapidata/rapidata-api/versions/e42ec51c7b88/schema)