---
title: "List Wire"
method: POST
path: "/v0/search/list_wire"
tags: ["V0", "Search", "HAS_MCP_EQUIVALENT"]
---

# List Wire

`POST /v0/search/list_wire`

## Request

- Base URL: `https://api.ultralayer.ai`
- URL: `https://api.ultralayer.ai/v0/search/list_wire`
- Auth: HTTP bearer

Return the most recent wire items that match the given filters.

## Request body

- WireListParams
  - `start_timestamp` string, date-time, nullable: System timestamp; Inclusive ISO 8601
  - `end_timestamp` string, date-time, nullable: System timestamp; Inclusive ISO 8601; null=realtime
  - `max_records` integer
  - `novelty` string[], nullable: Match any.
  - `content_type` string[], nullable: Match any.
  - `recency` string[], nullable: Match any.
  - `source_relationship` string[], nullable: Match any.
  - `factuality` string[], nullable: Match any.
  - `categories` string[], nullable: Match any.
  - `entities` string[], nullable: Match any.
  - `entity_relevance` string[], nullable: Match any.
  - `min_entity_sentiment` number, nullable: +-.2 neutral; +-.2-.6 mod; +-.6+ strong; both: >=min OR <=max
  - `max_entity_sentiment` number, nullable
  - `sectors` string[], nullable: Match any.
  - `industries` string[], nullable: Match any.
  - `countries` string[], nullable: Match any; lowercase ISO 3166-1 alpha-2
  - `asset_classes` string[], nullable: Match any.
  - `publisher` string[], nullable: Match any.
  - `min_importance_score` number, nullable: 0-.2 noise; .2-.4 low; .4-.6 mod; .6-.8 high; .8-1 critical
  - `min_trustworthiness_score` number, nullable: <.2 anon; .4-.6 mod; .6+ reputable; .8+ official
  - `detail` 'full' | 'standard' | 'essential': essential:minimal; standard:citable; full:all.

## Response `200`

Wire items at detail=full.

- WireItem[]
  - `wire_id` integer, required: Primary key of the wire row.
  - `timestamp` string, date-time, required: Canonical system time when this item was put on the wire.
  - `source_timestamp` string, date-time, required: Source last-update time.
  - `headline` string, required: Ultralayer-generated headline.
  - `publisher` string, nullable, required: Normalized publisher/source label, when known.
  - `url` string, required: Link to the original item.
  - `content_type` 'news' | 'analysis' | 'opinion' | 'press_release' | 'data_release', required: Kind of item.
  - `categories` string[], required: Multi-label event/theme tags.
  - `recency` 'realtime' | 'report_of_past' | 'report_of_future', required: Whether the item is about now, the past, or the future.
  - `source_relationship` 'first_party' | 'reporting' | 'second_hand', required: How close the source is to the information.
  - `factuality` 'confirmed' | 'reported' | 'rumor' | 'speculation' | 'forecast', required: Epistemic status of the item's core claim.
  - `novelty` 'new' | 'update' | 'duplicate' | 'correction', required: Story-lifecycle label relative to prior wire items.
  - `prior_wire_id` integer, nullable, required: Matched earlier wire item for update|duplicate|correction; null for new.
  - `trustworthiness_score` number, required: 0..1 source credibility score.
  - `importance_score` number, required: 0..1 market-importance score.
  - `about` WireAbout, required: Market-level scope dimensions for a wire item. May be inferred, not only explicitly named.
    - `sectors` string[]: GICS-style sectors this item is about.
    - `industries` string[]: Free-form industry labels this item is about.
    - `countries` string[]: Lowercase country codes this item is about.
    - `asset_classes` string[]: Asset classes this item is about.
  - `entities` WireEntityDetail[], required: Grounded entities with per-entity relevance and sentiment.
    - `entity_id` integer, required: Stable Ultralayer entity id.
    - `canonical_name` string, required: Canonical entity name.
    - `identifiers` string[]: Document-grounded lexical references to this entity in the item text.
    - `entity_type` string, required: Entity type label (e.g. COMPANY, PERSON).
    - `relevance` 'primary' | 'significant' | 'contextual' | 'incidental', required: How central the entity is to the item.
    - `sentiment` number, required: -1..1 directional market implication of this item for this entity.

## Other responses

- `422`: Validation Error

---

[API](https://skmtc.dev/ultralayer/apis/ultralayer-api.md) · [All operations](https://skmtc.dev/ultralayer/apis/ultralayer-api/llms.txt) · [OpenAPI document](https://skmtc.dev/ultralayer/apis/ultralayer-api/revisions/4185459222be?raw)