curl --request GET \
--url https://paradigm.lighton.ai/api/v3/storage/cost \
--header 'Authorization: Bearer <token>'import requests
url = "https://paradigm.lighton.ai/api/v3/storage/cost"
headers = {"Authorization": "Bearer <token>"}
response = requests.get(url, headers=headers)
print(response.text)const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};
fetch('https://paradigm.lighton.ai/api/v3/storage/cost', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));{
"currency": "<string>",
"period_start": "2023-12-25",
"cost": "<string>",
"billable_gib": 1,
"free_gib": 1,
"peak_bytes": 1,
"pay_as_you_go": {
"cost": "<string>",
"billable_gib": 1,
"free_gib": 1
}
}{
"detail": "System is under maintenance.",
"error": "service_maintenance",
"mode": "full_shutdown",
"reason": "<string>",
"started_at": "2023-11-07T05:31:56Z",
"endpoint_category_names": [
"<string>"
]
}Get month-to-date storage cost
Return the storage charge the caller’s company has accrued so far in the current billing month, alongside the quantities it is derived from.
cost is computed by the same code path that produces the invoice’s storage line item, so the two always agree: the month’s peak footprint is rounded up to whole GiB, free_gib is subtracted, and the remainder is billed at the published per-GiB monthly rate. Because the charge follows the peak rather than the current footprint, deleting files mid-month does not reduce it.
cost is 0 while the company stays within its allowance. For the current footprint in bytes and the free-tier cap, use GET /api/v3/storage.
curl --request GET \
--url https://paradigm.lighton.ai/api/v3/storage/cost \
--header 'Authorization: Bearer <token>'import requests
url = "https://paradigm.lighton.ai/api/v3/storage/cost"
headers = {"Authorization": "Bearer <token>"}
response = requests.get(url, headers=headers)
print(response.text)const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};
fetch('https://paradigm.lighton.ai/api/v3/storage/cost', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));{
"currency": "<string>",
"period_start": "2023-12-25",
"cost": "<string>",
"billable_gib": 1,
"free_gib": 1,
"peak_bytes": 1,
"pay_as_you_go": {
"cost": "<string>",
"billable_gib": 1,
"free_gib": 1
}
}{
"detail": "System is under maintenance.",
"error": "service_maintenance",
"mode": "full_shutdown",
"reason": "<string>",
"started_at": "2023-11-07T05:31:56Z",
"endpoint_category_names": [
"<string>"
]
}Authorizations
Bearer authentication header of the form Bearer <token>, where <token> is your auth token.
Response
ISO 4217 code applied to cost
First day of the current billing month (UTC)
Storage charge accrued so far this month, in currency
Whole GiB billed: the month's peak rounded up, minus free_gib. 0 when within the allowance
x >= 0Storage allowance included at no charge, in GiB
x >= 0Highest storage footprint reached this month, in bytes. The charge follows the peak, not the current footprint — deleting files mid-month does not reduce it
x >= 0The same peak_bytes priced against the pay-as-you-go allowance, so a company on a larger plan can be shown what downgrading would cost. Identical to the top-level figures while every tier shares one allowance
Show child attributes
Show child attributes