# List regression test definitions

**GET /regression-tests**

The active filter must be applied explicitly. The legacy get_customized_regressiontests() returns all regression tests — including inactive ones — when no custom set is defined.



## Servers
- Production: https://sampleplatform.ccextractor.org/api/v1 (Production)


## Authentication methods
- Bearer auth


## Parameters


### Query parameters
- **limit** (integer)
  Maximum number of results to return (1–100)
- **offset** (integer)
  Number of results to skip for pagination
- **active** (boolean)

- **category** (string)

- **tag** (string)

- **sample_id** (integer)



## Responses
### 200
Paginated regression test definitions

#### Body: application/json (object)
- **data** (array)

- **pagination** (object)


### 401
Missing, expired, or invalid bearer token

#### Body: application/json (object)
- **code** (string)
  Machine-readable error code (snake_case)
- **message** (string)
  Human-readable error summary
- **details** (object)
  Structured context for the error. Always an object, never null. Empty object {} when no additional detail is available.

### 429
Too many requests. Retry after the indicated number of seconds.
#### Headers
- **Retry-After** (integer)
  Seconds to wait before retrying
- **X-RateLimit-Limit** ()
  Maximum requests allowed in the current window
- **X-RateLimit-Remaining** ()
  Requests remaining in the current window
- **X-RateLimit-Reset** ()
  Unix timestamp when the rate limit window resets

#### Body: application/json (object)
- **code** (string)
  Machine-readable error code (snake_case)
- **message** (string)
  Human-readable error summary
- **details** (object)
  Structured context for the error. Always an object, never null. Empty object {} when no additional detail is available.

### default
Unexpected server error

#### Body: application/json (object)
- **code** (string)
  Machine-readable error code (snake_case)
- **message** (string)
  Human-readable error summary
- **details** (object)
  Structured context for the error. Always an object, never null. Empty object {} when no additional detail is available.


[Powered by Bump.sh](https://bump.sh)