Raw schema
{
"type": "object",
"properties": {
"query": {
"type": "string",
"maxLength": 200,
"pattern": "\\S",
"description": "Free text matched against the company, the stated reason, the context notes, sector, country and affected roles. Every word must appear. Example: 'customer service'."
},
"company": {
"type": "string",
"maxLength": 120,
"pattern": "\\S",
"description": "Company name or part of it, e.g. 'Klarna'."
},
"attribution": {
"type": "array",
"items": {
"type": "string",
"enum": [
"explicit",
"mixed",
"blamed"
]
},
"description": "Keep only these attribution levels. explicit: The company itself declared the layoff AI-related. blamed: A credible source named AI, but the company did not. Shown as context and never counted: prong 1 of our standard requires the employer's own source to name AI, so a blamed event is a failed claim, not a discounted one. mixed: AI was cited alongside other material factors (cost, demand)."
},
"evidence_tier": {
"type": "array",
"items": {
"type": "string",
"enum": [
"tier1",
"tier2",
"tier3"
]
},
"description": "Keep only these evidence tiers. tier1 (Primary-source attributed): AI named as a workforce driver in the company's own SEC filing, on-record earnings call, or official statement, with the event corroborated by a structured source. tier2 (Reputable-press attributed): AI named as a cause by credible journalism quoting a named company source, but not yet in a company filing. tier3 (Inferred / single-source): Attribution from one secondary tracker, an unnamed source, or vague forward-looking language."
},
"execution": {
"type": "array",
"items": {
"type": "string",
"enum": [
"executed",
"partial",
"announced",
"reversed",
"unknown"
]
},
"description": "Keep only these execution statuses. executed: The reduction has been carried out. partial: Some of the cut is done, the rest pending. announced: A stated plan, not yet carried out (often multi-year). unknown: Execution status not established. reversed: The cut was rolled back or rehired against (e.g. Commonwealth Bank)."
},
"country": {
"type": "string",
"maxLength": 80,
"pattern": "\\S",
"description": "Country as recorded, partial match, e.g. 'United States', 'India', 'Sweden'. For US-based roles use us_only."
},
"us_only": {
"type": "boolean",
"description": "Only events whose affected roles are US-based."
},
"sector": {
"type": "string",
"maxLength": 80,
"pattern": "\\S",
"description": "Sector, partial match, e.g. 'Financial', 'Software'."
},
"role": {
"type": "string",
"maxLength": 80,
"pattern": "\\S",
"description": "Affected function or occupation, partial match, e.g. 'customer service', 'engineering'."
},
"since": {
"type": "string",
"pattern": "^\\d{4}(-\\d{2}(-\\d{2})?)?$",
"description": "Earliest event date, inclusive: YYYY, YYYY-MM or YYYY-MM-DD."
},
"until": {
"type": "string",
"pattern": "^\\d{4}(-\\d{2}(-\\d{2})?)?$",
"description": "Latest event date, inclusive: YYYY, YYYY-MM or YYYY-MM-DD."
},
"counted_only": {
"type": "boolean",
"description": "Only events whose roles the register counts as AI-attributed (drops events that are reported but not counted)."
},
"sort": {
"type": "string",
"enum": [
"newest",
"oldest",
"largest"
],
"description": "newest first (default), oldest first, or the largest disclosed cut first."
},
"limit": {
"type": "integer",
"minimum": 1,
"maximum": 50,
"description": "Maximum events to return (default 10, at most 50)."
},
"full_context": {
"type": "boolean",
"description": "Also return each event's context paragraph and the register's caveats. Several times longer, so best with a small limit; get_company_ai_layoffs always includes them for one company."
}
},
"additionalProperties": false
}