API reference
PartnersList
List partners with filter and cursor paging: name, @username, status, handles per network and campaigns. Read access, partners toolset, MCP tool list_partners.
Access: Read
Variables
| Variable | Type | Required | Accepts | Description |
|---|---|---|---|---|
accountsWanted | Int! | yes | 32-bit integer. MCP tools send 50 when it is left out | |
after | Cursor | no | Opaque cursor from pageInfo.endCursor | |
campaignsWanted | Int! | yes | 32-bit integer. MCP tools send 50 when it is left out | |
filter | PartnerFilter | no | Input object, below | |
first | Int! | yes | 32-bit integer. MCP tools send 50 when it is left out | |
orderBy | [PartnerOrderBy!] | no | One of 21 values, see PartnerOrderBy. Default ["CREATED_AT_DESC"] | The method to use when ordering Partner. |
withDetail | Boolean! | yes | MCP tools send false when it is left out | Included when true. |
Input types
A filter lists its fields by the type they take, and none of them is required.
PartnerFilter
[PartnerFilter!]:and,or- DatetimeFilter:
createdAt - StringFilter:
email,name,username,utmContent,utmMedium,utmSource PartnerFilter:not- UUIDFilter:
rowId PartnerStatusFilter:status
PartnerStatusFilter
PartnerStatus(One ofACTIVE,ARCHIVED,DROPPED,PAUSED,PENDING):equalTo,greaterThan,greaterThanOrEqualTo,lessThan,lessThanOrEqualTo,notEqualTo[PartnerStatus!](One ofACTIVE,ARCHIVED,DROPPED,PAUSED,PENDING):in,notInBoolean:isNull
Call it
bash
curl https://api.missin.co.uk/graphql/v1 \
-H "Authorization: Bearer $MISSIN_API_KEY" \
-H "Content-Type: application/json" \
-d '{"operationName":"PartnersList","variables":{"accountsWanted":50,"campaignsWanted":50,"first":50,"withDetail":false},"extensions":{"persistedQuery":{"version":1,"sha256Hash":"9bcdcc6e1d5039690b4525bd486d461f6504f4b4e933e91b3bb22c5fcc11943b"}}}'Document
graphql
query PartnersList($accountsWanted: Int!, $after: Cursor, $campaignsWanted: Int!, $filter: PartnerFilter, $first: Int!, $orderBy: [PartnerOrderBy!] = [CREATED_AT_DESC], $withDetail: Boolean!) { __typename allPartners(first: $first, after: $after, orderBy: $orderBy, filter: $filter) { __typename nodes { __typename profileImage: avatarUrl budget campaignPartnersByPartnerId(first: $campaignsWanted) { __typename nodes { __typename campaignByCampaignId { __typename icon iconColor id name rowId } id rowId } totalCount } createdAt discountCodesByPartnerId { __typename totalCount } email endDate id name partnerSocialNetworksByPartnerId(first: $accountsWanted) { __typename nodes { __typename checkState checkedAt @include(if: $withDetail) handle id rowId socialNetworkBySocialNetworkId { __typename id name slug } url @include(if: $withDetail) watched @include(if: $withDetail) } totalCount } rowId status tags trusted username utmContent utmMedium utmSource } pageInfo { __typename endCursor hasNextPage } totalCount } }