GET api/Rewards

Gets a list of rewards ordered by create date. The offset and count parameters can be used to specify the set of referrals.

Request Information

URI Parameters

Query String: programId={programId}&query={query}&status={status}&offset={offset}&count={count}

NameDescriptionTypeAdditional information
programId

ID of the program. Optional.

string

None.

query

If specified, the recipient must have this value as its email address, id, or external id. You can also query by member referral code, program id, program name, or program title. Optional.

string

None.

status

If specified, the rewards must be in this status. Accepted values are 'Pending', 'Processing', and 'Issued'. Optional

string

None.

offset

Starting index (0 based) of the referrals. Optional.

integer

Default value is 0

count

Count of referrals rewards. Optional.

integer

Default value is 2147483647

Body Parameters

None.

Response Information

Resource Description

[HTTP Status 200 - OK] A set of rewards.

Type: RewardSet

NameDescriptionTypeAdditional information
rewards

Collection of Reward

None.

offset

Starting index (0 based) of the elements in the set.

integer

None.

total

Total number of elements in the set.

integer

None.

message

The message provides more information about the results of the client's request. Review this field for error information.

string

None.

Response Formats

application/json, text/json

Sample:
{
  "offset": 1,
  "total": 2,
  "message": "sample string 3",
  "rewards": [
    {
      "id": "3695b69c-77b8-4cad-96ee-987ee5e26c5f",
      "payoutId": "caeed09a-81e5-4e53-84fc-87165d9b96b3",
      "payoutDescription": "sample string 3",
      "programId": "712db138-4931-4086-9267-91abf5d2fe86",
      "programName": "sample string 5",
      "memberId": "cc9a97e1-3986-4752-bfe4-83a25b7a4dd8",
      "referralId": "13c25583-69bf-4976-86d5-a0d244660716",
      "type": "sample string 6",
      "recipientId": "a598a546-98ba-4a04-a290-01a8b334cfe4",
      "recipientName": "sample string 7",
      "recipientEmailAddress": "sample string 8",
      "status": "sample string 9",
      "amount": 10.0,
      "createDate": "2018-01-22T19:05:01.3031189Z",
      "issueDate": "2018-01-22T19:05:01.3031189Z",
      "eligibilityDate": "2018-01-22T19:05:01.3031189Z",
      "description": "sample string 13"
    },
    {
      "id": "3695b69c-77b8-4cad-96ee-987ee5e26c5f",
      "payoutId": "caeed09a-81e5-4e53-84fc-87165d9b96b3",
      "payoutDescription": "sample string 3",
      "programId": "712db138-4931-4086-9267-91abf5d2fe86",
      "programName": "sample string 5",
      "memberId": "cc9a97e1-3986-4752-bfe4-83a25b7a4dd8",
      "referralId": "13c25583-69bf-4976-86d5-a0d244660716",
      "type": "sample string 6",
      "recipientId": "a598a546-98ba-4a04-a290-01a8b334cfe4",
      "recipientName": "sample string 7",
      "recipientEmailAddress": "sample string 8",
      "status": "sample string 9",
      "amount": 10.0,
      "createDate": "2018-01-22T19:05:01.3031189Z",
      "issueDate": "2018-01-22T19:05:01.3031189Z",
      "eligibilityDate": "2018-01-22T19:05:01.3031189Z",
      "description": "sample string 13"
    }
  ]
}

application/xml, text/xml

Sample:
<RewardSet xmlns:i="http://www.w3.org/2001/XMLSchema-instance">
  <offset>1</offset>
  <total>2</total>
  <message>sample string 3</message>
  <rewards>
    <reward>
      <id>3695b69c-77b8-4cad-96ee-987ee5e26c5f</id>
      <payoutId>caeed09a-81e5-4e53-84fc-87165d9b96b3</payoutId>
      <payoutDescription>sample string 3</payoutDescription>
      <programId>712db138-4931-4086-9267-91abf5d2fe86</programId>
      <programName>sample string 5</programName>
      <memberId>cc9a97e1-3986-4752-bfe4-83a25b7a4dd8</memberId>
      <referralId>13c25583-69bf-4976-86d5-a0d244660716</referralId>
      <type>sample string 6</type>
      <recipientId>a598a546-98ba-4a04-a290-01a8b334cfe4</recipientId>
      <recipientName>sample string 7</recipientName>
      <recipientEmailAddress>sample string 8</recipientEmailAddress>
      <status>sample string 9</status>
      <amount>10</amount>
      <createDate>2018-01-22T14:05:01.3031189-05:00</createDate>
      <issueDate>2018-01-22T14:05:01.3031189-05:00</issueDate>
      <eligibilityDate>2018-01-22T14:05:01.3031189-05:00</eligibilityDate>
      <description>sample string 13</description>
    </reward>
    <reward>
      <id>3695b69c-77b8-4cad-96ee-987ee5e26c5f</id>
      <payoutId>caeed09a-81e5-4e53-84fc-87165d9b96b3</payoutId>
      <payoutDescription>sample string 3</payoutDescription>
      <programId>712db138-4931-4086-9267-91abf5d2fe86</programId>
      <programName>sample string 5</programName>
      <memberId>cc9a97e1-3986-4752-bfe4-83a25b7a4dd8</memberId>
      <referralId>13c25583-69bf-4976-86d5-a0d244660716</referralId>
      <type>sample string 6</type>
      <recipientId>a598a546-98ba-4a04-a290-01a8b334cfe4</recipientId>
      <recipientName>sample string 7</recipientName>
      <recipientEmailAddress>sample string 8</recipientEmailAddress>
      <status>sample string 9</status>
      <amount>10</amount>
      <createDate>2018-01-22T14:05:01.3031189-05:00</createDate>
      <issueDate>2018-01-22T14:05:01.3031189-05:00</issueDate>
      <eligibilityDate>2018-01-22T14:05:01.3031189-05:00</eligibilityDate>
      <description>sample string 13</description>
    </reward>
  </rewards>
</RewardSet>