API reference

DiscountCodesList

List discount codes with filter, sort and offset paging: code, value, status, usage and tags. Read access, discounts toolset, MCP tool list_discount_codes.

Access: Read

Variables

Variable	Type	Required	Accepts	Description
`filter`	`DiscountCodeFilter`	no	DiscountCodeFilter
`first`	`Int!`	yes	32-bit integer. MCP tools send `50` when it is left out
`offset`	`Int`	no	32-bit integer. Default `0`	Skip the first `n` values from our `after` cursor, an alternative to cursor based pagination. May not be used with `last`.
`orderBy`	`[DiscountCodeOrderBy!]`	no	One of 33 values, see DiscountCodeOrderBy. Default `["CREATED_AT_DESC"]`	The method to use when ordering `DiscountCode`.
`withTotal`	`Boolean!`	yes	MCP tools send `false` when it is left out	Included when true.

Call it

bash

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

Document

graphql

fragment DiscountCodeListRow on DiscountCode { __typename code createdAt createdBy displayName endsAt id isPublic partnerByPartnerId { __typename id rowId } publicTier rowId startAt status tags title updatedAt usageCount usageLimit usageSource valueAmount valuePercent version } query DiscountCodesList($filter: DiscountCodeFilter, $first: Int!, $offset: Int = 0, $orderBy: [DiscountCodeOrderBy!] = [CREATED_AT_DESC], $withTotal: Boolean!) { __typename allDiscountCodes( filter: $filter orderBy: $orderBy first: $first offset: $offset ) { __typename nodes { __typename ...DiscountCodeListRow } totalCount @include(if: $withTotal) } }