POST
/
list-prices
curl --request POST \
  --url https://eu.sequencehq.com/api/list-prices \
  --header 'Authorization: <authorization>' \
  --header 'Content-Type: application/json' \
  --data '{
  "productId": "d07037d5-3e31-4c3a-a360-e58555e2bf44",
  "name": "Sample product",
  "currency": "GBP",
  "structure": {
    "tiers": [
      {
        "upperBound": "200",
        "price": "1.00",
        "fee": "50.00",
        "isPricePercentage": false
      },
      {
        "upperBound": "400",
        "price": "0.75",
        "fee": "25.00",
        "isPricePercentage": false
      },
      {
        "price": "0.50",
        "fee": "0.00",
        "isPricePercentage": false
      }
    ],
    "usageMetricId": "04c62961-04ba-48e6-b985-758bb7d3e712",
    "usageCalculationMode": "BILLING_PERIOD",
    "pricingType": "GRADUATED"
  },
  "billingFrequency": "MONTHLY",
  "billingType": "IN_ARREARS",
  "integrationIds": [
    {
      "service": "Xero",
      "id": "123"
    }
  ],
  "customMetricParameters": [
    {
      "parameterId": "94703530-1293-479b-bd37-ccad42fd9c8b",
      "value": "10"
    }
  ],
  "usageCalculationPeriod": {
    "frequency": "QUARTERLY",
    "interval": 1
  }
}'
{
  "id": "b4d7e884-e007-4183-8355-4771865c5100",
  "productId": "f409d651-c475-4142-aafd-a5d2bd74d4f9",
  "name": "Sample product",
  "currency": "GBP",
  "structure": {
    "tiers": [
      {
        "upperBound": "200",
        "price": "1.00",
        "fee": "50.00",
        "isPricePercentage": false
      },
      {
        "upperBound": "400",
        "price": "0.75",
        "fee": "25.00",
        "isPricePercentage": false
      },
      {
        "price": "0.50",
        "fee": "0.00",
        "isPricePercentage": false
      }
    ],
    "usageMetricId": "04c62961-04ba-48e6-b985-758bb7d3e712",
    "usageCalculationMode": "BILLING_PERIOD",
    "pricingType": "GRADUATED"
  },
  "billingFrequency": "MONTHLY",
  "usageCalculationPeriod": {
    "frequency": "QUARTERLY",
    "interval": 1
  },
  "billingType": "IN_ARREARS",
  "createdAt": "2021-08-25T12:00:00Z",
  "updatedAt": "2021-08-25T12:00:00Z",
  "integrationIds": [
    {
      "service": "Xero",
      "id": "123",
      "isPending": false
    }
  ],
  "customMetricParameters": [
    {
      "parameterId": "2963e49a-c8e0-4673-89f5-7a805c0faf14",
      "value": "10"
    }
  ]
}

Headers

​
Authorization
string
required

Your API credentials. Eg. Basic {credentials}.

​
Sequence-Version
enum<string>

Use this header to select an API version

Available options:
2024-07-30

Body

application/json
​
productId
string
required

The related product ID

​
name
string
required

The customer-facing name of this list price

​
currency
enum<string>
required

The pricing currency

Available options:
ARS,
AUD,
BRL,
CAD,
CHF,
CNY,
COP,
CZK,
DKK,
EUR,
GBP,
HKD,
ILS,
JPY,
KRW,
MXN,
NOK,
NZD,
PLN,
SEK,
SGD,
THB,
USD,
UYU,
ZAR
​
structure
object
required

The pricing structure

​
billingFrequency
enum<string>
required

The recurrence of charging this price.

Available options:
ON_DEMAND,
ONE_TIME,
MONTHLY,
QUARTERLY,
YEARLY
​
billingType
enum<string>
required

How to bill this price: in-arrears or in-advance.

Available options:
IN_ARREARS,
IN_ADVANCE
​
integrationIds
object[]
required

Alternate IDs for this price in third-party integration systems

​
customMetricParameters
object[]
required

Specific parameters to influence usage calculation for this price, and are only required when using a custom metric. Please speak to your Sequence contacts for further information prior to usage.

Response

201 - application/json
​
id
string
required

Unique ID

​
productId
string
required

The related product ID

​
name
string
required

The customer-facing name of this list price

​
currency
enum<string>
required

The pricing currency

Available options:
ARS,
AUD,
BRL,
CAD,
CHF,
CNY,
COP,
CZK,
DKK,
EUR,
GBP,
HKD,
ILS,
JPY,
KRW,
MXN,
NOK,
NZD,
PLN,
SEK,
SGD,
THB,
USD,
UYU,
ZAR
​
structure
object
required

The pricing structure

​
billingFrequency
enum<string>
required

The recurrence of charging this price.

Available options:
ON_DEMAND,
ONE_TIME,
MONTHLY,
QUARTERLY,
YEARLY
​
billingType
enum<string>
required

How to bill this price: in-arrears or in-advance.

Available options:
IN_ARREARS,
IN_ADVANCE
​
createdAt
string
required

Creation timestamp. Formatted as an ISO 8601 timestamp.

​
updatedAt
string
required

Timestamp when price was last updated. Formatted as an ISO 8601 timestamp.

​
integrationIds
object[]
required

Alternate IDs for this price in third-party integration systems

​
customMetricParameters
object[]
required

Specific parameters to influence usage calculation for this price, and are only required when using a custom metric. Please speak to your Sequence contacts for further information prior to usage.

List all list pricesGet a list price