---
title: "Business context snapshot"
method: GET
path: "/v1/context"
tags: ["Intelligence"]
---

# Business context snapshot

`GET /v1/context`

## Request

- Base URL: `https://api.frihet.io`
- URL: `https://api.frihet.io/v1/context`
- Auth: API key in header `X-API-Key`

Returns a comprehensive business context snapshot in a single call,
optimized for AI agents and MCP integrations. Includes business info,
defaults, plan usage, invoice series, recent activity, top clients,
and current month financials.

## Response `200`

Business context data

- BusinessContext: Comprehensive business context snapshot for AI agents
  - `data` object
    - `business` object
      - `name` string
      - `taxId` string
      - `fiscalZone` string
      - `currency` string
      - `language` string
      - `country` string
    - `defaults` object
      - `taxRate` number
      - `irpfRate` number
      - `dueDays` integer
      - `currency` string
    - `plan` object
      - `name` string
      - `invoices` object
        - `used` integer
        - `limit` integer
      - `expenses` object
        - `used` integer
        - `limit` integer
      - `aiMessages` object
        - `used` integer
        - `limit` integer
    - `series` object[]
      - `id` string
      - `prefix` string
      - `current` integer
      - `year` integer
    - `recentActivity` object
      - `lastInvoice` object, nullable
        - `number` string
        - `date` string
        - `client` string
      - `lastExpense` object, nullable
        - `date` string
        - `vendor` string
        - `amount` number
      - `overdueCount` integer
      - `overdueAmount` number
      - `unpaidCount` integer
    - `topClients` object[]
      - `name` string
      - `totalRevenue` number
      - `invoiceCount` integer
    - `currentMonth` object
      - `revenue` number
      - `expenses` number
      - `profit` number
      - `invoiceCount` integer
      - `expenseCount` integer
  - `meta` object
    - `requestId` string
    - `timestamp` string, date-time

## Other responses

- `401`: Authentication required or invalid API key
- `429`: Rate limit exceeded (100 requests per minute)
- `500`: Internal server error

---

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