List Event Types

curl --request GET \
  --url https://api.signa.so/v1/event-types \
  --header 'Authorization: Bearer <token>'

{
  "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"
}

GET

event-types

List Event Types

curl --request GET \
  --url https://api.signa.so/v1/event-types \
  --header 'Authorization: Bearer <token>'

{
  "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"
}

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

office

string

Filter mappings by office code (e.g., uspto, euipo). Omit to return all offices.

Response

data

object[]

Show Event type mapping object

object

string

Always "event_type_mapping"

office_code

string

Office code (e.g., uspto, euipo)

raw_code

string

Office-specific raw event code

raw_label

string

Office-specific human-readable label (may be null)

event_type

string

Canonical event type (e.g., filing, registration, renewal)

event_scope

string

Scope of the event (may be null)

notes

string

Additional notes about this mapping (may be 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"
}

Code Examples

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"

Errors

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

Trademark History — event timeline for a mark
Status Taxonomy — canonical status stages

​Overview

​Query Parameters

​Response

​Code Examples

​Errors

​Related Endpoints

Overview

Query Parameters

Response

Code Examples

Errors

Related Endpoints