Filter by internal campaign ID (Campaign.id, numeric hash, e.g. 13896840291241714382). NOT the on-chain campaignId (hex hash) — use the campaignId query for that. Comma-separated list supported. See ID types.

Filter campaigns created by a user who has a specific tag

Filter campaigns created by a user who is registered as a merkl creator

Search amongst multiple values (token, protocols, tags, campaigns)

Filter by type of campaign

Silo, Radiant, Morpho, Dolomite, Compound, Ajna and Euler campaigns have a subtype attribute you can filter on

Filter by on-chain campaign ID (Campaign.campaignId, 32-byte hex hash, e.g. 0x93cf385c2a446a7596820601caf25e63bfc4939efa9a89a6f21563b58ee54eb1). The same on-chain campaignId can exist on several chains; one resource per chain is returned. NOT the internal Campaign.id (numeric hash) — use the id query for that. See ID types.

Filter by mainParameter (a.k.a. opportunity identifier) — the value used to group campaigns into one opportunity. Can be a pool/vault/market address (e.g. 0x35Cbe854...) or an arbitrary on-chain hash. NOT a campaign or opportunity ID. See ID types.

Filter by reward token symbol (e.g. USDC for campaigns rewarding in USDC)

Filter results by the reward token address. Use in combination with chainId for accuracy

Return campaigns rewarding in test tokens

Return campaigns rewarding in points

Filter by internal opportunity ID (Opportunity.id, numeric hash, e.g. 7673870997270712040). Lookup at GET /v4/opportunities. NOT a campaign ID. See ID types.

Returns campaigns starting after the given unix timestamp

Returns campaigns ending after the given unix timestamp

Include opportunity data. Will slow down the request. Default: false

Exclude subcampaigns from the results. Default: false

Get Only Subcampaigns. Default: false

Filter by root internal campaign ID (Campaign.id, numeric hash). Returns only subcampaigns sharing this root. See ID types.

Filter by parent internal campaign ID (Campaign.id, numeric hash). Returns only subcampaigns sharing this parent. See ID types.

Filter by protocol slug (e.g. aave, morpho). NOT a numeric ID. List slugs at GET /v4/protocols.

Filter by compute-pause reason. Returns only campaigns whose pauseCompute matches this exact reason (e.g. paused_high_amount).

When true, include private campaigns the caller (JWT, API key owner, or BackOffice) is authorized to see, decoded. When false (default), only public campaigns are returned. Bypasses CDN cache.

Address that owns the campaign lists referenced by campaignLists. Required when campaignLists is set.

Comma-separated list names owned by listOwner (stored in the global campaign-lists config). Returns campaigns whose ID is in any of the given lists (union). List names are case-insensitive. Lists are shareable — anyone can query any owner's lists. Example: baseapp,renew.