Get Recipient by Recipient ID

Endpoint: https://rest.virtualincentives.com/{version}/{format}/recipients/{id}

Method: GET

Definitions

FieldTypeDescription
idresponse only
integer
Unique Account Holder ID.
emailrequired
string(200)
Account holder email address.

Note: For anonymous rewards, please use a generic support email address, such as [email protected].
firstnamerequired
string(50)
Account holder first name.

Note: This field is displayed in the email and VRC salutation. For anonymous rewards, please use a generic name such as “Participant” or “Recipient”.
lastnamerequired
string(50)
Account holder last name.

Note: For anonymous rewards, please use a generic name such as “Participant” or “Recipient”.
skurequired
string(50)
Virtual prepaid product SKU requested.

Note: SKU document delivered separately.
amountrequired
decimal
The amount Denomination of the reward being issued.

Note: Currency is determined by the SKU requested.
address1string(100)Account holder address line 1.
address2string(50)Account holder address line 2.
citystring(50)Account holder city.
statestring(20)Account holder state abbreviation (ISO 3166-2, subdivision).
zipstring(10)Account holder zip code.
countrystring(2)Account holder country abbreviation (ISO 3166-2).
udf1string(100)Additional User Defined field.

Note: See ‘udf1’ for definition.
udf2string(100)Additional User Defined field.

Note: See ‘udf1’ for definition.
udf3string(1000)Additional User Defined field.

Note: See ‘udf1’ for definition.
udf4string(1000)Additional User Defined field.

Note: See ‘udf1’ for definition.
udf5string(1000)Additional User Defined field.

Note: See ‘udf1’ for definition.
udf6string(4000)Additional User Defined field.

Note: See ‘udf1’ for definition.
udf7string(4000)Additional User Defined field.

Note: See ‘udf1’ for definition.
udf8string(4000)Additional User Defined field.

Note: See ‘udf1’ for definition.
udf9string(4000)Additional User Defined field.

Note: See ‘udf1’ for definition.
udf10string(4000)Additional User Defined field.

Note: See ‘udf1’ for definition.
linkresponse only
string(250)
Redemption link returned upon successful account creation.

Examples

XML Example

<recipient>
  <id>258155</id>
  <firstname>Reward</firstname>
  <lastname>Recipient</lastname>
  <email>[email protected]</email>
  <address1>1401 rte 52</address1>
  <address2>suite 101B</address2>
  <city>Fishkill</city>
  <state>NY</state>
  <zip>12524</zip>
  <country>US</country>
  <sku>UVC-V-P18</sku>
  <amount>10.00</amount>
  <udf1>Sample</udf4>
<link>https://www2.virtualrewardcenter.com/landing?id=258155&amp;sid=7EC30816-7B7E-0133-1E76-12FC32977705</link>
</recipient>

JSON Example

{"recipient":{

"Id":"258155",
"firstname":"Reward",
"lastname":"Recipient",
"email":"[email protected]",
"address1":"1401 rte 52",
"Address2":"suite 101B",
"city":"Fishkill",
"state":"NY",
"Zip":"12524",
"country":"US",
"sku":"UVC-V-P18",
"Amount":"10.00",
"udf1":"Sample",
"link":"https://www2.virtualrewardcenter.com/landing?id=258155&sid=7EC30816-7B7E-0133-1E76-12FC32977705"}}