Events

Concrete Event intelligence records and evidence relationships

Find concrete Events

GET

https://api.cafecito.tech

/espresso/events

Use when the user asks what happened to a company, person, product, region, or topic. Returns concrete Event records, not article bodies and not synthesized conclusions. Carry a selected data[].id into Event detail, evidence, or related-Signals routes. Use tags for fuzzy concepts; use structured filters for exact normalized values. categories is not an alias for event_types. Search Signals instead when the user asks for meaning, implication, or outlook. from and to bound record created_at, not occurrence or publication time.

Find concrete Events › query Parameters

q

string · maxLength: 1024

Optional natural-language semantic query. Max 1024 characters.

score_threshold

number · min: 0 · max: 1

Minimum semantic similarity threshold for q. 0.0 is broad and 1.0 is strict. Default 0.5.

Default: 0.5

from

string · date

Inclusive created_at lower bound (YYYY-MM-DD).

to

string · date

Inclusive created_at upper bound (YYYY-MM-DD).

ids

string[] · style: form

Restrict to Event UUIDs (CSV).

event_types

string[] · style: form

Exact Event type names in snake_case (CSV), for example policy_change,market_entry.

categories

string[] · style: form

Exact category names in snake_case (CSV), for example regulation,technology. This is separate from event_types.

entities

string[] · style: form

Exact entity names in snake_case, matched against company or people names (CSV), for example microsoft,nvidia.

impact_levels

string[] · style: form

Exact impact-level names (CSV), for example high,medium.

companies

string[] · style: form

Exact company names in snake_case (CSV), for example microsoft,nvidia.

people

string[] · style: form

Exact person names in snake_case (CSV), for example sam_altman,elon_musk.

products

string[] · style: form

Exact product names in snake_case (CSV), for example windows,geforce.

regions

string[] · style: form

Exact region names in snake_case (CSV), for example north_america,europe.

source_ids

string[] · style: form

Restrict to direct Event source UUIDs (CSV).

tags

string[] · style: form

Fuzzy text match against persisted tag labels (CSV).

response_type

string · enum

Response serialization: JSON is canonical; YAML and TOON are token-optimized for MCP and AI-agent clients. JSON is canonical; YAML and TOON are token-optimized for MCP and AI-agent clients.

Enum values:

json

yaml

toon

Default: json

limit

integer · min: 1 · max: 100

Maximum records per page. Default 20, max 100.

Default: 20

cursor

string

Opaque continuation token. Send pagination.next_cursor from a previous response unchanged as cursor; never construct or decode it.

Find concrete Events › Headers

Authorization

string · required

The Authorization header is used to authenticate with the API using your API key. Value is of the format Bearer YOUR_KEY_HERE.

Find concrete Events › Responses

Event collection envelope

EventCollectionResponse

EventDocument[] · required

ResponseMeta · required

Pagination · required

Collection pagination. Send next_cursor unchanged as the next request cursor. The response does not include a cursor echo field.

GET/espresso/events

curl https://api.cafecito.tech/espresso/events \
  --header 'Authorization: Bearer <token>'

Example Responses

