beehiiv Developer Documentation

Retrieve a single active dynamic content condition set for a publication. Use expand[]=stats to calculate and return the active subscriber count synchronously.

Authentication

AuthorizationBearer

Bearer authentication of the form Bearer <token>, where token is your auth token.

Path parameters

publicationIdstringRequiredformat: "^(pub_[0-9a-fA-F\-]+)$"

The prefixed ID of the publication object

conditionSetIdstringRequired

The UUID of the condition set object

Query parameters

expand[]list of enumsOptional

Optionally expand the response to include additional data.
stats - Calculates and returns the active subscriber count for this condition set synchronously.

Allowed values:

Response

dataobject

Errors

404

Not Found Error

429

Too Many Requests Error

500

Internal Server Error

1	{
2	"data": {
3	"id": "00000000-0000-0000-0000-000000000000",
4	"name": "Premium subscribers only",
5	"status": "active",
6	"created": 1700000000,
7	"updated": 1700000000,
8	"purpose": "dynamic_content"
9	}
10	}