> ## 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 lowercase.

<ParamField path="code" type="string" required>Lowercase office code, for example `uspto`.</ParamField>

## Code Examples

<CodeGroup>
  ```bash cURL theme={null}
  curl https://api.signa.so/v1/analytics/offices/uspto \
    -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("uspto");
  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": "uspto",
    "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>