Skip to content

Deidentified

The read-only output-field catalog for the Deidentified dataset on Create Audience: the signal fields the delivery can carry, in their six selectable groups.

One flat read covers every group. Each row is a { value, text, group, group_text } object: value is the field the create body accepts, group is the key inside the create body’s fields object to put it under, and the two *_text values are the labels to show a user.

Every read here is authenticated and JSON-only (bearer token + Accept: application/json) and uses the read rate bucket (120 requests/min per caller).

Get Deidentified Fields

GET /api/v2/analyses/reference/deidentified/fields

The fields a Deidentified dataset can carry into its delivery, across all six groups. The catalog is fixed and small, so the whole list is returned in one flat response. Pass group to narrow it to a single group.

Query parameters

FieldTypeRequiredDescription
groupstringNoNarrow the list to one group. Use a group value from this same read; anything else is rejected with 422.
searchstringNoOptional free-text filter on the field label (case-insensitive contains).
curl "https://console.intuizi.com/api/v2/analyses/reference/deidentified/fields" \
  -H "Authorization: Bearer <YOUR_TOKEN>" \
  -H "Accept: application/json"

Response

{
  "status": "success",
  "code": 200,
  "message": "Resources fetched successfully.",
  "data": [
    { "value": "latitude", "text": "Latitude", "group": "geoLocation", "group_text": "Geo-Location" },
    { "value": "longitude", "text": "Longitude", "group": "geoLocation", "group_text": "Geo-Location" },
    { "value": "bid", "text": "BID", "group": "advertising", "group_text": "Advertising" },
    { "value": "devicetype", "text": "Device Type", "group": "userDetails", "group_text": "User Details" },
    { "value": "ipisp", "text": "ISP/Carrier", "group": "ipDetails", "group_text": "IP Details" },
    { "value": "consentgdpr", "text": "Consent GDPR", "group": "privacy", "group_text": "Privacy" },
    { "value": "d_utc", "text": "DatetimeUTC", "group": "general", "group_text": "General" }
  ]
}

Narrowing to one group

curl "https://console.intuizi.com/api/v2/analyses/reference/deidentified/fields?group=ipDetails" \
  -H "Authorization: Bearer <YOUR_TOKEN>" \
  -H "Accept: application/json"

Using the values

Put each field under the group the read returned it in. Fields are optional - send only the groups you want, and omit fields entirely to take the default shape. Selecting a field adds that column to the delivery; it does not filter rows (there is no device or OS filter on the Deidentified dataset - a key such as deviceos on the block is rejected with 422):

{
  "type": "Deidentified",
  "start_date": "2026-01-05",
  "end_date": "2026-01-18",
  "signal_providers": ["BID001"],
  "fields": {
    "geoLocation": ["latitude", "longitude"],
    "ipDetails": ["ipisp"],
    "general": ["d_utc"]
  },
  "location": { "countries": ["USA"] }
}

A field sent under a group it does not belong to is rejected with 422, so always take the pairing from this read rather than assuming it.