API ReferenceSegments
List segments
Get all audience segments for the project, newest first. This endpoint is not paginated — it returns a bare array of every segment.
Authorization
ApiKeyAuth AuthorizationBearer <token>
API Key authentication. The project is automatically derived from the key.
/v1/track requires a public key (pk_*) — it is the one endpoint intended for client-side use, and a secret key is rejected there with 401.
Every other endpoint requires a secret key (sk_*) and rejects public keys with 401.
So the two key types are not interchangeable in either direction: pick the key that matches the endpoint you are calling.
In: header
Response Body
application/json
application/json
curl -X GET "https://api.plunk.jimster.dev/segments"[
{
"id": "string",
"name": "string",
"description": "string",
"type": "DYNAMIC",
"condition": {
"logic": "AND",
"groups": [
{
"filters": [
{
"field": "string",
"operator": "equals",
"value": null,
"unit": "days"
}
],
"conditions": {
"logic": "AND",
"groups": []
}
}
]
},
"trackMembership": true,
"memberCount": 0,
"projectId": "string",
"createdAt": "2019-08-24T14:15:22Z",
"updatedAt": "2019-08-24T14:15:22Z"
}
]{
"success": false,
"error": {
"code": "INVALID_API_KEY",
"message": "Invalid secret API key. This endpoint requires a secret key (sk_*), not a public key.",
"statusCode": 401,
"requestId": "8f14e45f-ceea-467a-9575-1f0f38e0b1c2"
},
"timestamp": "2025-01-15T10:30:00.000Z"
}