Skip to main content
GET
/
v1
/
audience-segments
/
{id}
Get an audience segment
curl --request GET \
  --url https://app.loops.so/api/v1/audience-segments/{id} \
  --header 'Authorization: Bearer <token>'
{
  "id": "seg_01hxyz",
  "name": "Active users",
  "description": "Users active in the last 30 days",
  "createdAt": "2026-03-28T15:00:00.000Z",
  "updatedAt": "2026-03-28T15:00:00.000Z",
  "filter": {
    "match": "all",
    "conditions": [
      {
        "type": "property",
        "key": "plan",
        "operator": "equals",
        "value": "pro"
      }
    ]
  }
}
Content API endpoints are currently in beta and are subject to change.

​
Request

​
Path parameters

​
id
string
required
The ID of the audience segment.

​
Response

​
Success

​
id
string
required
The audience segment ID.
​
name
string
required
The segment name.
​
description
nullable string
required
An optional description for the segment.
​
createdAt
string
required
ISO 8601 timestamp for when the segment was created.
​
updatedAt
string
required
ISO 8601 timestamp for when the segment was last updated.
​
filter
object
required
A tree of audience conditions combined with match.

​
Error

A 400 Bad Request is returned if id is invalid. A 404 Not Found is returned if the audience segment does not exist. If the API key is invalid (or content API is not enabled for your team), a 401 Unauthorized is returned.
​
message
string
required
An error message describing what went wrong.
{
  "id": "seg_01hxyz",
  "name": "Active users",
  "description": "Users active in the last 30 days",
  "createdAt": "2026-03-28T15:00:00.000Z",
  "updatedAt": "2026-03-28T15:00:00.000Z",
  "filter": {
    "match": "all",
    "conditions": [
      {
        "type": "property",
        "key": "plan",
        "operator": "equals",
        "value": "pro"
      }
    ]
  }
}
Last modified on June 22, 2026