GET /api/:space/competitions/simple

Description:

Returns a simplified list of Competitions.

Resource URL:

https://<apphost>.competitionlabs.com/api/<your-space-name>/competitions/simple

Request header

KeyValueRequired
X-API-KEY
Your unique API keyYes
Content-Type
application/jsonYes

Request URL parameter

Parameter
Type
Required
Description
space
StringYesThis is the space name which is linked to the account

Additional Query String Parameters

You can use the query parameters along with the generic parameters.

Query parameters

Parameter
Type
Constraint
Usage
competitionType
StringCase sensitive
?competitionType=search_word (you can find the Enum list in the Competitions model)
entrantMemberType
String

Case sensitive

?entrantMemberType=search_word (you can find the Enum list in the Competitions model)
numberOfRounds
IntegerNumbers only
?numberOfRounds=search_number
numberOfGroupStages
Integer

Numbers only

?numberOfGroupStages=search_number
label
String

Case insensitive. 

For lookup you would use "label.raw=search_word" because the field "label" is indexed to support more complex searches

?label.raw=search_word
description
StringCase sensitive
?description=search_word
termsConditions
StringCase sensitive
?termsConditions=search_word
options
ObjectComplex search applies, allows full search on a complex object of Option
?options.numberOfEntrants.minimum=search_number
?options.numberOfEntrants.maximum=search_number
?options.products.name.raw=search_word
?options.products.productType=search_word
?options.products._searchFields=description&_searchFor=search_word
?options.products.adjustmentFactor=search_number
?options.products.productRefId=search_word
?options.products.actionAdjustmentFactors.ruleActionHelper.key=search_word
?options.products.actionAdjustmentFactors.adjustmentFactor=search_number
?options.products.metadata.key=search_word
?options.products.metadata.value=search_number
?options.products.created=search_DateTime
?options.products.id=search_string
?options.ruleSets.priority=search_number
?options.ruleSets.scope=search_word
?options.ruleSets.action=search_word
?options.ruleSets.conditions.matchCondition=search_word (you can find the Enum list in the MainConditionSet model)
?options.ruleSets.conditions.mustEvaluateTo=search_word
?options.ruleSets.conditions.rules.fact=search_word
?options.ruleSets.conditions.rules.operator=search_word
?options.ruleSets.conditions.rules.constant=search_word
?options.ruleSets.conditions.rules.id=search_string
?options.ruleSets.conditions.rules.subConditions.matchCondition=search_word (you can find the Enum list in the SubConditionSet model)
?options.ruleSets.conditions.rules.subConditions.musteEvaluateTo=search_word
?options.ruleSets.conditions.rules.subConditions.subRules.fact=search_word
?options.ruleSets.conditions.rules.subConditions.subRules.operator=search_word
?options.ruleSets.conditions.rules.subConditions.subRules.constant=search_word
?options.scheduledDates.start=search_DateTime
?options.scheduledDates.end=search_DateTime
?options.actualDates.start=search_DateTime
?options.actualDates.end=search_DateTime
?options.limitEntrantsTo=search_word
?options.optinRequiredForEntrans=search_word
?option.notification.messageid=search_string
?options.notification.competitionStatus=seach_word (you can find the Enum list in the Notification model)
?options.notification.contestStatus=search_word (you can find the Enum list in the Notification model)
metadata
Array [Object]Complex search applies, allows full search on a complex object of Metadata
?metadata.key=search_word
?metadata.value=search_number
status
StringCase sensitive
?status=search_word (you can find the Enum list in the Competitions model)
statusCode
IntegerNumbers only
?statusCode=search_number (you can find the Enum list in the Competitions model)
created
DateTimeWorks with simple dates or date and time, eg: created=2016-02-07, created=2018-08-23T14:23:09
?created=search_DateTime
id
StringCase sensitive
?id=search_string

CodeHTTP StatusDescriptionExample
1007404Competition with CL-compId not found for the accountId