Mavrck List Member Reward Win API
The ListMemberRewardWin API from Mavrck — 6 operation(s) for listmemberrewardwin.
Work with this as data
Every API here is available over the APIs.io API and to AI agents over MCP.
MCP server
One button, every client — Claude, Cursor, VS Code and the rest.
https://apis.io/mcp
Tools for apis
7 MCP tools reach this
find_apisBrowse and filter every API in the catalog.get_api_artifactsOne API's artifacts, grouped by type.get_openapiThe primary OpenAPI for this API.find_similar_apisAPIs that look like this one.apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.resolveTurn a domain, URL or GitHub org into the provider it belongs to.find_cohortsEvery scored population of providers in the catalog.
Call it yourself
curl for this page
This API
curl "https://apis.io/api/v1/apis/mavrck-listmemberrewardwin-api"
All apis
curl "https://apis.io/api/v1/apis?limit=25"Discovery needs no key. Ratings and market analysis are Pro.
Get an API key
Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.
A second provider on the same verified email joins the account you already have.
OpenAPI Specification
openapi: 3.2.0
info:
version: 1.0.0
description: Identify your most influential customers and activate them to drive more conversions on social.
title: MAVRCK.IO List Member Reward Win API
servers:
- url: http://app.splashscore.com/v1
- url: https://app.splashscore.com/v1
security:
- apiKey: []
tags:
- name: ListMemberRewardWin
paths:
/list-member-reward-wins/{listMemberRewardWinId}:
get:
tags:
- ListMemberRewardWin
operationId: getListMemberRewardWin
x-handler: reward_wins/list_member_reward_win/list_member_reward_win_controller.js
x-access:
- administrator
summary: Gets a list member reward win.
parameters:
- name: listMemberRewardWinId
in: path
description: ID of list member reward win
required: true
schema:
type: integer
responses:
'200':
description: An individual list member reward win
content:
application/json:
schema:
$ref: '#/components/schemas/ListMemberRewardWin'
'400':
description: Invalid parameter.
content:
application/json:
schema:
$ref: '#/components/schemas/Error'
'401':
description: Session expired.
content:
application/json:
schema:
$ref: '#/components/schemas/Error'
'403':
description: Access forbidden.
content:
application/json:
schema:
$ref: '#/components/schemas/Error'
'404':
description: Message not found.
content:
application/json:
schema:
$ref: '#/components/schemas/Error'
'500':
description: Server error.
content:
application/json:
schema:
$ref: '#/components/schemas/Error'
put:
tags:
- ListMemberRewardWin
operationId: updateRewardWin
x-handler: reward_wins/list_member_reward_win/list_member_reward_win_controller.js
x-access:
- administrator
summary: Update the List Member Reward Win.
parameters:
- name: listMemberRewardWinId
in: path
required: true
schema:
type: integer
responses:
'200':
description: List Member Reward Win updated successfully.
content:
application/json:
schema:
$ref: '#/components/schemas/ListMemberRewardWin'
'400':
description: Invalid parameter.
content:
application/json:
schema:
$ref: '#/components/schemas/Error'
'401':
description: Session expired.
content:
application/json:
schema:
$ref: '#/components/schemas/Error'
'403':
description: Access forbidden.
content:
application/json:
schema:
$ref: '#/components/schemas/Error'
'404':
description: Message not found.
content:
application/json:
schema:
$ref: '#/components/schemas/Error'
'500':
description: Server error.
content:
application/json:
schema:
$ref: '#/components/schemas/Error'
requestBody:
content:
application/json:
schema:
$ref: '#/components/schemas/ListMemberRewardWin'
required: true
/list-member-reward-win/bulk-fulfill/options/reward-wins:
post:
tags:
- ListMemberRewardWin
operationId: getRewardWinsForBulkFulfillment
x-handler: reward_wins/list_member_reward_win/list_member_reward_win_controller.js
x-access:
- administrator
summary: Get all reward wins for bulk fulfillment confirmation based on option selection
responses:
'200':
description: An array of reward wins bulk fulfillment based on the selected option.
content:
application/json:
schema:
type: object
properties:
meta:
type: object
properties:
limit:
type: integer
offset:
type: integer
totalCount:
type: integer
paymentAccountType:
type: string
paymentAccountBalance:
type: number
paymentAccountProvider:
type: string
paymentAccountId:
type: number
data:
type: array
items:
type: object
properties:
id:
type: integer
value:
type:
- number
- 'null'
cost:
type:
- number
- 'null'
valueCurrencyCode:
type: string
costCurrencyCode:
type: string
bonusTierCurrencyCode:
type:
- string
- 'null'
bonusTiers:
type:
- array
- 'null'
items:
$ref: '#/components/schemas/BonusTier'
attainedBonusTierIndex:
type:
- integer
- 'null'
type:
type: string
displayType:
type: string
rewardTitle:
type: string
displayName:
type: string
isSelected:
type: boolean
globalUserId:
type: number
listMemberId:
type: number
discountCodeId:
type: string
incentiveId:
type: number
taxLineItems:
type:
- array
- 'null'
items:
type: object
properties:
type:
type: string
amount:
type: number
'400':
description: Invalid parameter.
content:
application/json:
schema:
$ref: '#/components/schemas/Error'
'401':
description: Session expired.
content:
application/json:
schema:
$ref: '#/components/schemas/Error'
'500':
description: Server error
content:
application/json:
schema:
$ref: '#/components/schemas/Error'
requestBody:
content:
application/json:
schema:
type: object
required:
- actionGroupId
properties:
paymentAccountId:
type: integer
globalUserIds:
type: array
items:
type: integer
actionGroupId:
type: integer
queryFilter:
$ref: '#/components/schemas/ActionGroupCandidateQueryFilter'
required: true
/list-member-reward-win/bulk-fulfill/options:
post:
tags:
- ListMemberRewardWin
operationId: getBulkFulfillOptions
x-handler: reward_wins/list_member_reward_win/list_member_reward_win_controller.js
x-access:
- administrator
summary: Get all bulk fulfillment options for a selection of influencers, combine all offline options into one option
responses:
'200':
description: An array of options for bulk fulfillment.
content:
application/json:
schema:
properties:
data:
type: array
items:
$ref: '#/components/schemas/BulkFulfillOption'
'400':
description: Invalid parameter.
content:
application/json:
schema:
$ref: '#/components/schemas/Error'
'401':
description: Session expired.
content:
application/json:
schema:
$ref: '#/components/schemas/Error'
'500':
description: Server error
content:
application/json:
schema:
$ref: '#/components/schemas/Error'
requestBody:
content:
application/json:
schema:
type: object
required:
- actionGroupId
properties:
globalUserIds:
type: array
items:
type: integer
actionGroupId:
type: integer
description: Unique identifier of the actionGroup
queryFilter:
$ref: '#/components/schemas/ActionGroupCandidateQueryFilter'
required: true
/list-member-reward-win/bulk-fulfill/options-all:
post:
tags:
- ListMemberRewardWin
operationId: getAllBulkFulfillOptions
x-handler: reward_wins/list_member_reward_win/list_member_reward_win_controller.js
x-access:
- administrator
summary: Get all bulk fulfillment options for a selection of influencers, splitting all offline options into their own options
responses:
'200':
description: An array of options for bulk fulfillment.
content:
application/json:
schema:
properties:
data:
type: array
items:
$ref: '#/components/schemas/BulkFulfillOption'
'400':
description: Invalid parameter.
content:
application/json:
schema:
$ref: '#/components/schemas/Error'
'401':
description: Session expired.
content:
application/json:
schema:
$ref: '#/components/schemas/Error'
'500':
description: Server error
content:
application/json:
schema:
$ref: '#/components/schemas/Error'
requestBody:
content:
application/json:
schema:
type: object
required:
- actionGroupId
properties:
globalUserIds:
type: array
items:
type: integer
actionGroupId:
type: integer
description: Unique identifier of the actionGroup
queryFilter:
$ref: '#/components/schemas/ActionGroupCandidateQueryFilter'
required: true
/list-member-reward-wins/enriched:
get:
tags:
- ListMemberRewardWin
x-handler: reward_wins/list_member_reward_win/list_member_reward_win_controller.js
x-access:
- administrator
summary: Get enriched list member reward win data by incentive ids. Expects comma-separated string representations of an array of integers.
operationId: getEnrichedListMemberRewardWins
parameters:
- name: rewardWinIds
in: query
required: false
schema:
type: string
- name: cashPaymentIds
in: query
schema:
type: string
responses:
'200':
description: An array of list members with their list member reward wins
content:
application/json:
schema:
properties:
data:
type: array
items:
$ref: '#/components/schemas/EnrichedListMemberRewardWin'
'400':
description: Invalid parameter.
content:
application/json:
schema:
$ref: '#/components/schemas/Error'
'401':
description: Session expired.
content:
application/json:
schema:
$ref: '#/components/schemas/Error'
'403':
description: Invalid API Key
content:
application/json:
schema:
$ref: '#/components/schemas/Error'
'404':
description: Not found.
content:
application/json:
schema:
$ref: '#/components/schemas/Error'
'500':
description: Server error
content:
application/json:
schema:
$ref: '#/components/schemas/Error'
/v1/action-groups/{actionGroupId}/list-member-reward-wins/{globalUserId}:
get:
operationId: getRewardWins
responses:
'200':
description: OK
content:
application/json:
schema:
$ref: '#/components/schemas/GetListMemberRewardWinResponse'
'400':
description: Missing Parameter
content:
application/json:
schema:
$ref: '#/components/schemas/ValidateErrorJSON'
'403':
description: Access Forbidden
content:
application/json:
schema:
$ref: '#/components/schemas/ForbiddenError'
'404':
description: The resource does not exist
content:
application/json:
schema:
$ref: '#/components/schemas/NotFoundError'
'500':
description: Server Error
content:
application/json:
schema:
$ref: '#/components/schemas/ServerError'
tags:
- ListMemberRewardWin
parameters:
- in: path
name: actionGroupId
required: true
schema:
type: number
format: double
- in: path
name: globalUserId
required: true
schema:
type: number
format: double
- in: query
name: includeMostRecentTransaction
required: false
schema:
type: boolean
post:
operationId: createRewardWin
responses:
'200':
description: OK
content:
application/json:
schema:
$ref: '#/components/schemas/ListMemberRewardWinResponse'
'400':
description: Missing Parameter
content:
application/json:
schema:
$ref: '#/components/schemas/ValidateErrorJSON'
'403':
description: Access Forbidden
content:
application/json:
schema:
$ref: '#/components/schemas/ForbiddenError'
'404':
description: The resource does not exist
content:
application/json:
schema:
$ref: '#/components/schemas/NotFoundError'
'500':
description: Server Error
content:
application/json:
schema:
$ref: '#/components/schemas/ServerError'
tags:
- ListMemberRewardWin
parameters:
- in: path
name: actionGroupId
required: true
schema:
type: number
format: double
- in: path
name: globalUserId
required: true
schema:
type: number
format: double
requestBody:
content:
application/json:
schema:
$ref: '#/components/schemas/ListMemberRewardWinRequestBody'
required: true
components:
schemas:
BrandDeprecated:
type: object
properties:
id:
type: integer
description: Unique identifier for a brand.
name:
type: string
description: Name of the brand.
logo:
type: string
accentColor:
type: string
buttonColor:
type: string
associatedWithCampaign:
type: boolean
description: A flag indicating whether this brand has been associated with a campaign. If this is true, then this brand cannot be deleted.
GetRewardWinGlobalUser:
type: object
properties: {}
RewardWin:
type: object
properties:
id:
type: integer
description: Unique identifier for a reward win.
influencerId:
type: integer
influencerFirstName:
type: string
influencerLastName:
type: string
influencerEmail:
type: string
influencerAddress:
type: string
contactInfo:
$ref: '#/components/schemas/MembershipContactInfoDeprecated'
source:
type: string
description: How this RewardWin was generated, e.g. incentive or spot.
incentive:
$ref: '#/components/schemas/IncentiveDeprecated'
rewardTitle:
type: string
description: Title for the associated reward.
rewardImage:
type: string
description: Image of the associated reward.
orderNumber:
type: string
description: For physically-fulfilled rewards, this contains the order number for tracking purposes.
trackingNumber:
type: string
description: For physically-fulfilled rewards, this contains the tracking number of the order.
comment:
type: string
description: Any custom comment associated with this reward win.
verifiedAddress:
type: boolean
description: A flag to track whether an administrator has verified this influencer's email or postal address, depending on the delivery method of the reward.
isFulfilled:
type: boolean
description: A flag informing whether this reward win has been fulfilled yet.
isArchived:
type: boolean
description: A flag informing whether this reward win has been archived. An fulfilled reward win cannot be archived.
fulfilledAt:
type:
- string
- 'null'
format: date-time
description: If the reward win has been fulfilled, this will display the time at which fulfillment occurred.
fulfilledBy:
type: string
description: If the reward win has been fulfilled, this will display the account email of the user who fulfilled it.
fulfillmentStatus:
type: string
type:
type: string
value:
type: number
valueCurrencyCode:
type: string
cost:
type: number
costCurrencyCode:
type: string
description:
type: string
createdBy:
$ref: '#/components/schemas/AdministratorDeprecated'
lastModifiedBy:
$ref: '#/components/schemas/AdministratorDeprecated'
cashPayment:
type: object
properties:
externalId:
type: string
id:
type: integer
giftCardOrder:
type: object
properties:
externalId:
type: string
id:
type: integer
giftCardOption:
type: object
properties:
id:
type: integer
cashPaymentApp:
type: object
properties:
id:
type: integer
provider:
type: string
description: The cash payment app provider of the reward win.
createdAt:
type: string
format: date-time
updatedAt:
type: string
format: date-time
readiedAt:
type: string
format: date-time
completedDate:
type: string
format: date-time
actionGroup:
$ref: '#/components/schemas/ActionGroupDeprecated'
user:
$ref: '#/components/schemas/GlobalUserDeprecated'
cashPaymentAppId:
type:
- integer
- 'null'
description: ID the associated cash payment app.
giftCardOptionId:
type:
- integer
- 'null'
description: ID the associated gift card option.
giftCardEmailTemplateId:
type:
- string
- 'null'
description: ID the associated gift card email template (External Id).
listMemberRewardWin:
type: object
properties:
id:
type: integer
listMemberId:
type: integer
eligibleOnEventType:
type: string
communityId:
type: string
description: The communityId of the reward win.
mostRecentTransaction:
$ref: '#/components/schemas/PaymentsLedger'
discountCodeId:
type:
- string
- 'null'
description: Discount ID for SHOPIFY_DISCOUNT type rewards
discountCodeRedeemId:
type:
- string
- 'null'
description: ID of shopify transaction where a SHOPIFY_DISCOUNT was used
shippingCodeId:
type:
- string
- 'null'
description: Shipping ID for SHOPIFY_DISCOUNT type rewards
shippingCodeRedeemId:
type:
- string
- 'null'
description: ID of shopify transaction where a SHOPIFY_DISCOUNT shipping code was used
couponActivation:
type:
- string
- 'null'
description: Coupon Activation for SHOPIFY_DISCOUNT type rewards
incentiveId:
type:
- string
- 'null'
description: The incentive ID associated with the reward win if used.
invoiceNumber:
type:
- string
- 'null'
description: Invoice number for the reward win
taxId:
type:
- string
- 'null'
description: Tax ID for the reward win
bonusTierCurrencyCode:
type:
- string
- 'null'
bonusTiers:
type:
- array
- 'null'
description: Sorted tiered bonus payout ladder
items:
$ref: '#/components/schemas/BonusTier'
attainedBonusTierIndex:
type:
- integer
- 'null'
description: Zero-based index of the tier attained when this reward win was fulfilled
taxLineItems:
type:
- array
- 'null'
items:
type: object
properties:
type:
type: string
description: 'Type of the tax item: GST, HST, VAT, PST, QST'
amount:
type: number
description: Amount of the tax item
CreationOptional_number_:
type: object
properties: {}
description: 'This is a Branded Type.
You can use it to tag attributes that can be ommited during Model Creation.
For use with {@link InferCreationAttributes}.'
PreviewPostDeprecated:
type: object
properties:
id:
type: integer
postId:
type: string
network:
type: string
likes:
type: integer
comments:
type: integer
views:
type: integer
shares:
type: integer
caption:
type: string
imageUrl:
type: string
link:
type: string
isSponsored:
type: boolean
mentions:
type: array
items:
type: string
activation:
$ref: '#/components/schemas/ActivationDeprecated'
postedTime:
type: string
format: date-time
visualSafeSearch:
$ref: '#/components/schemas/VisualSafeSearchDeprecated'
textSafeSearch:
$ref: '#/components/schemas/TextSafeSearchDeprecated'
ReviewFormResponseDeprecated:
type: object
properties:
globalUserId:
type: integer
membershipId:
type: integer
description: Unique Identifier for the membership
rating:
type: integer
description: Review rating
reviewCharacterCount:
type: integer
description: Sum of the character count in the review
fullName:
type: string
description: Name of the influencer
profilePic:
type: string
description: Profile picture of the influencer
questionResponses:
type: array
items:
$ref: '#/components/schemas/QuestionResponseDeprecated'
createdAt:
type: string
format: date-time
reviewForm:
$ref: '#/components/schemas/ReviewFormDeprecated'
product:
$ref: '#/components/schemas/ProductDeprecated'
ListDeliverable:
properties:
contentType:
$ref: '#/components/schemas/NetworkSlug'
contentTypeName:
$ref: '#/components/schemas/NetworkName'
count:
type: number
format: double
id:
type: number
format: double
listId:
type: number
format: double
updatedBy:
type: number
format: double
required:
- contentType
- contentTypeName
- count
- id
- listId
type: object
additionalProperties: false
IncentiveClaimDeprecated:
type: object
properties:
id:
type: integer
description: Unique identifier for the incentive claim.
membershipId:
type: integer
x-access:
- administrator
- root
globalUserId:
type: integer
x-access:
- administrator
- root
promocode:
type: string
description: The issuance of a promo code. This is derived either from a static promo code configured as a property of the incentive resource or dynamically from a uploaded list of codes.
createdAt:
format: date-time
type: string
profilePictureLink:
type: string
x-access:
- administrator
- root
firstName:
type: string
x-access:
- administrator
- root
lastName:
type: string
x-access:
- administrator
- root
email:
type: string
x-access:
- administrator
- root
address:
type: string
x-access:
- administrator
- root
age:
type: integer
x-access:
- administrator
- root
gender:
type: string
x-access:
- administrator
- root
facebookFriendCount:
type: integer
x-access:
- administrator
- root
mostRecentRewardFulfilledAt:
type: string
format: date-time
x-access:
- administrator
- root
engagementCount:
type: integer
clickCount:
type: integer
conversionCount:
type: integer
Pick_CashPaymentApp.id-or-provider_:
properties:
id:
$ref: '#/components/schemas/CreationOptional_number_'
provider:
type: string
required:
- id
- provider
type: object
description: From T, pick a set of properties whose keys are in the union K
UserQuestionResponse:
type: object
properties:
id:
type: integer
responseValue:
type: string
responseType:
type: string
dataPointDefinition:
$ref: '#/components/schemas/DataPointDefinitionDeprecated'
FacebookProfileDeprecated:
type: object
properties:
id:
type: integer
facebookExternalId:
type: string
name:
type: string
link:
type: string
picture:
type: string
reach:
type: integer
averageLikes:
type: integer
averageComments:
type: integer
averageEngagements:
type: integer
engagementRate:
type: number
type:
type: string
available:
type: boolean
active:
type: boolean
expiresAt:
type: string
format: date-time
facebookUser:
type: object
properties:
isExpired:
type: boolean
InfluencerDataPointCriteriaDeprecated:
type: object
required:
- key
properties:
key:
type: string
value:
type:
- string
- boolean
- integer
values:
type: array
items:
type: string
minValue:
type: integer
maxValue:
type: integer
LinksDeprecated:
type: object
x-access:
- anonymous
- influencer
properties:
normal:
type: string
description: A normal link to an entity.
deep:
type: string
description: A deep link to the entity.
EventType:
enum:
- MANUAL
- ACCEPTANCE
- COMPLETION
- PENDING_CONTENT
- PENDING_PAYMENT
type: string
NotFoundError:
properties:
message:
type: string
enum:
- Resource Not Found
details:
properties: {}
additionalProperties:
additionalProperties: true
type: object
required:
- message
- details
type: object
additionalProperties: false
WorkflowStatusRequirementDeprecated:
type: object
properties:
satisfied:
type: boolean
incentiveId:
type: number
name:
type: string
PaymentAccountType:
enum:
- CASH
- GIFT_CARD
type: string
PaymentAppProvider:
enum:
- PAYPAL
- STRIPE
- TANGO_CARDS
- MAVELY
- TIPALTI
type: string
TikTokCreatorDeprecated:
type: object
properties:
displayName:
type: string
followersCount:
type: integer
globalUserId:
type: integer
handleName:
type: string
insightsUpdatedAt:
type: string
format: date-time
isActive:
type: boolean
profileImage:
type: string
status:
type: string
tiktokAccessGrant:
type: object
audiencePredominantAgeRange:
type: string
audiencePredominantCountry:
type: string
audiencePredominantDevice:
type: string
audiencePredominantGender:
type: string
audiencePredominantLocale:
type: string
ListMemberRewardWin:
type: object
properties:
id:
type: integer
membershipId:
type: i
# --- truncated at 32 KB (204 KB total) ---
# Full source: https://raw.githubusercontent.com/api-evangelist/mavrck/refs/heads/main/openapi/mavrck-listmemberrewardwin-api-openapi.yml