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

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

`GET /atm-testcase`

## Request

- Base URL: `https://app.testiny.io/api/v1`
- URL: `https://app.testiny.io/api/v1/atm-testcase`
- Auth: API key in header `X-Api-Key`
- TypeScript: <https://skmtc.dev/testiny/apis/testiny-api/docs/atm-testcase/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 'AutomationTestCase' expanded with specified mapped values

- object
  - `data` AutomationTestCase[], required
    - `id` integer: The unique entity id - must be a positive integer
    - `title` string: A descriptive title for this entity or mapping (1 to 1000 characters)
    - `project_id` integer: The project id this entity or mapping belongs to
    - `tags` string: A list of tags for this entity
    - `atm_source_id` integer: The atm_source_id property
    - `atm_key` string: A unique key for test case for matching on import
    - `folder_path` string: The folder_path property
    - `steps` object[]
      - `id` string
      - `title` string, required
    - `description` string, nullable: An optional description for the test case (can be a rich text document, i.e. markdown with header line `<!--markdown-->` or Testiny JSON format)
  - `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)