Billing price list entry line tiers

A billing price list entry line tier defines the starting quantity and price for a single tier in a billing price list entry line.

List billing price list entry line tiers

get/objects/contracts/billing-price-list-entry-line-tier

Returns up to 100 object references from the collection with a key, ID, and link for each tier. This operation is mostly for use in testing; use the query service to find objects that meet certain criteria and to specify properties that are returned.

SecurityOAuth2
Responses
200

OK

400

Bad Request

Request samples
Response samples
application/json
{
  • "ia::result": [
    • {
      • "key": "1",
      • "id": "1",
      • "href": "/objects/contracts/billing-price-list-entry-line-tier/1"
      },
    • {
      • "key": "2",
      • "id": "2",
      • "href": "/objects/contracts/billing-price-list-entry-line-tier/2"
      },
    • {
      • "key": "3",
      • "id": "3",
      • "href": "/objects/contracts/billing-price-list-entry-line-tier/3"
      },
    • {
      • "key": "4",
      • "id": "4",
      • "href": "/objects/contracts/billing-price-list-entry-line-tier/4"
      }
    ],
  • "ia::meta": {
    • "totalCount": 4,
    • "start": 1,
    • "pageSize": 100,
    • "next": null,
    • "previous": null
    }
}

Create a billing price list entry line tier

post/objects/contracts/billing-price-list-entry-line-tier

Creates a new billing price list entry line tier.

SecurityOAuth2
Request
Request Body schema: application/json
required

Billing price list entry tier to create

beginQuantity
required
string

Begin quantity. Use 0 for the first tier.

Example: "0"
tierRate
required
string

Tier rate.

Example: "850"
object

The billing-price-list-entry-line object that this tier is owned by.

key
string

Billing price list entry line key.

Example: "1"
Responses
201

Created

400

Bad Request

Request samples
application/json
{
  • "billingPriceListEntryLine": {
    • "key": "4"
    },
  • "beginQuantity": "0",
  • "tierRate": "860"
}
Response samples
application/json
{
  • "ia::result": {
    • "key": "22",
    • "id": "22",
    • "href": "/objects/contracts/billing-price-list-entry-line-tier/22"
    },
  • "ia::meta": {
    • "totalCount": 1,
    • "totalSuccess": 1,
    • "totalError": 0
    }
}

Get a billing price list entry line tier

get/objects/contracts/billing-price-list-entry-line-tier/{key}

Returns detailed information for a specified billing price list entry line tier.

SecurityOAuth2
Request
path Parameters
key
required
string

System-assigned unique key for a billing price list entry line tier.

Example: 32195
Responses
200

OK

400

Bad Request

Request samples
Response samples
application/json
{
  • "ia::result": {
    • "key": "1",
    • "id": "1",
    • "billingPriceListEntryLine": {
      • "key": "4",
      • "id": "4",
      • "href": "/objects/billing-price-list-entry-line/4"
      },
    • "beginQuantity": "0",
    • "tierRate": "850",
    • "audit": {
      • "modifiedDateTime": "2025-01-16T23:12:22Z",
      • "createdDateTime": "2024-05-13T18:22:36Z",
      • "createdByUser": {
        },
      • "createdBy": "1",
      • "modifiedByUser": {
        },
      • "modifiedBy": "109"
      },
    • "href": "/objects/contracts/billing-price-list-entry-line-tier/1"
    },
  • "ia::meta": {
    • "totalCount": 1,
    • "totalSuccess": 1,
    • "totalError": 0
    }
}

Update a billing price list entry line tier

patch/objects/contracts/billing-price-list-entry-line-tier/{key}

Updates an existing billing price list entry line tier by setting field values. Any fields not provided remain unchanged.

SecurityOAuth2
Request
path Parameters
key
required
string

System-assigned unique key for a billing price list entry line tier.

Example: 32195
Request Body schema: application/json
beginQuantity
string

Begin quantity. Use 0 for the first tier.

Example: "0"
tierRate
string

Tier rate.

Example: "850"
object

The billing-price-list-entry-line object that this tier is owned by.

key
string

Billing price list entry line key.

Example: "1"
Responses
200

OK

400

Bad Request

Request samples
application/json
{
  • "beginQuantity": "0",
  • "tierRate": "850"
}
Response samples
application/json
{
  • "ia::result": {
    • "key": "32069",
    • "id": "32069",
    • "href": "/objects/contracts/billing-price-list-entry-line/32069"
    },
  • "ia::meta": {
    • "totalCount": 1,
    • "totalSuccess": 1,
    • "totalError": 0
    }
}

Delete a billing price list entry line tier

delete/objects/contracts/billing-price-list-entry-line-tier/{key}

Deletes a billing price list entry line tier.

SecurityOAuth2
Request
path Parameters
key
required
string

System-assigned unique key for a billing price list entry line tier.

Example: 32195
Responses
204

No Content

400

Bad Request

Request samples
Response samples
application/json
{
  • "ia::result": {
    • "ia::error": {
      • "code": "invalidRequest",
      • "message": "A POST request requires a payload",
      • "errorId": "REST-1028",
      • "additionalInfo": {
        },
      • "supportId": "Kxi78%7EZuyXBDEGVHD2UmO1phYXDQAAAAo"
      }
    },
  • "ia::meta": {
    • "totalCount": 1,
    • "totalSuccess": 0,
    • "totalError": 1
    }
}