{
  "data": [
    {
      "created_at": "2026-08-23T22:00:43-04:00",
      "drivers": [
        "UAE AI Programme adding Agentic AI focus",
        "Enclave42 launching verifiable AI inference service",
        "Syira AI expanding international presence with Doha office"
      ],
      "event_type": "ai_sector_expansion_in_middle_east",
      "future_outlook": "Continued expansion of AI infrastructure across GCC nations with increased investment in agentic systems",
      "id": "3a479e3c-a87d-591e-bb6c-5c83c03b6a40",
      "impact_level": "high",
      "impacted_domains": [
        "artificial_intelligence",
        "technology",
        "business_development",
        "regional_economic_growth"
      ],
      "impacts": [
        "Increased agentic AI adoption in UAE",
        "New AI inference capabilities deployed in Dubai",
        "International market entry by Syira AI"
      ],
      "key_points": [
        "UAE AI Programme adds Agentic AI focus",
        "Enclave42 launches verifiable AI inference in Dubai",
        "Syira AI opens new Doha Office"
      ],
      "kind": "event",
      "people": [
        "carrington_malin"
      ],
      "summary": "The Middle East AI News Minute highlights three major developments: UAE's AI Programme now emphasizes agentic AI capabilities, Enclave42 has launched verifiable AI inference in Dubai, and Syira AI opened a new office in Doha. These moves indicate accelerating AI adoption across regional markets. The UAE programme represents a strategic shift toward autonomous AI applications, while Enclave42's launch addresses verification needs in enterprise settings. Syira's expansion signals growing foreign direct investment in AI talent and operations within the region.",
      "tags": [
        "artificial_intelligence",
        "regional_economic_growth",
        "business_development",
        "carrington_malin",
        "generative_ai_and_foundation_models",
        "artificial_intelligence_and_machine_learning",
        "ai_sector_expansion_in_middle_east",
        "technology"
      ]
    }
  ],
  "pagination": {
    "limit": 1,
    "num_results": 1,
    "next_cursor": "eyJ2IjoxLCJpZCI6IjNhNDc5ZTNjLWE4N2QtNTkxZS1iYjZjLTVjODNjMDNiNmE0MCIsImMiOiIyMDI2LTA4LTIzVDIyOjAwOjQzLTA0OjAwIn0"
  },
  "meta": {
    "as_of": "2026-08-24T20:36:18.204225338Z"
  }
}

json

Inspect one Event

GET

https://api.cafecito.tech

/espresso/events/{event_id}

Use after selecting an Event from a collection. Returns its complete public view, optional Source provenance, and links/counts for available evidence and related Signals. Carry the Event ID to /events/{event_id}/evidence for supporting context or source coverage, or to /events/{event_id}/signals for associated higher-level conclusions. created_at is record creation time, not Event occurrence time.

Inspect one Event › path Parameters

event_id

string · uuid · required

Event UUID (RFC 4122).

Inspect one Event › query Parameters

response_type

string · enum

Response serialization: JSON is canonical; YAML and TOON are token-optimized for MCP and AI-agent clients. JSON is canonical; YAML and TOON are token-optimized for MCP and AI-agent clients.

Enum values:

json

yaml

toon

Default: json

Inspect one Event › Headers

Authorization

string · required

The Authorization header is used to authenticate with the API using your API key. Value is of the format Bearer YOUR_KEY_HERE.

Inspect one Event › Responses

Event detail envelope

EventDetailResponse

EventDetail · required

Event detail record. Collection Event fields plus conditional links and counts.

GET/espresso/events/{event_id}

curl https://api.cafecito.tech/espresso/events/:event_id \
  --header 'Authorization: Bearer <token>'

Example Responses

{
  "data": {
    "base_url": "www.middleeastainews.com",
    "counts": {
      "evidence": 54,
      "signals": 1
    },
    "created_at": "2026-08-23T22:00:43-04:00",
    "drivers": [
      "UAE AI Programme adding Agentic AI focus",
      "Enclave42 launching verifiable AI inference service",
      "Syira AI expanding international presence with Doha office"
    ],
    "event_type": "ai_sector_expansion_in_middle_east",
    "future_outlook": "Continued expansion of AI infrastructure across GCC nations with increased investment in agentic systems",
    "id": "3a479e3c-a87d-591e-bb6c-5c83c03b6a40",
    "impact_level": "high",
    "impacted_domains": [
      "artificial_intelligence",
      "technology",
      "business_development",
      "regional_economic_growth"
    ],
    "impacts": [
      "Increased agentic AI adoption in UAE",
      "New AI inference capabilities deployed in Dubai",
      "International market entry by Syira AI"
    ],
    "key_points": [
      "UAE AI Programme adds Agentic AI focus",
      "Enclave42 launches verifiable AI inference in Dubai",
      "Syira AI opens new Doha Office"
    ],
    "kind": "event",
    "links": {
      "evidence": "/events/3a479e3c-a87d-591e-bb6c-5c83c03b6a40/evidence",
      "signals": "/events/3a479e3c-a87d-591e-bb6c-5c83c03b6a40/signals"
    },
    "people": [
      "carrington_malin"
    ],
    "source": {
      "id": "8d47f649-a937-5b3e-b912-23495c6a8c4d",
      "url": "www.middleeastainews.com",
      "domain": "middleeastainews",
      "name": null
    },
    "source_id": "8d47f649-a937-5b3e-b912-23495c6a8c4d",
    "summary": "The Middle East AI News Minute highlights three major developments: UAE's AI Programme now emphasizes agentic AI capabilities, Enclave42 has launched verifiable AI inference in Dubai, and Syira AI opened a new office in Doha. These moves indicate accelerating AI adoption across regional markets. The UAE programme represents a strategic shift toward autonomous AI applications, while Enclave42's launch addresses verification needs in enterprise settings. Syira's expansion signals growing foreign direct investment in AI talent and operations within the region.",
    "tags": [
      "artificial_intelligence",
      "regional_economic_growth",
      "business_development",
      "carrington_malin",
      "generative_ai_and_foundation_models",
      "artificial_intelligence_and_machine_learning",
      "ai_sector_expansion_in_middle_east",
      "technology"
    ],
    "url": "https://www.middleeastainews.com/p/uae-ai-programme-adds-agentic-ai"
  }
}

