GET/v1/tenants/{tenantId}/core/campaigns

Synchronize campaigns Experimental

Live entity representations and retained deletions, ordered by modification/deletion timestamp and ID. Use an overlap window when polling from a completed sync_through checkpoint. Requires campaigns:read or core:read. Save sync_through after the final page succeeds, then subtract a configurable overlap window for the next poll.

Parameters

tenantIdpathstringnon-nullrequired
sincequerystringnon-nulloptional: Inclusive ISO 8601 timestamp with offset. Omit to synchronize everything. Cannot be combined with cursor.
cursorquerystringnon-nulloptional: Opaque next_cursor from the previous page. Pass it back unchanged to continue the same collection.
limitqueryintegernon-nulloptional: Combined entities and deletions per page: default 100, maximum 500. May change between pages.
Format: int32

Responses

200Response

application/jsonobjectnon-null

itemsarray of objectnon-nullrequired

Show item fields

Exactly one of these shapes is allowed.

deleted objectnon-null

typestringnon-nullrequired: Allowed values"deleted"
idstringnon-nullrequired
changed_atstringnon-nullrequired: Format: ISO 8681 timestamp
Example"2025-10-28T12:37:42Z"
deleted_atstringnon-nullrequired: Format: ISO 8681 timestamp
Example"2025-10-28T12:37:42Z"

entity objectnon-null

typestringnon-nullrequired

Allowed values"entity"

dataobjectnon-nullrequired

Show child fields

idstringnon-nullrequired

codestringnon-nullrequired

linesarray of objectnon-nullrequired

Show item fields

idstringnon-nullrequired: Further nesting is omitted. See the schema for the full definition.
basic_gross_unit_pricestringnullableoptional: Further nesting is omitted. See the schema for the full definition.
Format: BigDecimal
Example"100.0"
basic_net_unit_pricestringnullableoptional: Further nesting is omitted. See the schema for the full definition.
Format: BigDecimal
Example"100.0"
campaign_gross_unit_pricestringnullableoptional: Further nesting is omitted. See the schema for the full definition.
Format: BigDecimal
Example"100.0"
campaign_net_unit_pricestringnullableoptional: Further nesting is omitted. See the schema for the full definition.
Format: BigDecimal
Example"100.0"
product_idstringnon-nullrequired: Further nesting is omitted. See the schema for the full definition.
requires_loyalty_membershipbooleannon-nullrequired: Further nesting is omitted. See the schema for the full definition.
sku_idstringnon-nullrequired: Further nesting is omitted. See the schema for the full definition.
sku_numberstringnon-nullrequired: Further nesting is omitted. See the schema for the full definition.

namestringnon-nullrequired

statusstringnon-nullrequired

versionintegernon-nullrequired

Format: int64

campaign_typestringnon-nullrequired

company_idstringnon-nullrequired

created_atstringnon-nullrequired

Format: ISO 8681 timestamp

Example"2025-10-28T12:37:42Z"

currency_iso_codestringnon-nullrequired

loyalty_program_idstringnullableoptional

modified_atstringnon-nullrequired

Format: ISO 8681 timestamp

Example"2025-10-28T12:37:42Z"

order_delivery_datestringnullableoptional

Format: date

Example"2026-01-14"

order_endstringnon-nullrequired

Format: date

Example"2026-01-14"

order_startstringnon-nullrequired

Format: date

Example"2026-01-14"

product_scopesarray of objectnon-nullrequired

Show item fields

idstringnon-nullrequired: Further nesting is omitted. See the schema for the full definition.
brand_idstringnullableoptional: Further nesting is omitted. See the schema for the full definition.
main_product_group_idstringnullableoptional: Further nesting is omitted. See the schema for the full definition.
product_category_idstringnullableoptional: Further nesting is omitted. See the schema for the full definition.
sub_product_group_idstringnullableoptional: Further nesting is omitted. See the schema for the full definition.

retail_chain_idsarray of stringnon-nullrequired

time_zonestringnon-nullrequired

valid_fromstringnon-nullrequired

Format: date

Example"2026-01-14"

valid_from_atstringnon-nullrequired

Format: ISO 8681 timestamp

Example"2025-10-28T12:37:42Z"

valid_tostringnon-nullrequired

Format: date

Example"2026-01-14"

valid_to_atstringnon-nullrequired

Format: ISO 8681 timestamp

Example"2025-10-28T12:37:42Z"

changed_atstringnon-nullrequired

Format: ISO 8681 timestamp

Example"2025-10-28T12:37:42Z"

View schema definition

next_cursorstringnullablerequired

sync_throughstringnon-nullrequired

Format: ISO 8681 timestamp

Example"2025-10-28T12:37:42Z"

View schema definition

400Response

application/jsonobjectnon-null

errorstringnon-nullrequired: Stable error code
Example"INVALID_REQUEST"
messagestringnon-nullrequired: Human-readable error message
Example"Invalid customer ID format"
resolutionstringnon-nullrequired: Suggested next action
Example"Correct the customer ID and retry the request"

View schema definition

401Response

application/jsonobjectnon-null

errorstringnon-nullrequired: Stable error code
Example"INVALID_REQUEST"
messagestringnon-nullrequired: Human-readable error message
Example"Invalid customer ID format"
resolutionstringnon-nullrequired: Suggested next action
Example"Correct the customer ID and retry the request"

View schema definition

403Response

application/jsonobjectnon-null

errorstringnon-nullrequired: Stable error code
Example"INVALID_REQUEST"
messagestringnon-nullrequired: Human-readable error message
Example"Invalid customer ID format"
resolutionstringnon-nullrequired: Suggested next action
Example"Correct the customer ID and retry the request"

View schema definition