Skip to main content
POST /v1/billing/projected-invoice
Returns a line-item invoice projection based on the usage volumes you provide. This is a public endpoint — no authentication is required. Use it for pricing calculators, cost forecasting, or pre-sales tools. Regional pricing adjustments are applied when you include a country_code.

​
Request body

​
mints
integer
required
Number of attestation mints to include in the projection.
​
verifications
integer
required
Number of verifications to include in the projection.
​
country_code
string
ISO 3166-1 alpha-2 country code for regional pricing adjustment (e.g., US, NG, KE). Defaults to Tier 1 (global) rates if omitted.
​
plan_key
string
Plan identifier to include the platform fee in the projection (e.g., plan_starter, plan_business). If omitted, the platform fee is excluded.

​
Response

​
line_items
object[]
Breakdown of projected charges.
​
subtotal
integer
Usage charges subtotal in cents (before platform fee).
​
total
integer
Total projected cost in cents (usage + platform fee).
​
currency
string
Currency code (USD).
​
rates_used
object
The rates applied to this projection.
curl -X POST https://api.truthlocks.com/v1/billing/projected-invoice \
  -H "Content-Type: application/json" \
  -d '{
    "mints": 1000,
    "verifications": 5000,
    "country_code": "US",
    "plan_key": "plan_starter"
  }'

{
  "line_items": [
    {
      "description": "Credential mints",
      "quantity": 1000,
      "unit_price_cents": 25,
      "total_cents": 25000
    },
    {
      "description": "Credential verifications",
      "quantity": 5000,
      "unit_price_cents": 10,
      "total_cents": 50000
    },
    {
      "description": "Platform fee",
      "quantity": 1,
      "unit_price_cents": 2900,
      "total_cents": 2900
    }
  ],
  "subtotal": 75000,
  "total": 77900,
  "currency": "USD",
  "rates_used": {
    "mint_rate_cents": 25,
    "verify_rate_cents": 10,
    "platform_fee": 2900,
    "region": "TIER_1",
    "multiplier": 1.0
  }
}
All amounts are in cents. Divide by 100 to convert to dollars. Regional multipliers apply automatically when you include a country_code.