List Feature Flags

GET /api/projects/:id/feature_flags

Returns a paginated list of all feature flags in a project. Supports filtering by various criteria including active status, creation, tags, and evaluation runtime.

Path Parameters

integer

required

Project ID

Query Parameters

string

Filter by active status: true, false, or STALE

string

Filter by user ID who created the flag

string

Search by feature flag key or name (case insensitive)

string

Filter by flag type: boolean, multivariant, or experiment

string

Filter by evaluation runtime: server, client, or both

string

JSON-encoded array of tag names to filter by

string

Filter by presence of evaluation context tags: true or false

string

JSON-encoded array of flag keys to exclude from results

string

Field to order by (prefix with - for descending). Default: -created_at

integer

default:"100"

Number of results per page

integer

default:"0"

Pagination offset

Response

integer

Total number of feature flags matching the filters

string | null

URL for the next page of results

string | null

URL for the previous page of results

array

Array of feature flag objects

integer

Feature flag ID

string

Unique flag identifier

string

Flag description

object

Release conditions and configuration

boolean

Whether the flag is currently active

boolean

Whether the flag is soft-deleted

string

ISO 8601 timestamp

object

User who created the flag

array

Associated tag names

array

Evaluation context tag names

integer

Version number for optimistic locking

boolean

Whether the current user can edit this flag

array

Associated experiments

array

Associated surveys

array

Associated early access features

Examples

List All Flags

curl -X GET "https://app.posthog.com/api/projects/:project_id/feature_flags" \
  -H "Authorization: Bearer <ph_project_api_key>"

import requests

response = requests.get(
    "https://app.posthog.com/api/projects/:project_id/feature_flags",
    headers={"Authorization": "Bearer <ph_project_api_key>"}
)

flags = response.json()["results"]

fetch('https://app.posthog.com/api/projects/:project_id/feature_flags', {
  headers: {
    'Authorization': 'Bearer <ph_project_api_key>'
  }
})
  .then(res => res.json())
  .then(data => {
    console.log(data.results);
  });

Filter Active Flags

curl -X GET "https://app.posthog.com/api/projects/:project_id/feature_flags?active=true" \
  -H "Authorization: Bearer <ph_project_api_key>"

import requests

response = requests.get(
    "https://app.posthog.com/api/projects/:project_id/feature_flags",
    params={"active": "true"},
    headers={"Authorization": "Bearer <ph_project_api_key>"}
)

Search by Key or Name

curl -X GET "https://app.posthog.com/api/projects/:project_id/feature_flags?search=dashboard" \
  -H "Authorization: Bearer <ph_project_api_key>"

import requests

response = requests.get(
    "https://app.posthog.com/api/projects/:project_id/feature_flags",
    params={"search": "dashboard"},
    headers={"Authorization": "Bearer <ph_project_api_key>"}
)

Filter by Type and Tags

curl -X GET "https://app.posthog.com/api/projects/:project_id/feature_flags?type=multivariant&tags=%5B%22frontend%22%2C%22experiment%22%5D" \
  -H "Authorization: Bearer <ph_project_api_key>"

import requests
import json

response = requests.get(
    "https://app.posthog.com/api/projects/:project_id/feature_flags",
    params={
        "type": "multivariant",
        "tags": json.dumps(["frontend", "experiment"])
    },
    headers={"Authorization": "Bearer <ph_project_api_key>"}
)

Filter by Evaluation Runtime

curl -X GET "https://app.posthog.com/api/projects/:project_id/feature_flags?evaluation_runtime=server" \
  -H "Authorization: Bearer <ph_project_api_key>"

import requests

response = requests.get(
    "https://app.posthog.com/api/projects/:project_id/feature_flags",
    params={"evaluation_runtime": "server"},
    headers={"Authorization": "Bearer <ph_project_api_key>"}
)

Pagination

curl -X GET "https://app.posthog.com/api/projects/:project_id/feature_flags?limit=50&offset=100" \
  -H "Authorization: Bearer <ph_project_api_key>"

import requests