json

Inspect evidence for an Event

GET

https://api.cafecito.tech

/espresso/events/{event_id}/evidence

Use after selecting an Event when the user needs supporting context, available source coverage, or traceability. Returns directly related evidence records with identity, creation time, tags, Source IDs, and available URLs. This is not an article-body endpoint, a story-clustering endpoint, or a complete record-history export. An empty collection means no evidence records are available for this Event under the supplied filters.

Inspect evidence for an Event › path Parameters

event_id

string · uuid · required

Event UUID (RFC 4122).

Inspect evidence for an Event › query Parameters

ids

string[] · style: form

Restrict returned evidence records to Event UUIDs (CSV).

source_ids

string[] · style: form

Restrict direct evidence records to Source UUIDs (CSV).

from

string · date

Inclusive evidence created_at lower bound (YYYY-MM-DD).

to

string · date

Inclusive evidence created_at upper bound (YYYY-MM-DD).

response_type

string · enum

Response serialization: JSON is canonical; YAML and TOON are token-optimized for MCP and AI-agent clients. JSON is canonical; YAML and TOON are token-optimized for MCP and AI-agent clients.

Enum values:

json

yaml

toon

Default: json

limit

integer · min: 1 · max: 100

Maximum records per page. Default 20, max 100.

Default: 20

cursor

string

Opaque continuation token. Send pagination.next_cursor from a previous response unchanged as cursor; never construct or decode it.

Inspect evidence for an Event › Headers

Authorization

string · required

The Authorization header is used to authenticate with the API using your API key. Value is of the format Bearer YOUR_KEY_HERE.

Inspect evidence for an Event › Responses

Event evidence collection envelope

EventEvidenceCollectionResponse

EventEvidence[] · required

ResponseMeta · required

Pagination · required

Collection pagination. Send next_cursor unchanged as the next request cursor. The response does not include a cursor echo field.

GET/espresso/events/{event_id}/evidence

curl https://api.cafecito.tech/espresso/events/:event_id/evidence \
  --header 'Authorization: Bearer <token>'

Example Responses

{
  "data": [
    {
      "id": "3a479e3c-a87d-591e-bb6c-5c83c03b6a40",
      "kind": "event",
      "created_at": "2026-08-23T22:00:43-04:00",
      "tags": [
        "artificial_intelligence",
        "regional_economic_growth",
        "business_development",
        "carrington_malin",
        "generative_ai_and_foundation_models",
        "artificial_intelligence_and_machine_learning",
        "ai_sector_expansion_in_middle_east",
        "technology"
      ],
      "source_id": "8d47f649-a937-5b3e-b912-23495c6a8c4d",
      "url": "https://www.middleeastainews.com/p/uae-ai-programme-adds-agentic-ai",
      "base_url": "www.middleeastainews.com"
    }
  ],
  "pagination": {
    "limit": 1,
    "num_results": 1,
    "next_cursor": "eyJ2IjoxLCJpZCI6IjNhNDc5ZTNjLWE4N2QtNTkxZS1iYjZjLTVjODNjMDNiNmE0MCIsImMiOiIyMDI2LTA4LTIzVDIyOjAwOjQzLTA0OjAwIn0"
  },
  "meta": {
    "as_of": "2026-08-24T20:38:44.456102494Z"
  }
}

