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

# Classification Analytics

Use this endpoint for class-level filing intelligence, such as measuring how crowded Nice class 9 is across offices and over time.

<ParamField path="class" type="integer" required>Nice class from 1 through 45.</ParamField>

## Code Examples

<CodeGroup>
  ```bash cURL theme={null}
  curl https://api.signa.so/v1/analytics/classifications/9 \
    -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 cls = await signa.analytics.classification(9);
  console.log(cls.total_marks, cls.active_count);
  ```
</CodeGroup>

## Response

<ResponseField name="nice_class" type="number">Nice class number.</ResponseField>
<ResponseField name="total_marks" type="number">Marks classified in this class.</ResponseField>
<ResponseField name="by_office" type="object">Counts keyed by office code.</ResponseField>
<ResponseField name="filing_trend" type="object">Annual filing counts.</ResponseField>

<ResponseExample>
  ```json Response theme={null}
  {
    "object": "classification_analytics",
    "nice_class": 9,
    "total_marks": 950000,
    "active_count": 720000,
    "by_status": {
      "registered": 600000,
      "pending": 120000,
      "expired": 90000,
      "cancelled": 60000,
      "abandoned": 80000
    },
    "by_office": {
      "uspto": 700000,
      "euipo": 250000
    },
    "filing_trend": {
      "2025": 82000
    },
    "computed_at": "2026-07-12T00:00:00.000Z",
    "request_id": "req_example"
  }
  ```
</ResponseExample>
