---
title: "List projects for an account"
method: GET
path: "/demand/accounts/{account_id}/projects"
tags: ["Projects"]
---

# List projects for an account

`GET /demand/accounts/{account_id}/projects`

## Request

- Base URL: `https://api.cint.com/v1`
- URL: `https://api.cint.com/v1/demand/accounts/{account_id}/projects`
- Auth: HTTP bearer
- TypeScript: <https://skmtc.dev/cint/apis/demand-api/docs/demand/accounts/:account_id/projects/get.ts> (a function with typed inputs; its response is checked against the schema)

This endpoint returns a paginated list of projects for a specific account.
The response includes summary details for each project, such as its name, last activity, and key statistics.

## Query parameters

- `project_manager_id` string, uuid: A unique identifier for the user.
- `status` 'active' | 'inactive': The status of the project.
- `name` string
- `search_string` string
- `end_before` string
- `start_after` string
- `page_size` integer

## Response `200`

Returns a paginated list of projects.

- ProjectsList: Paginated list of Projects.
  - `projects` ProjectListItem[], required: Array of Project list items, representing the results of the query.
    - `id` string, required: A unique identifier for the project in ULID format.
    - `human_readable_id` string: The project's human-readable ID. This ID is unique within the scope of an account.
    - `account_id` integer, required: The account's unique identifier.
    - `project_customer_reference_number` string: A customer-provided reference number assigned to the project.
    - `name` string, required: The name of the project.
    - `highlighted_name` string: The name of the project, with parts that matched the search string being highlighted between HTML emphasis tags. If there was no search string, or the search string matched this project based on the identifier (and not based on the name), this property will be omitted.
    - `target_group_human_readable_ids` TargetGroupHumanReadableID[]: If the search string matched one or more of the ID's of target groups contained within the project, those target groups will be listed here. If no such matches were found, this property will be omitted.
    - `target_group_count` integer, required: The total number of target groups in this project.
    - `status` 'active' | 'inactive', required: The status of the project.
    - `last_activity_at` string, date-time, required: The timestamp of the last activity on the project, in ISO 8601 format.
    - `statistics` ProjectStatistics, required: An object containing key performance statistics for a project.
      - `filling_goal` integer, required: The filling goal indicates the desired total number of completes across all target groups within the project.
      - `current_completes` integer, required: Current number of completes for the target groups within the project.
      - `current_prescreens` integer, required: Current number of prescreens for the target groups within the project.
      - `incidence_rate_median` number, float, required: Current median incidence rate of the target groups within the project.
      - `length_of_interview_median_seconds` integer, required: Current median length of interview of the target groups within the project in seconds.
      - `conversion_rate_average` number, float, required: Current average conversion rate of the target groups within the project.
      - `drop_off_rate_average` number, float, required: Current average drop-off rate of the target groups within the project.
    - `target_group_customer_reference_numbers` TargetGroupCustomerReferenceNumber[]: If the search string matched one or more of the customer reference numbers of target groups contained within the project, those target groups will be listed here. If no such matches were found, this property will be omitted.
  - `url` string, required: URL which produced this list (without query parameters).
  - `has_more` boolean, required: If `true`, there are more results to fetch by providing the `next_cursor` in a subsequent request. If `false`, you are on the last page of results.
  - `next_cursor` string, nullable: An identifier for pagination that indicates there are more items available. When present, use this value to retrieve the next page of results.

## Other responses

- `400`: A request is not valid and can't be processed.
- `401`: A request is unauthorized.
- `403`: A requested is forbidden.
- `404`: A requested resource isn't found.
- `500`: A request failed due to an internal error.

---

[API](https://skmtc.dev/cint/apis/demand-api.md) - [All operations](https://skmtc.dev/cint/apis/demand-api/llms.txt) - [OpenAPI document](https://skmtc.dev/cint/apis/demand-api/revisions/077a4bdda5cb?raw)