---
title: "Find 'Project' entities using the specified (query) parameters"
method: GET
path: "/project"
tags: ["Project"]
---

# Find 'Project' entities using the specified (query) parameters

`GET /project`

## Request

- Base URL: `https://app.testiny.io/api/v1`
- URL: `https://app.testiny.io/api/v1/project`
- Auth: API key in header `X-Api-Key`
- TypeScript: <https://skmtc.dev/testiny/apis/testiny-api/docs/project/get.ts> (a function with typed inputs; its response is checked against the schema)

Same as POST /find, but serializing the query in the 'q' parameter instead of the request body

## Query parameters

- `q` string

## Response `200`

Returns FindResult of type 'Project' expanded with specified mapped values

- object
  - `data` Project[], required
    - `id` integer: The unique entity id - must be a positive integer
    - `is_deleted` boolean: If the entity has been soft-deleted this value is true
    - `created_at` string, date-time: The creation time for this entity or mapping value
    - `created_by` number: The creator user id of this entity or mapping value - or zero if created by the system
    - `modified_at` string, date-time: The last modification time for this entity or mapping value
    - `modified_by` number: The id of the user who last modified or undeleted this entity or mapping value - or zero if modified by the system
    - `deleted_at` string, date-time: The soft-deletion time for this entity or mapping value
    - `deleted_by` number: The id of the user who deleted this entity or mapping value - or zero if deleted by the system
    - `_etag` string, required: A tag for detecting conflicting modifications - current value (may be empty) must be passed along in an update (or update must be forced)
    - `owner_user_id` integer: Reserved for future use
    - `name` string: The project name
    - `project_key` string, nullable: An optional project shorthand key
    - `description` string: An optional descriptive text for the project
    - `is_archived` boolean: Whether the project is archived
    - `quota` object, nullable: Optional quota limits for the project
  - `meta` object, required
    - `count` integer, required
    - `limit` integer
    - `offset` integer, required
    - `totalCount` integer

## Other responses

- `4XX`: The request failed because invalid request parameters or data were supplied or access was denied.
- `5XX`: The request failed because an error occurred during processing of the request.

---

[API](https://skmtc.dev/testiny/apis/testiny-api.md) - [All operations](https://skmtc.dev/testiny/apis/testiny-api/llms.txt) - [OpenAPI document](https://skmtc.dev/testiny/apis/testiny-api/revisions/8f7643b2429d?raw)