Reward Categories


Request Details

Item Value
Description Returns the list of reward categories.
Method GET
Endpoint https://api.crowdtwist.com/v2/reward_categories?api_key=[api_key]


Request

Field Name Sample Value Required Format Notes
URL PARAMETERSnone
QUERY STRING PARAMETERS
api_key QWERTYUIOP Yes String  


Successful Response

Field Name Sample Value Required Format Description
id 64 Yes   Internal CrowdTwist Activity ID
name Digital Wallpaper Yes   Reward Category Name


Error Response

Field Name Sample Value Required Format Description
error invalid_auth Yes String A machine readable code that describes the error.
message Invalid access credentials. Yes String A short, descriptive sentence detailing the error.


Error Response Codes

Error Message
input_error The input provided in invalid or formatted incorrectly.
internal_error Something went wrong on our end.
page_not_found The requested page does not exist or has been removed.
param_error A missing or invalid parameter is included in the request.


Sample Request

curl -X GET
https://api.crowdtwist.com/v2/reward_categories?api_key=QWERTYUIOP
curl -X GET
https://api.crowdtwist.com/v2/reward_categories?api_key=QWERTYUIOP


Sample Successful Response: Status Code 200

[
  {
    "id": "1234",
    "name": "Digital Rewards"
  },
  {
    "id": "2345",
    "name": "Digital Wallpaper"
  },
  {
    "id": "3456",
    "name": "Sweepstakes"
  },
  {
    "id": "4567",
    "name": "Merchandise"
  },
  {
    "id": "5678",
    "name": "Social"
  }
]
[
  {
    "id": "1234",
    "name": "Digital Rewards"
  },
  {
    "id": "2345",
    "name": "Digital Wallpaper"
  },
  {
    "id": "3456",
    "name": "Sweepstakes"
  },
  {
    "id": "4567",
    "name": "Merchandise"
  },
  {
    "id": "5678",
    "name": "Social"
  }
]

Sample Error Response: Status Code 400

{
  "error": "invalid_auth",
  "message": "Invalid access credentials."
}
{
	"error": "invalid_auth",
	"message": "Invalid access credentials."
}