json

Find Signals connected to an Event

GET

https://api.cafecito.tech

/espresso/events/{event_id}/signals

Use after selecting an Event to find higher-level conclusions associated with that development. Returns Signal records that can be inspected individually or followed to their supporting Events. An empty collection means Espresso has no available Signal connected to this Event; it does not invalidate the Event. This route narrows associated Signals; use /signals for a new Signal search.

Find Signals connected to an Event › path Parameters

event_id

string · uuid · required

Event UUID (RFC 4122).

Find Signals connected to an Event › query Parameters

ids

string[] · style: form

Restrict returned Signals to Signal UUIDs (CSV).

from

string · date

Inclusive Signal created_at lower bound (YYYY-MM-DD).

to

string · date

Inclusive Signal created_at upper bound (YYYY-MM-DD).

impact_levels

string[] · style: form

Exact impact-level names (CSV), for example high,medium.

impacted_domains

string[] · style: form

Exact impacted-domain names in snake_case (CSV), for example public_health,climate.

tags

string[] · style: form

Fuzzy text match against persisted Signal tag labels (CSV).

response_type

string · enum

Response serialization: JSON is canonical; YAML and TOON are token-optimized for MCP and AI-agent clients. JSON is canonical; YAML and TOON are token-optimized for MCP and AI-agent clients.

Enum values:

json

yaml

toon

Default: json

limit

integer · min: 1 · max: 100

Maximum records per page. Default 20, max 100.

Default: 20

cursor

string

Opaque continuation token. Send pagination.next_cursor from a previous response unchanged as cursor; never construct or decode it.

Find Signals connected to an Event › Headers

Authorization

string · required

The Authorization header is used to authenticate with the API using your API key. Value is of the format Bearer YOUR_KEY_HERE.

Find Signals connected to an Event › Responses

Signals derived from this Event

SignalCollectionResponse

SignalDocument[] · required

ResponseMeta · required

Pagination · required

Collection pagination. Send next_cursor unchanged as the next request cursor. The response does not include a cursor echo field.

GET/espresso/events/{event_id}/signals

curl https://api.cafecito.tech/espresso/events/:event_id/signals \
  --header 'Authorization: Bearer <token>'

Example Responses

