API reference

IncentivesList

List incentives with their rules, grant counts, redemptions and estimated value. Read access, incentives toolset, MCP tool list_incentives.

Access: Read

Variables

Variable	Type	Required	Accepts	Description
`first`	`Int!`	yes	32-bit integer. MCP tools send `50` when it is left out

Call it

bash

curl https://api.missin.co.uk/graphql/v1 \
  -H "Authorization: Bearer $MISSIN_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"operationName":"IncentivesList","variables":{"first":50},"extensions":{"persistedQuery":{"version":1,"sha256Hash":"b96301024934c05641a47308bfc74169abb373e3bb6ba10616f18c27406c36b2"}}}'

Document

graphql

fragment IncentiveRow on Incentive { __typename audience createdAt description formByFormId { __typename formSlug id rowId status title } icon iconColor id grants: incentiveGrantsByIncentiveId { __typename aggregates { __typename sum { __typename valueEstimate } } totalCount } redeemed: incentiveGrantsByIncentiveId(condition: {status: REDEEMED}) { __typename totalCount } rules: incentiveRulesByIncentiveId(orderBy: [PRIMARY_KEY_ASC]) { __typename nodes { __typename connectionId discountCodeByDiscountCodeId { __typename code discountPlacementsByDiscountCodeId { __typename totalCount } id rowId } discountCodeId id kindSlug outcome rowId terms } totalCount } limitCount limitPeriod name rowId status tier } query IncentivesList($first: Int!) { __typename allIncentives(first: $first, orderBy: [CREATED_AT_DESC]) { __typename nodes { __typename ...IncentiveRow } totalCount } }