---
title: "List scoped experiences"
method: GET
path: "/api/v1/rules"
---

# List scoped experiences

`GET /api/v1/rules`

## Request

- Base URL: `https://human4ai.ai`
- URL: `https://human4ai.ai/api/v1/rules`
- Auth: one of:
  - HTTP bearer
  - API key in cookie `__Host-h4a`

## Query parameters

- `limit` integer
- `cursor` string
- `status` 'draft' | 'active' | 'archived'

## Response `200`

Successful operation; single resource or {items,nextCursor} for lists.

- object
  - `items` Experience[], required
    - `correctionId` string, required
    - `title` string, required
    - `condition` string, required
    - `action` string, required
    - `boundary` string, required
    - `id` string, required
    - `status` 'draft' | 'active' | 'archived', required
    - `revision` integer, required
    - `createdAt` integer, required: Unix timestamp in milliseconds
    - `updatedAt` integer, required: Unix timestamp in milliseconds
  - `nextCursor` string, nullable, required

## Other responses

- `400`: Structured error; see error.code. Cross-workspace IDs also return 404.
- `401`: Structured error; see error.code. Cross-workspace IDs also return 404.
- `403`: Structured error; see error.code. Cross-workspace IDs also return 404.
- `404`: Structured error; see error.code. Cross-workspace IDs also return 404.
- `409`: Structured error; see error.code. Cross-workspace IDs also return 404.
- `413`: Structured error; see error.code. Cross-workspace IDs also return 404.
- `415`: Structured error; see error.code. Cross-workspace IDs also return 404.
- `429`: Structured error; see error.code. Cross-workspace IDs also return 404.
- `503`: Structured error; see error.code. Cross-workspace IDs also return 404.

---

[API](https://skmtc.dev/human4ai/apis/human4ai-api.md) · [All operations](https://skmtc.dev/human4ai/apis/human4ai-api/llms.txt) · [OpenAPI document](https://skmtc.dev/human4ai/apis/human4ai-api/revisions/0837439582ee?raw)