Price Plan V2
List rate cards of a price plan
Introduction
APIs
- Authentication
- Customers
- Accounts
- Aliases
- Event Schemas
- Usage Meters
- AddOns
- Licenses
- Feature
- (Deprecated) Price Plans
- Price Plan V2
- GETList price plans
- POSTCreate a price plan
- GETGet a price plan
- PATCHUpdate a price plan
- DELDiscard a price plan
- POSTFinalize a price plan
- GETList rate cards of a price plan
- POSTBulk rate card operations of a price plan
- GETList pricing rules of a price plan
- PUTUpdate pricing rules of a price plan
- GETGet list of errors of a price plan
- GETList price plan versions
- POSTCreate a price plan v2 migration
- GET
- Settings
- Price Experimentation
- Jobs
- Event Ingestion
- Entitlements
- Event Management
- Metrics
- Credits
- Invoices
- Payments
- Wallet
- InvoiceGroups
- Alerts
- Reports
Price Plan V2
List rate cards of a price plan
List rate cards of a price plan
GET
/
v2
/
price_plans
/
{price_plan_id}
/
rate_cards
curl --request GET \
--url https://api.togai.com/v2/price_plans/{price_plan_id}/rate_cards \
--header 'Authorization: Bearer <token>'
{
"data": [
{
"billableId": "<string>",
"type": "MINIMUM_COMMITMENT",
"displayName": "<string>",
"invoiceTiming": "IN_ADVANCE",
"rateCardDetails": {
"fixedFeeRateCard": {
"id": "<string>",
"displayName": "<string>",
"name": "<string>",
"tag": "<string>",
"invoiceTiming": "IN_ADVANCE",
"type": "ONE_TIME",
"rateValues": [
{
"currency": "<string>",
"rate": 123
}
],
"enableProration": false,
"recurrenceConfig": {
"interval": 3,
"offset": 5
}
},
"billingEntitlementRateCard": {
"featureId": "<string>",
"featureConfigs": [
{
"effectiveFrom": "<string>",
"effectiveUntil": "<string>",
"featureCreditLimit": 1
}
],
"tag": "<string>",
"invoiceTiming": "IN_ADVANCE",
"displayName": "<string>",
"name": "<string>",
"ratePlan": {
"pricingModel": "TIERED",
"slabs": [
{
"order": 5,
"startAfter": 123,
"priceType": "FLAT",
"slabConfig": {}
}
]
},
"rateValues": [
{
"currency": "<string>",
"slabRates": [
{
"order": 123,
"rate": 123,
"slabRateConfig": {}
}
],
"rateConfig": {}
}
],
"recurrenceConfig": {
"interval": 3,
"offset": 5
}
},
"creditGrantRateCard": {
"id": "<string>",
"displayName": "<string>",
"name": "<string>",
"tag": "<string>",
"grantDetails": {
"priority": 1,
"expiryType": "PRICING_CYCLE",
"expiryDuration": "<string>",
"applicableEntityIds": [
"<string>"
]
},
"rateDetails": {
"pricingModel": "TIERED",
"currencySlabRateDetails": [
{
"currency": "<string>",
"creditAmount": 1,
"slabDetails": [
{
"startAfter": 123,
"priceType": "FLAT",
"slabConfig": {},
"rate": 123,
"slabRateConfig": {}
}
],
"rateConfig": {}
}
]
},
"invoiceTiming": "IN_ADVANCE",
"type": "ONE_TIME",
"recurrenceConfig": {
"interval": 3,
"offset": 5
}
},
"usageRateCard": {
"displayName": "<string>",
"name": "<string>",
"tag": "<string>",
"usageMeterId": "um.1zYnCiM9Bpg.1zYn",
"ratePlan": {
"pricingModel": "TIERED",
"slabs": [
{
"order": 5,
"startAfter": 123,
"priceType": "FLAT",
"slabConfig": {}
}
]
},
"rateValues": [
{
"currency": "<string>",
"slabRates": [
{
"order": 123,
"rate": 123,
"slabRateConfig": {}
}
],
"rateConfig": {}
}
]
},
"licenseRateCard": {
"id": "<string>",
"type": "LICENSE",
"displayName": "<string>",
"name": "<string>",
"tag": "<string>",
"invoiceTiming": "IN_ADVANCE",
"usageCycle": "WEEKLY",
"enableProration": false,
"config": {
"maxQuantity": 100,
"maxQuantityBreachAction": "DO_NOTHING"
},
"ratePlan": {
"pricingModel": "TIERED",
"slabs": [
{
"order": 5,
"startAfter": 123,
"priceType": "FLAT",
"slabConfig": {}
}
]
},
"rateValues": [
{
"currency": "<string>",
"slabRates": [
{
"order": 123,
"rate": 123,
"slabRateConfig": {}
}
],
"rateConfig": {}
}
],
"proratedRefundMode": "NONE"
},
"entitlementOverageRateCard": {
"featureId": "<string>",
"displayName": "<string>",
"name": "<string>",
"tag": "<string>",
"maxQuantity": 123,
"ratePlan": {
"pricingModel": "TIERED",
"slabs": [
{
"order": 5,
"startAfter": 123,
"priceType": "FLAT",
"slabConfig": {}
}
]
},
"rateValues": [
{
"currency": "<string>",
"slabRates": [
{
"order": 123,
"rate": 123,
"slabRateConfig": {}
}
],
"rateConfig": {}
}
],
"billingConfig": {
"interval": 3,
"startOffset": 5
}
},
"minimumCommitmentRateCard": {
"displayName": "<string>",
"rateValues": [
{
"currency": "<string>",
"rate": 123
}
]
}
},
"tag": "<string>",
"name": "<string>",
"referenceId": "<string>",
"referenceType": "<string>",
"currencies": [
"<string>"
],
"pricePlanId": "<string>",
"accountId": "<string>"
}
],
"nextToken": "<string>"
}
Authorizations
Bearer authentication header of the form Bearer <token>
, where <token>
is your auth token.
Path Parameters
Maximum length:
50
Example:
"pp.1zYnCiM9Bpg.lv25y"
Query Parameters
Example:
"eyJsYXN0SXRlbUlkIjogInN0cmluZyIsICJwYWdlU2l6ZSI6IDEwMCwgInNvcnRPcmRlciI6ICJhc2MifQ=="
Example:
10
Response
200
application/json
Response for list rate cards request
Paginated response for rate card
curl --request GET \
--url https://api.togai.com/v2/price_plans/{price_plan_id}/rate_cards \
--header 'Authorization: Bearer <token>'
{
"data": [
{
"billableId": "<string>",
"type": "MINIMUM_COMMITMENT",
"displayName": "<string>",
"invoiceTiming": "IN_ADVANCE",
"rateCardDetails": {
"fixedFeeRateCard": {
"id": "<string>",
"displayName": "<string>",
"name": "<string>",
"tag": "<string>",
"invoiceTiming": "IN_ADVANCE",
"type": "ONE_TIME",
"rateValues": [
{
"currency": "<string>",
"rate": 123
}
],
"enableProration": false,
"recurrenceConfig": {
"interval": 3,
"offset": 5
}
},
"billingEntitlementRateCard": {
"featureId": "<string>",
"featureConfigs": [
{
"effectiveFrom": "<string>",
"effectiveUntil": "<string>",
"featureCreditLimit": 1
}
],
"tag": "<string>",
"invoiceTiming": "IN_ADVANCE",
"displayName": "<string>",
"name": "<string>",
"ratePlan": {
"pricingModel": "TIERED",
"slabs": [
{
"order": 5,
"startAfter": 123,
"priceType": "FLAT",
"slabConfig": {}
}
]
},
"rateValues": [
{
"currency": "<string>",
"slabRates": [
{
"order": 123,
"rate": 123,
"slabRateConfig": {}
}
],
"rateConfig": {}
}
],
"recurrenceConfig": {
"interval": 3,
"offset": 5
}
},
"creditGrantRateCard": {
"id": "<string>",
"displayName": "<string>",
"name": "<string>",
"tag": "<string>",
"grantDetails": {
"priority": 1,
"expiryType": "PRICING_CYCLE",
"expiryDuration": "<string>",
"applicableEntityIds": [
"<string>"
]
},
"rateDetails": {
"pricingModel": "TIERED",
"currencySlabRateDetails": [
{
"currency": "<string>",
"creditAmount": 1,
"slabDetails": [
{
"startAfter": 123,
"priceType": "FLAT",
"slabConfig": {},
"rate": 123,
"slabRateConfig": {}
}
],
"rateConfig": {}
}
]
},
"invoiceTiming": "IN_ADVANCE",
"type": "ONE_TIME",
"recurrenceConfig": {
"interval": 3,
"offset": 5
}
},
"usageRateCard": {
"displayName": "<string>",
"name": "<string>",
"tag": "<string>",
"usageMeterId": "um.1zYnCiM9Bpg.1zYn",
"ratePlan": {
"pricingModel": "TIERED",
"slabs": [
{
"order": 5,
"startAfter": 123,
"priceType": "FLAT",
"slabConfig": {}
}
]
},
"rateValues": [
{
"currency": "<string>",
"slabRates": [
{
"order": 123,
"rate": 123,
"slabRateConfig": {}
}
],
"rateConfig": {}
}
]
},
"licenseRateCard": {
"id": "<string>",
"type": "LICENSE",
"displayName": "<string>",
"name": "<string>",
"tag": "<string>",
"invoiceTiming": "IN_ADVANCE",
"usageCycle": "WEEKLY",
"enableProration": false,
"config": {
"maxQuantity": 100,
"maxQuantityBreachAction": "DO_NOTHING"
},
"ratePlan": {
"pricingModel": "TIERED",
"slabs": [
{
"order": 5,
"startAfter": 123,
"priceType": "FLAT",
"slabConfig": {}
}
]
},
"rateValues": [
{
"currency": "<string>",
"slabRates": [
{
"order": 123,
"rate": 123,
"slabRateConfig": {}
}
],
"rateConfig": {}
}
],
"proratedRefundMode": "NONE"
},
"entitlementOverageRateCard": {
"featureId": "<string>",
"displayName": "<string>",
"name": "<string>",
"tag": "<string>",
"maxQuantity": 123,
"ratePlan": {
"pricingModel": "TIERED",
"slabs": [
{
"order": 5,
"startAfter": 123,
"priceType": "FLAT",
"slabConfig": {}
}
]
},
"rateValues": [
{
"currency": "<string>",
"slabRates": [
{
"order": 123,
"rate": 123,
"slabRateConfig": {}
}
],
"rateConfig": {}
}
],
"billingConfig": {
"interval": 3,
"startOffset": 5
}
},
"minimumCommitmentRateCard": {
"displayName": "<string>",
"rateValues": [
{
"currency": "<string>",
"rate": 123
}
]
}
},
"tag": "<string>",
"name": "<string>",
"referenceId": "<string>",
"referenceType": "<string>",
"currencies": [
"<string>"
],
"pricePlanId": "<string>",
"accountId": "<string>"
}
],
"nextToken": "<string>"
}