{
  "data": [
    {
      "categories": [
        "media_and_journalism",
        "artificial_intelligence_and_machine_learning",
        "generative_ai_and_foundation_models"
      ],
      "companies": [
        "dubai_university",
        "spotify",
        "qatar_university"
      ],
      "confidence": "high",
      "created_at": "2026-08-23T22:00:43-04:00",
      "drivers": [
        "Governing bodies implement structured AI policies",
        "Private firms leverage AI for competitive advantage"
      ],
      "future_outlook": "Continued acceleration of AI-integrated economic activity across North Africa and Southern Europe",
      "id": "72f16578-f9b3-5921-b595-90977d00493d",
      "impact_level": "high",
      "impacted_domains": [
        "technology",
        "food_safety",
        "financial_services",
        "algorithmic_governance"
      ],
      "impacts": [
        "Trade increases via efficient logistics",
        "Environment protects from algal blooms",
        "Capital inflow fuels AI ventures",
        "Data quality rises with fraud prevention"
      ],
      "key_points": [
        "2026-07-25 UAE launches AI policy training program",
        "2026-07-25 Morocco deploys AI drones to control toxic algae",
        "2026-07-25 Saudi AI startups achieve 5x revenue over traditional rivals",
        "2026-07-25 SDAIA publishes AI bias mapping guide for 100+ types"
      ],
      "kind": "signal",
      "people": [
        "anghami",
        "carrington_malin",
        "muhammad_khalid",
        "deezer",
        "daniel_valle",
        "dubai_chambers"
      ],
      "regions": [
        "oman",
        "casablanca",
        "egypt",
        "saudi_arabia",
        "morocco",
        "japan",
        "riyadh",
        "abu_dhabi"
      ],
      "summary": "Multiple high‑impact AI initiatives unfolded concurrently in late July 2026, including UAE policy formation, Moroccan agricultural monitoring, Saudi startup success stories, and Saudi agency standardisation. Drivers included proactive regulatory action and entrepreneurial responsiveness driving tangible returns, safety improvements and confidence building.",
      "tags": [
        "oman",
        "riyadh",
        "abu_dhabi",
        "spotify",
        "carrington_malin",
        "egypt",
        "daniel_valle",
        "anghami",
        "dubai_chambers",
        "algorithmic_governance",
        "media_and_journalism",
        "qatar_university",
        "dubai_university",
        "food_safety",
        "casablanca",
        "artificial_intelligence_and_machine_learning",
        "financial_services",
        "generative_ai_and_foundation_models",
        "japan",
        "deezer",
        "morocco",
        "technology",
        "muhammad_khalid",
        "saudi_arabia"
      ]
    }
  ],
  "pagination": {
    "limit": 1,
    "num_results": 1,
    "next_cursor": null
  },
  "meta": {
    "as_of": "2026-08-24T20:38:44.504323225Z"
  }
}

json

Signals

Find concrete Events

GET

https://api.cafecito.tech

/espresso/events

Find concrete Events › query Parameters

q

string · maxLength: 1024

Optional natural-language semantic query. Max 1024 characters.

score_threshold

number · min: 0 · max: 1

Minimum semantic similarity threshold for q. 0.0 is broad and 1.0 is strict. Default 0.5.

Default: 0.5

from

string · date

Inclusive created_at lower bound (YYYY-MM-DD).

to

string · date

Inclusive created_at upper bound (YYYY-MM-DD).

ids

string[] · style: form

Restrict to Event UUIDs (CSV).

event_types

string[] · style: form

Exact Event type names in snake_case (CSV), for example policy_change,market_entry.

categories

string[] · style: form

Exact category names in snake_case (CSV), for example regulation,technology. This is separate from event_types.

entities

string[] · style: form

Exact entity names in snake_case, matched against company or people names (CSV), for example microsoft,nvidia.

impact_levels

string[] · style: form

Exact impact-level names (CSV), for example high,medium.

companies

string[] · style: form

Exact company names in snake_case (CSV), for example microsoft,nvidia.

people

string[] · style: form

Exact person names in snake_case (CSV), for example sam_altman,elon_musk.

products

string[] · style: form

Exact product names in snake_case (CSV), for example windows,geforce.

regions

string[] · style: form

Exact region names in snake_case (CSV), for example north_america,europe.

source_ids

string[] · style: form

Restrict to direct Event source UUIDs (CSV).

tags

string[] · style: form

Fuzzy text match against persisted tag labels (CSV).

response_type

string · enum

Response serialization: JSON is canonical; YAML and TOON are token-optimized for MCP and AI-agent clients. JSON is canonical; YAML and TOON are token-optimized for MCP and AI-agent clients.

Enum values:

json

yaml

toon

Default: json

limit

integer · min: 1 · max: 100

Maximum records per page. Default 20, max 100.

Default: 20

cursor

string

Opaque continuation token. Send pagination.next_cursor from a previous response unchanged as cursor; never construct or decode it.

Find concrete Events › Headers

Authorization

string · required

The Authorization header is used to authenticate with the API using your API key. Value is of the format Bearer YOUR_KEY_HERE.

Find concrete Events › Responses

Event collection envelope

EventCollectionResponse

EventDocument[] · required

ResponseMeta · required

Pagination · required

Collection pagination. Send next_cursor unchanged as the next request cursor. The response does not include a cursor echo field.

Inspect one Event

GET

https://api.cafecito.tech

