Skip to main content
GET
/
v1
/
event-types
List Event Types
curl --request GET \
  --url https://api.example.com/v1/event-types
{
  "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[]
{
  "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_live_xxxxxxxxxxxx"

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

​
Errors

StatusTypeDescription
401unauthorizedMissing or invalid API key
429rate_limitedToo many requests