Skip to main content
GET
/
v1
/
events
List Events
curl --request GET \
  --url https://api.corpus.intrace.ai/v1/events \
  --header 'X-API-Key: <api-key>'
{
  "items": [
    {
      "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
      "title": "<string>",
      "eventCategory": "<string>",
      "eventType": "<string>",
      "createdAt": "2023-11-07T05:31:56Z",
      "updatedAt": "2023-11-07T05:31:56Z",
      "description": "<string>",
      "eventSubtype": "<string>",
      "eventDate": "2023-12-25",
      "eventDateEnd": "2023-12-25",
      "location": "<string>",
      "locationCountry": "<string>",
      "locationCoordinates": {
        "lat": 123,
        "lng": 123
      },
      "fatalities": 123,
      "injuries": 123,
      "abductions": 123,
      "civilianTargeting": true,
      "admin1": "<string>",
      "admin2": "<string>",
      "admin3": "<string>",
      "geoPrecision": 123,
      "salienceScore": 123,
      "salienceRationale": "<string>",
      "articleCount": 0,
      "actorCount": 0,
      "sourceDomains": [
        "<string>"
      ],
      "sourceTypes": [
        "<string>"
      ]
    }
  ],
  "total": 123,
  "page": 123,
  "pageSize": 123,
  "totalPages": 123
}

Authorizations

X-API-Key
string
header
required

Headers

x-api-key
string | null

Corpus API key

Query Parameters

page
integer
default:1
Required range: x >= 1
page_size
integer
default:50
Required range: 1 <= x <= 500
all_results
boolean
default:false

Return all results without pagination

country
string[]

Filter by country (repeatable)

event_type
string[]

Filter by event type (repeatable)

event_category
string[]

Filter by event category (repeatable)

event_subtype
string[]

Filter by event subtype (repeatable)

date_from
string<date> | null

Inclusive start date

date_to
string<date> | null

Inclusive end date

search
string | null

Search in title/description

salience_score_min
number | null

Minimum salience score

salience_score_max
number | null

Maximum salience score

article_count_min
integer | null

Minimum article count

Required range: x >= 0
article_count_max
integer | null

Maximum article count

Required range: x >= 0
actor_count_min
integer | null

Minimum actor count

Required range: x >= 0
actor_count_max
integer | null

Maximum actor count

Required range: x >= 0
sort_by
string
default:event_date

Sort column

sort_order
enum<string>
default:desc

Sort direction

Available options:
asc,
desc
api_key
string | null

Corpus API key

Response

Successful Response

Paginated list of events.

items
EventResponse · object[]
required
total
integer
required
page
integer
required
pageSize
integer
required
totalPages
integer
required