> ## Documentation Index
> Fetch the complete documentation index at: https://docs.signa.so/llms.txt
> Use this file to discover all available pages before exploring further.

# Office Analytics

Use this endpoint to benchmark one office by registration rate, leading Nice classes, and yearly filing trend. Office codes are uppercase ST.3 (legacy lowercase codes are accepted as permanent aliases).

<ParamField path="code" type="string" required>Uppercase ST.3 office code, for example `US`.</ParamField>

## Code Examples

<CodeGroup>
  ```bash cURL theme={null}
  curl https://api.signa.so/v1/analytics/offices/US \
    -H "Authorization: Bearer sig_YOUR_KEY"
  ```

  ```typescript TypeScript theme={null}
  import { Signa } from "@signa-so/sdk";

  const signa = new Signa({ api_key: process.env.SIGNA_API_KEY });
  const office = await signa.analytics.office("US");
  console.log(office.total_marks, office.registration_rate);
  ```
</CodeGroup>

## Response

<ResponseField name="total_marks" type="number">Total marks at the office.</ResponseField>
<ResponseField name="registration_rate" type="number | null">Share of concluded matters that reached registration.</ResponseField>
<ResponseField name="top_classes" type="array<{ class: number; count: number; pct: number }> | null">Leading Nice classes.</ResponseField>
<ResponseField name="yearly_trend" type="array<{ year: number; filed: number; registered: number; abandoned: number }> | null">Annual filing and status counts.</ResponseField>

<ResponseExample>
  ```json Response theme={null}
  {
    "object": "office_analytics",
    "code": "US",
    "total_marks": 8000000,
    "registered_count": 4800000,
    "pending_count": 900000,
    "expired_count": 1200000,
    "cancelled_count": 500000,
    "abandoned_count": 600000,
    "registration_rate": 0.8125,
    "jurisdiction_count": 1,
    "earliest_filing": "1870-01-01",
    "latest_filing": "2026-07-11",
    "top_classes": [
      {
        "class": 9,
        "count": 700000,
        "pct": 0.088
      }
    ],
    "yearly_trend": [
      {
        "year": 2025,
        "filed": 410000,
        "registered": 280000,
        "abandoned": 35000
      }
    ],
    "stats_computed_at": "2026-07-12T00:00:00.000Z",
    "request_id": "req_example"
  }
  ```
</ResponseExample>