/espresso/events/{event_id}

Inspect one Event › path Parameters

event_id

string · uuid · required

Event UUID (RFC 4122).

Inspect one Event › query Parameters

response_type

string · enum

Response serialization: JSON is canonical; YAML and TOON are token-optimized for MCP and AI-agent clients. JSON is canonical; YAML and TOON are token-optimized for MCP and AI-agent clients.

Enum values:

json

yaml

toon

Default: json

Inspect one Event › Headers

Authorization

string · required

The Authorization header is used to authenticate with the API using your API key. Value is of the format Bearer YOUR_KEY_HERE.

Inspect one Event › Responses

Event detail envelope

EventDetailResponse

EventDetail · required

Event detail record. Collection Event fields plus conditional links and counts.

Inspect evidence for an Event

GET

https://api.cafecito.tech

/espresso/events/{event_id}/evidence

Inspect evidence for an Event › path Parameters

event_id

string · uuid · required

Event UUID (RFC 4122).

Inspect evidence for an Event › query Parameters

ids

string[] · style: form

Restrict returned evidence records to Event UUIDs (CSV).

source_ids

string[] · style: form

Restrict direct evidence records to Source UUIDs (CSV).

from

string · date

Inclusive evidence created_at lower bound (YYYY-MM-DD).

to

string · date

Inclusive evidence created_at upper bound (YYYY-MM-DD).

response_type

string · enum

Response serialization: JSON is canonical; YAML and TOON are token-optimized for MCP and AI-agent clients. JSON is canonical; YAML and TOON are token-optimized for MCP and AI-agent clients.

Enum values:

json

yaml

toon

Default: json

limit

integer · min: 1 · max: 100

Maximum records per page. Default 20, max 100.

Default: 20

cursor

string

Opaque continuation token. Send pagination.next_cursor from a previous response unchanged as cursor; never construct or decode it.

Inspect evidence for an Event › Headers

Authorization

string · required

The Authorization header is used to authenticate with the API using your API key. Value is of the format Bearer YOUR_KEY_HERE.

Inspect evidence for an Event › Responses

Event evidence collection envelope

EventEvidenceCollectionResponse

EventEvidence[] · required

ResponseMeta · required

Pagination · required

Collection pagination. Send next_cursor unchanged as the next request cursor. The response does not include a cursor echo field.

Find Signals connected to an Event

GET

https://api.cafecito.tech

/espresso/events/{event_id}/signals

Find Signals connected to an Event › path Parameters

event_id

string · uuid · required

Event UUID (RFC 4122).

Find Signals connected to an Event › query Parameters

ids

string[] · style: form

Restrict returned Signals to Signal UUIDs (CSV).

from

string · date

Inclusive Signal created_at lower bound (YYYY-MM-DD).

to

string · date

Inclusive Signal created_at upper bound (YYYY-MM-DD).

impact_levels

string[] · style: form

Exact impact-level names (CSV), for example high,medium.

impacted_domains

string[] · style: form

Exact impacted-domain names in snake_case (CSV), for example public_health,climate.

tags

string[] · style: form

Fuzzy text match against persisted Signal tag labels (CSV).

response_type

string · enum

Response serialization: JSON is canonical; YAML and TOON are token-optimized for MCP and AI-agent clients. JSON is canonical; YAML and TOON are token-optimized for MCP and AI-agent clients.

Enum values:

json

yaml

toon

Default: json

limit

integer · min: 1 · max: 100

Maximum records per page. Default 20, max 100.

Default: 20

cursor

string

Opaque continuation token. Send pagination.next_cursor from a previous response unchanged as cursor; never construct or decode it.

Find Signals connected to an Event › Headers

Authorization

string · required

The Authorization header is used to authenticate with the API using your API key. Value is of the format Bearer YOUR_KEY_HERE.

Find Signals connected to an Event › Responses

Signals derived from this Event

SignalCollectionResponse

SignalDocument[] · required

ResponseMeta · required

Pagination · required

Collection pagination. Send next_cursor unchanged as the next request cursor. The response does not include a cursor echo field.