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

# List Event Types

> List per-office event type code mappings

## Overview

Returns per-office event type code mappings. Each entry maps a raw office-specific event code to a canonical event type. Use this to populate filter dropdowns, validate event data, or build event-type legend displays.

## Query Parameters

<ParamField query="office" type="string">
  Filter mappings by office code (e.g., `uspto`, `euipo`). Omit to return all offices.
</ParamField>

## Response

<ResponseField name="data" type="object[]">
  <Expandable title="Event type mapping object">
    <ResponseField name="object" type="string">Always `"event_type_mapping"`</ResponseField>
    <ResponseField name="office_code" type="string">Office code (e.g., `uspto`, `euipo`)</ResponseField>
    <ResponseField name="raw_code" type="string">Office-specific raw event code</ResponseField>
    <ResponseField name="raw_label" type="string">Office-specific human-readable label (may be null)</ResponseField>
    <ResponseField name="event_type" type="string">Canonical event type (e.g., `filing`, `registration`, `renewal`)</ResponseField>
    <ResponseField name="event_scope" type="string">Scope of the event (may be null)</ResponseField>
    <ResponseField name="notes" type="string">Additional notes about this mapping (may be null)</ResponseField>
  </Expandable>
</ResponseField>

<ResponseExample>
  ```json theme={null}
  {
    "object": "list",
    "data": [
      {
        "object": "event_type_mapping",
        "office_code": "uspto",
        "raw_code": "FILED",
        "raw_label": "Application Filed",
        "event_type": "filing",
        "event_scope": null,
        "notes": null
      },
      {
        "object": "event_type_mapping",
        "office_code": "uspto",
        "raw_code": "REGISTERED",
        "raw_label": "Registration Certificate Issued",
        "event_type": "registration",
        "event_scope": null,
        "notes": null
      },
      {
        "object": "event_type_mapping",
        "office_code": "euipo",
        "raw_code": "APPLICATION_RECEIVED",
        "raw_label": "Application Received",
        "event_type": "filing",
        "event_scope": null,
        "notes": null
      }
    ],
    "has_more": false,
    "pagination": {
      "cursor": null
    },
    "request_id": "req_rK7bC3dE"
  }
  ```
</ResponseExample>

## Code Examples

<CodeGroup>
  ```bash cURL theme={null}
  curl https://api.signa.so/v1/event-types \
    -H "Authorization: Bearer sig_xxxxxxxxxxxx"

  # Filter by office
  curl "https://api.signa.so/v1/event-types?office=uspto" \
    -H "Authorization: Bearer sig_xxxxxxxxxxxx"
  ```

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

  const signa = new Signa({ api_key: "sig_xxxxxxxxxxxx" });

  const eventTypes = await signa.references.eventTypes();
  ```

  ```python Python theme={null}
  import requests

  resp = requests.get(
      "https://api.signa.so/v1/event-types",
      headers={"Authorization": "Bearer sig_xxxxxxxxxxxx"},
  )
  event_types = resp.json()["data"]
  ```
</CodeGroup>

## Errors

| Status | Type           | Description                |
| ------ | -------------- | -------------------------- |
| 401    | `unauthorized` | Missing or invalid API key |
| 429    | `rate_limited` | Too many requests          |

## Related Endpoints

* [Trademark History](/api-reference/trademarks/trademark-history) -- event timeline for a mark
* [Status Taxonomy](/guides/status-taxonomy) -- canonical status stages