List Credit Ledger
Page through the organization credit ledger, newest first: grants, purchases, refunds, adjustments, and every debit with its actor kind and the action, warm-up, purchase, or opportunity it paid for. Member names and user ids are never included. Cache policy: live. Idempotency: none. Auth modes: api_key, mcp_oauth, session_bearer.
Page through the organization credit ledger, newest first: grants, purchases, refunds, adjustments, and every debit with its actor kind and the action, warm-up, purchase, or opportunity it paid for. Member names and user ids are never included. Cache policy: live. Idempotency: none. Auth modes: api_key, mcp_oauth, session_bearer.
Rankhog organization API key sent as Authorization: Bearer rhog_....
In: header
Request Body
application/json
TypeScript Definitions
Use the request body type in TypeScript.
Response Body
application/json
application/json
application/json
application/json
application/json
application/json
curl -X POST "https://example.com/agent/v1/credits/ledger" \ -H "Content-Type: application/json" \ -d '{ "limit": 25, "organizationId": "org_2x9rnkhdemo", "websiteId": "site_2x9rnkhdemo" }'{ "items": [ { "actorKind": "system", "bucket": "period", "createdAt": "2026-06-17T11:46:08.000Z", "entryType": "consumption", "id": "cl_2x9consumption", "quantity": -1, "reason": null, "reference": { "opportunityId": "opp_2x9opportunity", "plannedRedditActionId": "act_2x9planned", "purchaseId": null, "redditActionId": "ract_2x9rnkhdemo", "warmupCreditId": null }, "resourceKind": "comment", "websiteId": "site_2x9rnkhdemo" }, { "actorKind": "user", "bucket": "bank", "createdAt": "2026-06-10T09:12:00.000Z", "entryType": "purchase", "id": "cl_2x9purchase", "quantity": 250, "reason": null, "reference": { "opportunityId": null, "plannedRedditActionId": null, "purchaseId": "pur_2x9rnkhdemo", "redditActionId": null, "warmupCreditId": null }, "resourceKind": null, "websiteId": null }, { "actorKind": "system", "bucket": "period", "createdAt": "2026-06-01T00:00:00.000Z", "entryType": "period_grant", "id": "cl_2x9periodgrant", "quantity": 100, "reason": null, "reference": { "opportunityId": null, "plannedRedditActionId": null, "purchaseId": null, "redditActionId": null, "warmupCreditId": null }, "resourceKind": null, "websiteId": "site_2x9rnkhdemo" } ], "nextCursor": "eyJjcmVhdGVkQXQiOiIyMDI2LTA2LTAxVDAwOjAwOjAwLjAwMFoiLCJpZCI6ImNsXzJ4OXBlcmlvZGdyYW50In0"}{ "error": { "code": "agentic_invalid_input", "details": { "issues": [ { "code": "invalid_type", "message": "Expected string, received undefined.", "path": [ "organizationId" ] } ] }, "message": "Request body did not match the agentic capability schema." }}{ "error": { "code": "agentic_unauthorized", "message": "Authenticate before using Rankhog agentic capabilities." }}{ "error": { "code": "agentic_missing_scope", "details": { "missingScopes": [ "rankhog:read", "credits:read" ] }, "message": "Missing required OAuth scope: rankhog:read, credits:read." }}{ "error": { "code": "agentic_website_not_found", "message": "Website workspace not found." }}{ "error": { "code": "agentic_internal_error", "message": "Rankhog could not complete this agentic request." }}Get Credit Balance POST
Return the credit balance for an organization, or for one product when websiteId is set: period credits, organization bank, committed and spendable amounts, per-product balances, and the current cost table. Cache policy: live. Idempotency: none. Auth modes: api_key, mcp_oauth, session_bearer.
Legacy Dangerous Reddit Post Submit POST
Legacy compatibility path for Desktop-backed Reddit post submit. Prefer execute_reddit_action for new clients. Requires OAuth with reddit:write:dangerous. Cache policy: live. Idempotency: required. Auth modes: mcp_oauth.