---
title: "Get Account Usage Overview"
method: POST
path: "/account/overview"
tags: ["Account"]
---

# Get Account Usage Overview

`POST /account/overview`

## Request

- Base URL: `https://api.blog2social.com/rest/v1.0`
- URL: `https://api.blog2social.com/rest/v1.0/account/overview`
- Auth: none declared
- TypeScript: <https://skmtc.dev/blog2social/apis/blog2social-api/docs/account/overview/post.ts> (a function with typed inputs; its response is checked against the schema)

Returns the current available credit balance and credit usage for each day, grouped by API endpoint and network. This endpoint requires a service_token but does not require an access_token. The optional days parameter accepts values from 1 to 30 and defaults to 1 day.

## Request body

- object
  - `service_token` string, required: The token for your service.
  - `days` integer: Number of calendar days to include, from 1 to 30. Defaults to 1 day.

## Response `200`

OK

- object
  - `credit_usage_total` integer, required: Total credits used during the requested period.
  - `credit_open_balance` number, required: Current available credit balance.
  - `days` object[], required
    - `day` string, date, required
    - `day_total` integer, required: Total credits used on this day.
    - `endpoints` object[], required
      - `endpoint` string, required: API endpoint recorded for this usage.
      - `endpoint_total` integer, required: Total credits used by this endpoint on this day.
      - `networks` object[], required
        - `network_id` integer, required
        - `credits_used` integer, required

## Other responses

- `400`: Bad Request
- `401`: Unauthorized
- `500`: Internal Server Error

## Changes

- **2026-10-09** `b565e60bdd35`: 1 breaking, 1 info
  - removed the required property `balance` from the response with the `200` status
  - added the required property `credit_open_balance` to the response with the `200` status
- **2026-10-07** `536403131aa7`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/blog2social/apis/blog2social-api/changes/account/overview/post.md)

---

[API](https://skmtc.dev/blog2social/apis/blog2social-api.md) - [All operations](https://skmtc.dev/blog2social/apis/blog2social-api/llms.txt) - [OpenAPI document](https://skmtc.dev/blog2social/apis/blog2social-api/revisions/25eaecaa1acb?raw)