GET /list-configurations

Retrieve a paginated list of all active and archived configurations in your workspace. Supports filtering by environment, status, and creation date.

Query Parameters

Parameter Type Description
page integer Page number for pagination. Defaults to 1.
limit integer Number of items per page (max 100). Defaults to 20.
environment string Filter by environment: dev, staging, production.
status string Filter by status: active, draft, archived.
search string Search by configuration name or key prefix.

Example Request

cURL
curl https://api.appconfig.json/v3/list-configurations?page=1\&limit=5\&environment=production \\ -H "Authorization: Bearer sk_live_xxxxxxxxxxxx" \\ -H "Content-Type: application/json"

Response (200 OK)

JSON
{ "success": true, "data": [ { "id": "cfg_8f3a2b1c", "name": "api-timeout-config", "environment": "production", "status": "active", "updated_at": "2025-01-15T08:42:11Z" }, { "id": "cfg_9d2e4f7a", "name": "feature-flags-core", "environment": "production", "status": "draft", "updated_at": "2025-01-14T16:20:05Z" } ], "pagination": { "page": 1, "limit": 5, "total": 42, "next_page": 2 } }

Live Configurations

Configuration ID Name Environment Status Last Updated
cfg_8f3a2b1c api-timeout-config production Active 2025-01-15 08:42 UTC
cfg_9d2e4f7a feature-flags-core production Draft 2025-01-14 16:20 UTC
cfg_a1b2c3d4 cache-invalidation-rules staging Staging 2025-01-13 11:05 UTC
cfg_e5f6g7h8 auth-session-policies production Active 2025-01-12 09:18 UTC