SegmentsList segment members

List segment members

People currently matching the segment, newest activity first, paginated with limit/offset. Readable with either key type.

curl -X GET "https://mythic-analytics.gulp.workers.dev/builder/segments/123e4567-e89b-12d3-a456-426614174000/members?location_id=acme-retail&limit=50&offset=0" \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer YOUR_API_TOKEN"
{
  "data": [
    {
      "id": "example_string",
      "location_id": "example_string",
      "identity_count": 123,
      "session_count": 10,
      "first_seen": "2024-12-25T10:00:00Z",
      "last_seen": "2024-12-25T10:00:00Z",
      "display_name": "John Doe",
      "email": "user@example.com",
      "user_id": "example_string",
      "company": "example_string",
      "avatar": "example_string",
      "first_channel": "example_string",
      "last_channel": "example_string",
      "last_utm_source": "example_string",
      "last_utm_medium": "example_string",
      "last_utm_campaign": "example_string",
      "last_geo_country_name": "John Doe",
      "first_geo_country": "USA",
      "last_device_type": "example_string",
      "first_landing_page": "example_string",
      "last_landing_page": "example_string"
    }
  ],
  "rows": 42,
  "limit": 42,
  "offset": 42
}
GET
/segments/{id}/members
GET
Base URLstring

Target server for requests. Edit to use your own host.

Bearer Token
Bearer Tokenstring
Required

Builder key as a bearer token. Use an agency key for full CRUD (Bearer ak_...) or a viewer key for read-only access (Bearer sk_...). Scoped keys (mcp_) are accepted too and need segments:read or segments:write. See Using an mcp_ key over HTTP.

Builder key as a bearer token. Use an agency key for full CRUD (Bearer ak_...) or a viewer key for read-only access (Bearer sk_...). Scoped keys (mcp_) are accepted too and need segments:read or segments:write. See Using an mcp_ key over HTTP.
path
idstring
Required

Segment UUID.

Format: uuid
query
location_idstring

Client location to scope the request to. Required when authenticating with an agency key (ak_). Ignored for viewer keys (sk_).

query
limitinteger

Max members to return (1–1000).

Max: 1000
Request Preview
Response

Response will appear here after sending the request

Authentication

header
Authorizationstring
Required

Bearer token. Builder key as a bearer token. Use an agency key for full CRUD (Bearer ak_...) or a viewer key for read-only access (Bearer sk_...). Scoped keys (mcp_) are accepted too and need segments:read or segments:write. See Using an mcp_ key over HTTP.

Path Parameters

idstring
Required

Segment UUID.

Query Parameters

location_idstring

Client location to scope the request to. Required when authenticating with an agency key (ak_). Ignored for viewer keys (sk_).

Example:
acme-retail
limitinteger

Max members to return (1–1000).

Responses

dataarray
rowsinteger
limitinteger
offsetinteger