---
title: "Get accounts receivable statistics"
method: GET
path: "/v1/platform/businesses/{business_id}/ar/stats/"
tags: ["Accounts Receivable"]
---

# Get accounts receivable statistics

`GET /v1/platform/businesses/{business_id}/ar/stats/`

## Request

- Base URL: `https://docs.thredfi.com` (the document declares no server; this is the origin it was published from)
- URL: `https://docs.thredfi.com/v1/platform/businesses/{business_id}/ar/stats/`
- Auth: one of:
  - HTTP bearer
  - HTTP bearer
  - HTTP basic
  - HTTP bearer
  - HTTP bearer

Retrieve statistics for all Accounts Receivable entities grouped by status.

        Returns counts for:
        - **Invoices**: all, unpaid (draft, issued, sent, partially_paid, partially_written_off), paid
        - **Refunds**: all, processed (paid)
        - **Credit Notes**: all, draft (draft, sent, partially_applied), applied

        This endpoint is optimized for efficient counting.

## Path parameters

- `business_id` string, uuid, required

## Response `200`

- ARStats[]
  - `invoices` InvoiceStats, required: Statistics for customer invoices.
    - `all` integer, required: Total number of invoices
    - `unpaid` integer, required: Number of unpaid invoices (draft, issued, sent, partially_paid, partially_written_off)
    - `paid` integer, required: Number of fully paid invoices
  - `refunds` RefundStats, required: Statistics for customer refunds.
    - `all` integer, required: Total number of refunds
    - `processed` integer, required: Number of processed (paid) refunds
  - `credit_notes` CreditNoteStats, required: Statistics for customer credit notes.
    - `all` integer, required: Total number of credit notes
    - `draft` integer, required: Number of unapplied credit notes (draft, sent, partially_applied)
    - `applied` integer, required: Number of fully applied credit notes

## Other responses

- `400`: Validation errors in request data
- `401`: Authentication required - missing or invalid API key
- `403`: Permission denied - insufficient privileges
- `404`: Resource not found
- `409`: Conflict - resource already exists or invalid state transition
- `422`: Unprocessable entity - business logic validation failed
- `500`: Internal server error

---

[API](https://skmtc.dev/thredfi/apis/thredfi-accounting-platform-api.md) - [All operations](https://skmtc.dev/thredfi/apis/thredfi-accounting-platform-api/llms.txt) - [OpenAPI document](https://skmtc.dev/thredfi/apis/thredfi-accounting-platform-api/revisions/0c1918254db3?raw)