Get identity flags and traits

GET 
https://edge.api.flagsmith.com/api/v1/identities

Retrieve the flags and traits for an identity. Note: identity will be lazily created if it does not already exist.

Request

Query Parameters

identifier stringrequired

Identity Key

Responses

200

OK

application/json

Schema

Schema

Array [
flags object[]
Array [
enabled boolean
feature_state_value objectnullable
oneOf
MOD1
string
Example: a-remote-config-value
MOD2
number
Example: 42
MOD3
boolean
Example: true
feature object
id integer
Example: 42
name string
Example: show_hero_banner
type string
Example: STANDARD
]
traits object[]
Array [
trait_key string
Example: Name
trait_value objectnullable
oneOf
MOD1
string
Example: B.A. Baracus
MOD2
number
Example: 42
MOD3
boolean
Example: true
]
]

Example (auto)

[
  {
    "flags": [
      {
        "enabled": true,
        "feature_state_value": "a-remote-config-value",
        "feature": {
          "id": 42,
          "name": "show_hero_banner",
          "type": "STANDARD"
        }
      }
    ],
    "traits": [
      {
        "trait_key": "Name",
        "trait_value": "B.A. Baracus"
      }
    ]
  }
]

Authorization: X-Environment-Key

name: X-Environment-Keytype: apiKeyin: header

• python
• curl
• csharp
• go
• nodejs
• ruby
• php
• java
• powershell

• HTTP.CLIENT
• REQUESTS

import http.client

conn = http.client.HTTPSConnection("edge.api.flagsmith.com")
payload = ''
headers = {
  'Accept': 'application/json',
  'X-Environment-Key': '<API_KEY_VALUE>'
}
conn.request("GET", "/api/v1/identities", payload, headers)
res = conn.getresponse()
data = res.read()
print(data.decode("utf-8"))

Request Collapse all

Base URL

https://edge.api.flagsmith.com/api/v1

Auth

EnvironmentKey

Parameters

identifier — queryrequired

ResponseClear

Click the Send API Request button above and see the response here!