Skip to main content

Get Campaign Runs

GET/api/v1/campaign/{campaign_id}/runs

Get campaign workflow runs with pagination, filters and sorting

cURL example

curl -X GET \
  'http://localhost:8000/api/v1/campaign/{campaign_id}/runs' \
  -H 'Authorization: Bearer <API_KEY>'

Parameters

NameLocationTypeDescription
campaign_idrequiredpathinteger
pagequeryintegerPage number (starts from 1)
limitqueryintegerNumber of items per page
filtersqueryobjectJSON-encoded filter criteria
sort_byqueryobjectField to sort by (e.g., 'duration', 'created_at')
sort_orderqueryobjectSort order ('asc' or 'desc')
authorizationheaderobject
X-API-Keyheaderobject

Responses

200Successful Response
application/json
View schema
{
  "$ref": "#/components/schemas/CampaignRunsResponse"
}
404Not found
422Validation Error
application/json
View schema
{
  "$ref": "#/components/schemas/HTTPValidationError"
}