---
title: "Find developers that made an action within the given timeframe."
method: POST
path: "/filter/contributors"
tags: ["filter", "default"]
---

# Find developers that made an action within the given timeframe.

`POST /filter/contributors`

## Request

- Base URL: `{{ server_url }}/v1`
- URL: `{{ server_url }}/v1/filter/contributors`
- Auth: one of:
  - HTTP bearer
  - API key in header `X-API-Key`
- TypeScript: <https://skmtc.dev/athenian/apis/title/docs/filter/contributors/post.ts> (a function with typed inputs; its response is checked against the schema)

## Request body

- FilterContributorsRequest: Filters for `/filter/contributors`.
  - `account` integer, required: Session account ID.
  - `date_from` string, date, required: Updates must be later than or equal to this date. An update is any action that influences the stage assignment.
  - `date_to` string, date, required: Updates must be earlier than or equal to this date. An update is any action that influences the stage assignment.
  - `timezone` integer: Local time zone offset in minutes, used to adjust `date_from` and `date_to`.
  - `in` RepositoryID[]: Set of repositories. An empty list raises a bad response 400. Duplicates are automatically ignored.
  - `as` string[]: Filter by contribution type. A `null` or an empty list select all.

## Response `200`

Repositories that were updated within the given timeframe.

- DeveloperSummary[]: List of developer activity statistics and profile details.
  - `login` string, required: Developer's login name.
  - `name` string, nullable, required: Developer's full name.
  - `avatar` string, url, required: Developer's avatar URL.
  - `updates` DeveloperUpdates, required: Various developer contributions statistics over the specified time period. Note: any of these properties may be missing if there was no such activity.
    - `prs` integer: How many PRs authored by this developer updated. Note: this is not the same as the number of PRs this developer opened. Note: the update origin is not necessarily this developer.
    - `reviewer` integer: How many reviews this developer submitted. Note: this is not the same as the number of unique PRs reviewed.
    - `commit_author` integer: How many commits this developer authored.
    - `commit_committer` integer: How many commits this developer pushed.
    - `commenter` integer: How many regular PR comments this developer left. Note: issues are not taken into account, only the PRs.
    - `releaser` integer: How many releases this developer created.
  - `jira_user` string: Mapped JIRA user name.

## Other responses

- `400`: The request is invalid.
- `403`: Calling user is not allowed to access the specified repositories.
- `404`: The specified account does not exist or the user is not a member.
- `422`: The account's installation has not finished yet.

---

[API](https://skmtc.dev/athenian/apis/title.md) - [All operations](https://skmtc.dev/athenian/apis/title/llms.txt) - [OpenAPI document](https://skmtc.dev/athenian/apis/title/revisions/110c9f7cffdd?raw)