---
title: "Get financial summary"
method: GET
path: "/analytics/financial-summary"
tags: ["Analytics AI — Analytics & BI"]
---

# Get financial summary

`GET /analytics/financial-summary`

## Request

- Base URL: `https://api.paperoffice.ai/latest`
- URL: `https://api.paperoffice.ai/latest/analytics/financial-summary`
- Auth: HTTP bearer

Financial summary — incoming/outgoing invoice totals, top partners, and period aggregates derived from extracted document fields.

## Query parameters

- `period` '7d' | '30d' | '90d' | '365d' | 'all'

## Response `200`

Success

- object
  - `_billing` object
    - `credits` object
      - `total_monthly` integer
      - `remaining_monthly` integer
      - `credit_source` string
      - `api_handler` string
      - `tier_info` object
        - `tier` string
        - `name` string
        - `initial_credits` integer
        - `price_monthly` integer
        - `price_overage_per_credit` integer
      - `notice` string
      - `renewal_days` integer
      - `subscription_status` string
    - `job` object
      - `api_job_name` string
      - `app` string
      - `action` string
      - `default_credits` integer
      - `token` string
      - `credits_billed` integer
      - `pricing` object
        - `credits_per_unit` integer
        - `unit` string
        - `unit_count` integer
        - `addons` string
    - `requests` object
      - `limits` object
        - `second` integer
        - `minute` integer
        - `hour` integer
        - `day` integer
      - `current` object
        - `second` integer
        - `minute` integer
        - `hour` integer
        - `day` integer
      - `remaining` object
        - `second` integer
        - `minute` integer
        - `hour` integer
        - `day` integer
      - `next_possible_request_seconds` integer
    - `remaining_credits` integer
    - `total_monthly` integer
    - `account_id` integer
    - `plan` object
      - `tier` string
      - `name` string
    - `credits_billed` integer
  - `aggregation_scope` object
    - `period` string
    - `workspace_scope` string
    - `workspace_id` string
    - `date_basis` string
    - `scope_contract` string
    - `amount_definition` string
    - `invoice_count_definition` string
    - `currency_scope` string
  - `financial_meta_config` object
    - `amount_keys` unknown[]
      - unknown
    - `partner_keys` unknown[]
      - unknown
    - `due_date_keys` unknown[]
      - unknown
    - `document_type_keys` unknown[]
      - unknown
    - `location_address_keys` unknown[]
      - unknown
    - `location_city_keys` unknown[]
      - unknown
    - `location_postal_keys` unknown[]
      - unknown
    - `location_country_keys` unknown[]
      - unknown
    - `meta_key_normalization` string
  - `has_custom_meta_keys` boolean
  - `meta_mapping` object
    - `configured` boolean
    - `ready` object
      - `amounts` boolean
      - `partners` boolean
      - `due_dates` boolean
      - `document_types` boolean
      - `location` boolean
    - `feature_ready` boolean
    - `reason` string
  - `period` string
  - `processing_time` string
  - `status` string
  - `summary` object
    - `total_amount` integer
    - `total_amount_scope` string
    - `invoice_count` integer
    - `average_amount` integer
    - `min_amount` integer
    - `max_amount` integer
  - `top_partners` unknown[]
    - unknown
  - `workspace_id` string

## Other responses

- `4XX`: Error
- `5XX`: Error

---

[API](https://skmtc.dev/paperoffice/apis/paperoffice-ai-api.md) · [All operations](https://skmtc.dev/paperoffice/apis/paperoffice-ai-api/llms.txt) · [OpenAPI document](https://skmtc.dev/paperoffice/apis/paperoffice-ai-api/revisions/c6a6228a4509?raw)