Get a list of segments

Use this method to get a list of segments.

Learn more about Segments and its use cases.

Please log in to see full path URL. Learn why.

get

/people/3/segments

Authorizations:

Scopes:

people:manage

people:read

Request rate limit:

5 requests / second (per account)

Learn more

query Parameters

page	integer Default: 0 Zero-based page index (0..N).
size	integer [ 1 .. 1000 ] Default: 20 The size of the page to be returned.
sort	Array of strings Example: sort=name,DESC Sorting criteria in the format: property,(asc\|desc). Default sort order is ascending. Multiple sort criteria are supported.

Responses

200

401

Unauthorized

403

Forbidden

429

Too Many Requests

500

Internal Server Error

Request samples

Example

cURL

Copy

curl -L -g 'https://{baseUrl}/people/3/segments?sort=name%2CDESC' \
-H 'Authorization: {authorization}' \
-H 'Accept: application/json'

Response samples

Content type

application/json

Copy

Collapse all


{"results": 
[
{"id": 42,
"name": "VIP Alex Clients",
"description": "Persons named Alex with tag \"VIP Client\"",
"query": 
{"#and": 
[
{"firstName": "Alex"
},
{"#contains": 
{"tags": "VIP Client"
}
}
]
},
"events": 
[
{"definitionId": "addedToCart",
"occurrenceCondition": 
{"operation": "IS",
"times": 5
},
"timelineCondition": 
{"occurred": "ALL",
"operator": "BETWEEN",
"start": 60,
"end": 30,
"units": "DAYS"
},
"payloadConditions": 
[
{"attribute": "itemId",
"operator": "EQ",
"value": "10001"
}
]
}
],
"createdAt": "2025-03-30T06:47:41Z",
"modifiedAt": "2025-03-30T06:47:41Z"
}
],
"paging": 
{"page": 0,
"size": 1,
"totalPages": 0,
"totalResults": 0
}
}

Need assistance

Explore Infobip Tutorials

Encountering issues

Contact our support

What's new? Check out

Release Notes

Unsure about a term? See

Glossary

Research panel

Help shape the future of our products

Learn more

Service status

Privacy documents Terms of use