Get prices
The package price list the billing page's Pricing table shows, in the team's billing currency (USD for a team that has not chosen one): each channel's…
https://app.usenotix.dev/api/v1/billing/pricingFull access and read only keys can call this. Sending access keys cannot. Key permissions lists the extra rules some calls have.
The package price list the billing page's Pricing table shows, in the team's billing currency (USD for a team that has not chosen one): each channel's volume tiers and the price of each product line per tier, in millionths of the currency's major unit per message. A null cell is "On request". pro is the Pro plan's monthly price in the same currency; NGN and KES pay a fixed local price. payAsYouGo is what sending past the plan's units costs with pay-as-you-go on ($1 per 1,000 marketing emails and $0.50 per 1,000 transactional emails for a card-billed team; a wallet team pays its wallet's price), and whether it is on; null for a wallet currency with no price yet.
Who can call it
Full access, read only and live AI keys, including a key limited to one domain: they help a caller stay within the team's limits. Send-only keys answer 403 SCOPE_DENIED.
The team can make 60 billing reads a minute through the API (20 for invoices, which are read from Stripe, within a limit shared by every team); when Notix cannot count them the answer is 503 SERVICE_UNAVAILABLE (try again shortly), never a 429.
Headers
Bearer followed by your API key.
Errors
`SCOPE_DENIED`: a send-only key.
The team read billing 60 times in the last minute.
The rate counters cannot be read just now; try again shortly.
Every error has the same shape. See all error codes.
curl -X GET "https://app.usenotix.dev/api/v1/billing/pricing" \
-H "Authorization: Bearer $NOTIX_API_KEY"
import { Notix } from "notix-js";
const notix = new Notix(process.env.NOTIX_API_KEY);
const { data, error } = await notix.billing.pricing();
console.log(data?.pro.monthlyFormatted);
{
"currency": "NGN",
"channels": [
{
"channel": "EMAIL",
"label": "string",
"tiers": [
null
],
"lines": [
null
]
}
],
"pro": {
"currency": "NGN",
"monthlyMinor": 1,
"monthlyFormatted": "string",
"unitPriceMicro": 1,
"fixedPrice": true,
"configured": true
},
"plans": [
{
"plan": "BASIC",
"name": "Scale",
"includedUnits": 100000,
"currency": "NGN",
"monthlyMinor": 1,
"monthlyFormatted": "string",
"sold": true
}
],
"payAsYouGo": {
"on": true,
"currency": "NGN",
"unitPriceMicro": 1,
"marketingPer1000": "$1.00",
"transactionalPer1000": "$0.50"
}
}