Project next invoice
curl --request POST \
--url https://api.truthlocks.com/v1/billing/projected-invoice \
--header 'Content-Type: application/json' \
--header 'X-API-Key: <api-key>' \
--data '
{
"country_code": "<string>",
"mints": 500000000,
"plan_key": "<string>",
"verifications": 500000000
}
'const options = {
method: 'POST',
headers: {'X-API-Key': '<api-key>', 'Content-Type': 'application/json'},
body: JSON.stringify({
country_code: '<string>',
mints: 500000000,
plan_key: '<string>',
verifications: 500000000
})
};
fetch('https://api.truthlocks.com/v1/billing/projected-invoice', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));import requests
url = "https://api.truthlocks.com/v1/billing/projected-invoice"
payload = {
"country_code": "<string>",
"mints": 500000000,
"plan_key": "<string>",
"verifications": 500000000
}
headers = {
"X-API-Key": "<api-key>",
"Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.text)package main
import (
"fmt"
"strings"
"net/http"
"io"
)
func main() {
url := "https://api.truthlocks.com/v1/billing/projected-invoice"
payload := strings.NewReader("{\n \"country_code\": \"<string>\",\n \"mints\": 500000000,\n \"plan_key\": \"<string>\",\n \"verifications\": 500000000\n}")
req, _ := http.NewRequest("POST", url, payload)
req.Header.Add("X-API-Key", "<api-key>")
req.Header.Add("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}{
"total": 123,
"subtotal": 123,
"amount_unit": "cents",
"billing_model": "pay_per_use",
"volume_pricing": "graduated",
"estimate_only": true,
"currency": "<string>",
"line_items": [
{}
]
}{
"code": "AUTH_REQUIRED",
"message": "Authentication required",
"http_status": 401
}Billing
Projected invoice
Calculate a projected invoice breakdown based on expected mint and verification volumes.
POST
/
v1
/
billing
/
projected-invoice
Project next invoice
curl --request POST \
--url https://api.truthlocks.com/v1/billing/projected-invoice \
--header 'Content-Type: application/json' \
--header 'X-API-Key: <api-key>' \
--data '
{
"country_code": "<string>",
"mints": 500000000,
"plan_key": "<string>",
"verifications": 500000000
}
'const options = {
method: 'POST',
headers: {'X-API-Key': '<api-key>', 'Content-Type': 'application/json'},
body: JSON.stringify({
country_code: '<string>',
mints: 500000000,
plan_key: '<string>',
verifications: 500000000
})
};
fetch('https://api.truthlocks.com/v1/billing/projected-invoice', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));import requests
url = "https://api.truthlocks.com/v1/billing/projected-invoice"
payload = {
"country_code": "<string>",
"mints": 500000000,
"plan_key": "<string>",
"verifications": 500000000
}
headers = {
"X-API-Key": "<api-key>",
"Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.text)package main
import (
"fmt"
"strings"
"net/http"
"io"
)
func main() {
url := "https://api.truthlocks.com/v1/billing/projected-invoice"
payload := strings.NewReader("{\n \"country_code\": \"<string>\",\n \"mints\": 500000000,\n \"plan_key\": \"<string>\",\n \"verifications\": 500000000\n}")
req, _ := http.NewRequest("POST", url, payload)
req.Header.Add("X-API-Key", "<api-key>")
req.Header.Add("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}{
"total": 123,
"subtotal": 123,
"amount_unit": "cents",
"billing_model": "pay_per_use",
"volume_pricing": "graduated",
"estimate_only": true,
"currency": "<string>",
"line_items": [
{}
]
}{
"code": "AUTH_REQUIRED",
"message": "Authentication required",
"http_status": 401
}POST /v1/billing/projected-invoice
country_code. This endpoint uses the standard rate card, not a tenant’s negotiated agreement. Provide expected billable quantities; this calculator does not deduct free allowances or classify sandbox activity.
Volume pricing is graduated. Each band prices only the operations in that band. The response identifies billing_model: "pay_per_use", volume_pricing: "graduated", amount_unit: "cents", and estimate_only: true. An estimate does not create or charge an invoice. Missing, overlapping, or incomplete rate definitions return 422 invalid_pricing; unsafe quantities and unknown plans return 400 bad_request.
The exact applied prices are in line_items. The convenience rates_used scalar fields are retained for compatibility with flat rate cards; they are not a blended price and must not be multiplied across volume bands.
Response
All amounts are in cents. Divide by 100 to convert to dollars. Regional multipliers apply automatically when you include a
country_code.Body
application/json

