AccountCompanies

Get invoice stats per company

Returns, for each company of the account, how many fiscal documents it has issued and when it last issued one. What counts is described on invoice_count and last_invoice_at in the response.

Paginated with the usual page/limit, and the usual defaults: without them you get the stats of the first 20 companies, not of all of them. One row per company, over the same universe and in the same order as GET /v1/accounts/{account_id}/companies — search included — so asking both with the same page, limit and search lines the two responses up company by company.

get/v1/accounts/{account_id}/companies/stats

Request

  • Base URL: https://app.beel.es/api
  • URL: https://app.beel.es/api/v1/accounts/{account_id}/companies/stats
  • Auth: HTTP bearer

Query parameters

pageinteger

Page number, starting at 1. The response echoes it back as pagination.current_page.

limitinteger

How many items to return per page. The response echoes it back as pagination.items_per_page.

searchstring

Case-insensitive filter on NIF, legal name or trade name — the same filter, over the same universe, as the one GET /v1/accounts/{account_id}/companies applies. Blank or omitted returns all.

Response

Per-company invoice stats

successboolean

Example response

{
  "data": {
    "stats": [
      {
        "invoice_count": 42,
        "last_invoice_at": "2026-05-12T00:00:00Z"
      }
    ],
    "pagination": {
      "current_page": 1,
      "total_pages": 5,
      "total_items": 87,
      "items_per_page": 20
    }
  },
  "meta": {
    "timestamp": "2025-01-15T10:30:00Z",
    "request_id": "4bf92f3577b34da6a3ce929d0e0e4736"
  }
}

Changes

No recorded changes to this operation across all 1 revision of this API.