Flag Evaluation API

The Flag Evaluation API lets you evaluate feature flags over HTTP. This is useful for server-side use cases where you cannot use one of the SDKs, or for custom integrations.

Endpoint

GET https://flags.deployramp.com/flags

Headers

• Authorization: Bearer <public_token>: your project's public token, found in Dashboard → Settings → API Keys

Query parameters

• userId (optional): a stable user identifier used for consistent flag assignment
• Traits: pass user traits as query parameters prefixed with trait_, for example trait_plan=pro&trait_region=us-east

Response

The API returns a JSON object containing all flags evaluated for the given user and traits:

{
  "flags": [
    {
      "name": "new-checkout",
      "enabled": true,
      "rolloutPercentage": 50,
      "segments": []
    }
  ]
}

Example

curl -H "Authorization: Bearer pk_live_abc123" \
  "https://flags.deployramp.com/flags?userId=user-42&trait_plan=pro"