response = requests.get(
    "https://app.posthog.com/api/projects/:project_id/feature_flags",
    params={"limit": 50, "offset": 100},
    headers={"Authorization": "Bearer <ph_project_api_key>"}
)

Response Example

{
  "count": 42,
  "next": "https://app.posthog.com/api/projects/123/feature_flags?limit=10&offset=10",
  "previous": null,
  "results": [
    {
      "id": 12345,
      "key": "new-dashboard",
      "name": "New Dashboard Design",
      "filters": {
        "groups": [
          {
            "rollout_percentage": 20,
            "properties": []
          }
        ]
      },
      "deleted": false,
      "active": true,
      "created_by": {
        "id": 1,
        "uuid": "01234567-89ab-cdef-0123-456789abcdef",
        "distinct_id": "user@example.com",
        "first_name": "Jane",
        "email": "user@example.com"
      },
      "created_at": "2024-01-15T10:30:00Z",
      "updated_at": "2024-01-20T14:22:00Z",
      "last_modified_by": {
        "id": 1,
        "uuid": "01234567-89ab-cdef-0123-456789abcdef",
        "distinct_id": "user@example.com",
        "first_name": "Jane",
        "email": "user@example.com"
      },
      "ensure_experience_continuity": false,
      "rollback_conditions": null,
      "performed_rollback": false,
      "tags": ["frontend", "dashboard"],
      "evaluation_tags": [],
      "version": 3,
      "can_edit": true,
      "usage_dashboard": 456,
      "analytics_dashboards": [789],
      "has_enriched_analytics": false,
      "experiment_set": [],
      "surveys": [],
      "features": [],
      "is_used_in_replay_settings": false
    },
    {
      "id": 12346,
      "key": "checkout-variant",
      "name": "Checkout Flow Experiment",
      "filters": {
        "groups": [
          {
            "rollout_percentage": 100,
            "properties": []
          }
        ],
        "multivariate": {
          "variants": [
            {
              "key": "control",
              "name": "Control",
              "rollout_percentage": 50
            },
            {
              "key": "test",
              "name": "Test",
              "rollout_percentage": 50
            }
          ]
        }
      },
      "active": true,
      "deleted": false,
      "created_at": "2024-01-10T09:00:00Z",
      "tags": ["experiment", "checkout"],
      "version": 1,
      "can_edit": true
    }
  ]
}

Notes:

Internal flags created by surveys and product tours are automatically excluded from results
Flags are ordered by creation date (newest first) by default
Use the order parameter to sort by other fields (e.g., order=key or order=-updated_at)
The STALE status filter returns flags that haven’t been evaluated recently
When filtering by tags, flags must have ALL specified tags (AND logic)
The has_evaluation_tags filter helps identify flags with runtime context requirements

Filter Combinations

You can combine multiple filters:

curl -X GET "https://app.posthog.com/api/projects/:project_id/feature_flags?active=true&type=multivariant&evaluation_runtime=server&search=checkout" \
  -H "Authorization: Bearer <ph_project_api_key>"

import requests

response = requests.get(
    "https://app.posthog.com/api/projects/:project_id/feature_flags",
    params={
        "active": "true",
        "type": "multivariant",
        "evaluation_runtime": "server",
        "search": "checkout"
    },
    headers={"Authorization": "Bearer <ph_project_api_key>"}
)

Overview

Events

Feature Flags

Cohorts

Insights

List Feature Flags

GET /api/projects/:id/feature_flags

Path Parameters

Query Parameters

Response

Examples

List All Flags

Filter Active Flags

Search by Key or Name

Filter by Type and Tags

Filter by Evaluation Runtime

Response Example

Filter Combinations

​GET /api/projects/:id/feature_flags

​Path Parameters

​Query Parameters

​Response

​Examples

​List All Flags

​Filter Active Flags

​Search by Key or Name

​Filter by Type and Tags

​Filter by Evaluation Runtime

​Pagination

​Response Example

​Filter Combinations

GET /api/projects/:id/feature_flags

Path Parameters

Query Parameters

Response

Examples

List All Flags

Filter Active Flags

Search by Key or Name

Filter by Type and Tags

Filter by Evaluation Runtime

Pagination

Response Example

Filter Combinations