Get My Bonus

Description

Retrieves your own bonus information.

HTTP Method

GET

Path

/bonuses

Authentication

Requires an authenticated user.

Parameters

No Parameters.

Error Codes

150001 ( Common )

The endpoint requires an authenticated account

80000 ( Bonus )

An unhandled exception has occured.

Response Schema

<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<xs:schema elementFormDefault="qualified" version="1.0" targetNamespace="http://xsd.poken.com" xmlns:tns="http://xsd.poken.com" xmlns:xs="http://www.w3.org/2001/XMLSchema">

  <xs:element name="bonus">
    <xs:complexType>
      <xs:sequence>
        <xs:element name="userStatus" type="tns:UserStatusType"/>
        <xs:element name="bonusTotal" type="xs:double"/>
        <xs:element name="nextStatus" type="tns:UserStatusType"/>
        <xs:element name="requiredPointsForNextStatus" type="xs:double"/>
        <xs:element name="credit" type="xs:double"/>
      </xs:sequence>
    </xs:complexType>
  </xs:element>

  <xs:simpleType name="UserStatusType">
    <xs:restriction base="xs:string">
      <xs:enumeration value="NEW_USER"/>
      <xs:enumeration value="FAN"/>
      <xs:enumeration value="FANATIC"/>
      <xs:enumeration value="PROMOTER"/>
      <xs:enumeration value="PREMIUM"/>
      <xs:enumeration value="AFFILIATE"/>
    </xs:restriction>
  </xs:simpleType>
</xs:schema>

Sample Response

<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<bonus xmlns="http://xsd.poken.com">
  <userStatus>NEW_USER</userStatus>
  <bonusTotal>8.0</bonusTotal>
  <nextStatus>FAN</nextStatus>
  <requiredPointsForNextStatus>92.0</requiredPointsForNextStatus>
  <credit>8.0</credit>
</bonus>