---
title: "Classify a headline and score its event class against the observed corpus"
method: POST
path: "/api/v1/score-headline"
---

# Classify a headline and score its event class against the observed corpus

`POST /api/v1/score-headline`

## Request

- Base URL: `https://probable.media`
- URL: `https://probable.media/api/v1/score-headline`
- Auth: none declared

Does not verify that the described event occurred and is not a forecast. Optional strict referenceContext supplies source scope that the title does not; no country or scope is assumed. occurrenceReference reports heuristic matches in references and populationReferences, eventStatus, missingFields, conflicts, and verifiesHeadline=false.

## Request body

- object
  - `title` string, required
  - `referenceContext` ReferenceContext: Optional explicit context for conservative reference matching. Omitted fields remain unknown.
    - `countryCode` string: Uppercase ISO 3166-1 alpha-3 country code.
    - `magnitude` number
    - `industry` '00' | '31-33' | '44-45' | '51'
    - `aviationScope` 'us_scheduled_part121'

## Response `200`

Versioned classification, measurement status and scoped occurrenceReference; empirical recurrence appears only after live observation scan-days exist

## Other responses

- `400`: Invalid title or referenceContext

---

[API](https://skmtc.dev/probable/apis/probable-public-api.md) · [All operations](https://skmtc.dev/probable/apis/probable-public-api/llms.txt) · [OpenAPI document](https://skmtc.dev/probable/apis/probable-public-api/revisions/28e1acd459f3?raw)