Intelligence · min plan: starter · standard (1u) · scope: read:events · both

Trade Events

Returns durable source-attributed events with severity, confidence, region, and publication metadata.

GET /v1/events

Required scope

read:events

API credits

1 per success

Minimum plan

starter

Rate-limit bucket

standard

Parameters

Name	In	Type	Required	Description
category	query	string	—	Event category.
region	query	string	—	Region filter.
since	query	string	—	ISO-8601 lower publication bound.
page	query	integer	—	One-indexed page.

Sample request

curl "https://getway.clearie.neximprove.com/v1/events?category=Tariff" -H "Authorization: Bearer $CLEARIE_API_KEY"

Sample response

{
  "items": [
    {
      "id": "event_id",
      "title": "Tariff schedule updated",
      "category": "Tariff",
      "severity": "moderate",
      "confidence": "high"
    }
  ],
  "meta": {
    "weighted_units": 1
  }
}

Live response contract

Live calls require API-key authentication, read:events scope, plan access, and available quota. Successful calls consume 1 API credits.

Sandbox sample response

Workspace try-it calls use isolated representative sandbox records. They are for integration validation, not production filing.

Error examples

401 invalid key · 403 missing scope or plan · 429 quota/rate limit · 404 no verified data where applicable.

Response schema

root object {

items* array [

item object {

id* string// e.g. "event_id"

title* string// e.g. "Tariff schedule updated"

category* string// e.g. "Tariff"

severity* string// e.g. "moderate"

confidence* string// e.g. "high"

}

]

meta* object {

weighted_units* integer// e.g. 1

}

Try this API live in the workspace

The in-app try-it console runs against the isolated deterministic sandbox repository. It never reads live customer or reference records.

Open in workspace Create account