AI generation
AI credit ledger
Use this endpoint from your own integration, with the same account permissions and safeguards as the app.
Request
GET
/api/v1/ai/ledgerExample requestcURL
curl 'https://postlift.io/api/v1/ai/ledger' \
-H "Authorization: Bearer $POSTLIFT_API_KEY"Replace path placeholders with your Postlift resource IDs. Example timestamps must be replaced with a future time; preserve the same timestamp when retrying the same operation.
Parameters
| Name | Location | Description |
|---|---|---|
cursor | query | Opaque nextCursor from the previous response. |
limit | query | Default: 20. Minimum: 1. Maximum: 50. |
Response
200 Successful operation.
| Field | Type & constraints |
|---|---|
entriesrequired | object[] |
nextCursorrequired | string | null |
View JSON schema
{
"type": "object",
"properties": {
"entries": {
"type": "array",
"items": {
"type": "object",
"additionalProperties": true
}
},
"nextCursor": {
"type": [
"string",
"null"
]
}
},
"required": [
"entries",
"nextCursor"
],
"additionalProperties": true
}Errors & retries
Failures use a stable error code and request ID. Check the current resource version or request status before retrying a write.
| Status | Meaning |
|---|---|
400 | Invalid input or Jev rejection |
401 | Invalid, expired or revoked API key |
402 | Plan, publishing quota or AI credit requirement |
403 | Missing scope |
404 | Resource not found or not owned |
409 | Version conflict, missing voice or duplicate AI operation |
413 | Payload too large |
429 | Rate or concurrency limit |
500 | Internal error |
502 | Upstream failure; inspect operation status |
503 | Service or review unavailable |