# Create volume based tiers

| HTTP method | Endpoint                                                            |
| ----------- | ------------------------------------------------------------------- |
| **POST**    | **/v1/affiliate\_payouts/{affiliate\_payout\_id}/affiliate\_tiers** |

**NOTE: Volume Based Tiers only used for CPA, CPS and CPA+CPS,and the affiliate payout ，when offers pricing type is CPC cannot create Volume Based Tiers.**

***In the case of Offer pricing type be CPC, event\_id assignment and Volume Based Tiers would be unavailable. Volume Based Tiers is only available if event\_id=1.***

## Path parameters <a href="#path-parameters" id="path-parameters"></a>

| Parameter             | Description                             |
| --------------------- | --------------------------------------- |
| affiliate\_payout\_id | The unique id for the affiliate payout. |

## Request body parameters <a href="#request-body-parameters-0" id="request-body-parameters-0"></a>

| Field                | Type    | Description                                                                                              | Nullable |
| -------------------- | ------- | -------------------------------------------------------------------------------------------------------- | -------- |
| user\_id             | integer |                                                                                                          | No       |
| time\_interval\_type | integer | Time interval type. 1: Daily ; 2: Weekly ;  3: Monthly                                                   | No       |
| effective\_time      | string  | When Time Interval Type value is 0 that Custom time can be active.Print type of time must be :YYYY-MM-DD |          |
| expiration\_time     | string  | When Time Interval Type value is 0 that Custom time can be active.Print type of time must be :YYYY-MM-DD |          |
| tier\_item           |         |                                                                                                          | No       |
| volume\_caps         | integer | Volume Caps.                                                                                             | No       |
| payout               | string  | Payout.                                                                                                  |          |
| percent\_payout      | string  | Percent payout.                                                                                          |          |

## Response body parameters <a href="#response-body-parameters-0" id="response-body-parameters-0"></a>

| Field                | Type    | Description                                            |
| -------------------- | ------- | ------------------------------------------------------ |
| offer\_id            | integer | Offer id.                                              |
| affiliate\_id        | integer | Affiliate id.                                          |
| user\_id             | integer | User id.                                               |
| time\_interval\_type | integer | Time interval type. 1: Daily ; 2: Weekly ;  3: Monthly |
| effective\_time      | integer | Effective time.                                        |
| expiration\_time     | integer | Expiration time.                                       |
| create\_time         | integer | Create time.                                           |
| tier\_item           |         |                                                        |
| volume\_caps         | integer | Volume Based Tiers Volume Caps.                        |
| payout               | string  | Volume Based Tiers Payout.                             |
| percent\_payout      | string  | Percent payout.                                        |
| sort                 | integer | Volume Based Tiers Sort.                               |
| range                | string  | Volume Based Tiers Range.                              |

## Example request <a href="#example-request-0" id="example-request-0"></a>

**Request POST** <https://{networkname}.api.offerslook.com/v1/affiliate_payouts/8/affiliate_tiers>

**Request POST** <http://{networkname}.api.offerslook.com/v1/affiliate_payouts/8/affiliate_tiers>

```
    {
      "user_id": 1,
      "time_interval_type": 0,
      "effective_time": "2016-09-03",
      "expiration_time": "2016-10-03",
      "tier_item": [
        {
          "volume_caps": "150",
          "payout": "34",
          "percent_payout": "10"
        },
        {
          "volume_caps": 100,
          "payout": 43,
          "percent_payout": "10"
        }
      ]
    }
```

## Example response <a href="#example-response-0" id="example-response-0"></a>

```
    {
      "code": 0,
      "message": "Success",
      "data": {
        "affiliate_tier": {
          "offer_id": 3,
          "affiliate_id": 6,
          "user_id": 1,
          "time_interval_type": 0,
          "effective_time": 1472832000,
          "expiration_time": 1475510399,
          "create_time": 1467615990,
          "tier_item": [
            {
              "volume_caps": 100,
              "payout": 34,
              "percent_payout": "10",
              "sort": 1,
              "range": "1-100"
            },
            {
              "volume_caps": 150,
              "payout": 43,
              "percent_payout": "10",
              "sort": 2,
              "range": "101-∞"
            }
          ]
        }
      }
    }
```