Lists and segments: people in them, who joined and left in a period
Each list (people now) and segment (people as of its last check; unpublished ones have none) with the people who joined and left in the period, from *List Joined*, *List Left*, *Segment Entered* and *Segment Exited*. A segment counts joins from when it was published: publishing builds it without events (D164). `locale` narrows to people in those locales.
Each list (people now) and segment (people as of its last check; unpublished ones have none) with the people who joined and left in the period, from List Joined, List Left, Segment Entered and Segment Exited. A segment counts joins from when it was published: publishing builds it without events (D164). locale narrows to people in those locales.
apiKey readAuthorizationBearer <token>A workspace API key (pf_…), created under Developers → API keys.
Scope: read
from?stringFrom (inclusive)
date-timeto?stringUntil (exclusive)
date-timelocale?stringComma-separated locales (nl-NL), any of them
page?integerStarts at 1
1 <= value1pageSize?numberOne of 10, 25, 50, 100
25q?stringSearch
1 <= length <= 200kind?stringComma-separated: list, segment
sort?stringOne of name, people, joined, left, change; prefix with - for descending
"-people""name""-name""people""-people""joined""-joined""left""-left""change""-change"OK
application/json- response
items*array<>total*integerpage*integerpageSize*integercurl -X GET 'https://api.postforge.dev/v1/analytics/audiences'{ "items": [ { "id": "string", "kind": "list", "name": "string", "people": 0, "checkedAt": "2019-08-24T14:15:22Z", "joined": 0, "left": 0 } ], "total": 0, "page": 0, "pageSize": 0}Subscribers in a period: growth, where they came from, why they left GET
Read live from consent history (D212): people subscribed to email now and at the start of the period (a person’s latest change wins, as on their profile), who subscribed and unsubscribed per bucket and in all (each person once), by source and origin, and per person’s locale. `locale` narrows to people in those locales.
List API keys GET
The workspace’s keys, active first, newest first; never the keys themselves.