Schemas

IcdbVideoSummary

uuid

string · uuid

primary_id

integer

primary_date

string · date

entity

string

primary_country

string

title

string

second_geo_layer

string

dominant_lat

number

dominant_long

number

summary

string

IcdbVideoDetail

uuid

string · uuid

primary_id

integer

primary_date

string · date

entity

string

primary_country

string

second_geo_layer

string

dominant_lat

number

dominant_long

number

title

string

summary

string

report

string

transcript

string

IcdbVideoSearchResponse

itemsReceived

integer

curPage

integer

nextPage

integer | null

prevPage

integer | null

offset

integer

perPage

integer

itemsTotal

integer

pageTotal

integer

IcdbVideoSummary[]

IcdbVideoPlayerResponse

status

string

embed_url

string

expires

integer

uuid

string · uuid

title

string

IcdVideoSummary

uuid

string · uuid

primary_id

integer

primary_date

string · date

entity

string

primary_country

string

title

string

second_geo_layer

string

dominant_lat

number

dominant_long

number

summary

string

IcdVideoDetail

uuid

string · uuid

primary_id

integer

primary_date

string · date

entity

string

primary_country

string

second_geo_layer

string

dominant_lat

number

dominant_long

number

title

string

summary

string

report

string

transcript

string

IcdVideoSearchResponse

itemsReceived

integer

curPage

integer

nextPage

integer | null

prevPage

integer | null

offset

integer

perPage

integer

itemsTotal

integer

pageTotal

integer

IcdVideoSummary[]

IcdVideoPlayerResponse

status

string

embed_url

string

expires

integer

uuid

string · uuid

title

string

IcdImageSummary

uuid

string · uuid

primary_id

integer

primary_date

string · date

entity

string

primary_country

string

title

string

second_geo_layer

string

dominant_lat

number

dominant_long

number

summary

string

IcdImageDetail

uuid

string · uuid

primary_id

integer

primary_date

string · date

entity

string

primary_country

string

second_geo_layer

string

dominant_lat

number

dominant_long

number

title

string

summary

string

report

string

transcript

string

IcdImageSearchResponse

itemsReceived

integer

curPage

integer

nextPage

integer | null

prevPage

integer | null

offset

integer

perPage

integer

itemsTotal

integer

pageTotal

integer

IcdImageSummary[]

IcdImageViewerResponse

status

string

signed_url

string

uuid

string · uuid

title

string

IcdbImageSummary

uuid

string · uuid

primary_id

integer

primary_date

string · date

entity

string

primary_country

string

title

string

second_geo_layer

string

dominant_lat

number

dominant_long

number

summary

string

IcdbImageDetail

uuid

string · uuid

primary_id

integer

primary_date

string · date

entity

string

primary_country

string

second_geo_layer

string

dominant_lat

number

dominant_long

number

title

string

summary

string

report

string

transcript

string

IcdbImageSearchResponse

itemsReceived

integer

curPage

integer

nextPage

integer | null

prevPage

integer | null

offset

integer

perPage

integer

itemsTotal

integer

pageTotal

integer

IcdbImageSummary[]

IcdbImageViewerResponse

status

string

signed_url

string

uuid

string · uuid

title

string

IcdNlSearchItem

uuid

string · uuid

primary_id

integer

primary_date

string · date

entity

string

primary_country

string

source_component

string

source_database

string

sub_entity

string

score

number

match_chunk_id

string

section_type

string

summary

string

title

string | null

IcdNlSearchResponse

status

string

itemsReceived

integer

curPage

integer

nextPage

integer | null

prevPage

integer | null

offset

integer

perPage

integer

itemsTotal

integer

pageTotal

integer

retrieval_question

string

source_component_filter

string

top_k

integer

IcdNlSearchItem[]

IcdbNlSearchItem

uuid

string · uuid

primary_id

integer

primary_date

string · date

entity

string

primary_country

string

source_component

string

source_database

string

sub_entity

string

score

number

match_chunk_id

string

section_type

string

summary

string

title

string | null

IcdbNlSearchResponse

status

string

itemsReceived

integer

curPage

integer

nextPage

integer | null

prevPage

integer | null

offset

integer

perPage

integer

itemsTotal

integer

pageTotal

integer

retrieval_question

string

source_component_filter

string

top_k

integer

IcdbNlSearchItem[]

IcdDomainGenAiChatRequest

question

string · required

conversation_id

string · minLength: 1 · maxLength: 128

Opaque identifier returned by a successful earlier turn. Omit it to start a new conversation.

primary_country

string

entity

string

top_k

integer

IcdbDomainGenAiChatRequest

question

string · required

conversation_id

string · minLength: 1 · maxLength: 128

Opaque identifier returned by a successful earlier turn. Omit it to start a new conversation.

primary_country

string

entity

string

top_k

integer

IcdDomainGenAiChatResponse

status

string · enum · required

Enum values:

answer

string | null · required

response_id

string | null · required

DomainGenAiSource[] · required

conversation_id

string | null · required

conversation_expires_at

integer | null · int64 · required

conversation_absolute_expires_at

integer | null · int64 · required

DomainGenAiUsage · required

IcdbDomainGenAiChatResponse

status

string · enum · required

Enum values:

answer

string | null · required

response_id

string | null · required

DomainGenAiSource[] · required

conversation_id

string | null · required

conversation_expires_at

integer | null · int64 · required

conversation_absolute_expires_at

integer | null · int64 · required

DomainGenAiUsage · required

GeoManifestItem

database

string · enum · required

Enum values:

ICD

ICDB

component

string · enum · required

Enum values:

Image

Video

uuid

string · uuid · required

component_id

integer · required

latitude

number · min: -90 · max: 90 · required

longitude

number · min: -180 · max: 180 · required

title

string | null

primary_date

string | null · date

entity

string | null

country

string | null

second_geo_layer

string | null

GeoManifestResponse

status

string · enum · required

Enum values:

database

string · enum · required

Enum values:

ICD

ICDB

component

string · enum · required

Enum values:

Image

Video

GeoManifestItem[] · required

items_returned

integer · min: 0 · max: 1000 · required

items_returned_total

integer · min: 0 · required

Cumulative valid map records returned in this cursor traversal.

source_items_scanned

integer · min: 0 · max: 1000 · required

Authorized source records examined for this response.

source_items_scanned_total

integer · min: 0 · required

Cumulative authorized source records examined in this traversal.

pagination_mode

string · enum · required

Enum values:

cursor

next_cursor

string | null · required

Opaque continuation bound to this dataset and filter snapshot. Repeat the same filters with this cursor.

page

integer · min: 1 · required

One-based response ordinal for this cursor traversal.

per_page

integer · min: 1 · max: 1000 · required

mappable_matches

integer | null · min: 0 · required

Valid map records encountered. Null until an uncapped traversal completes.

complete

boolean · required

result_limit

integer · min: 1 · required

Maximum authorized source-result window available to this consumer.

limit_reached

boolean · required

sort_order

string · enum · required

Deterministic newest-first ordering. Component ID descending resolves records with the same primary date.

Enum values:

primary_date_desc_component_id_desc

next_page

integer | null · min: 1

previous_page

integer | null · min: 1

total_matches

integer | null · min: 0

Reserved exact authorized match count. Null in the count-free Phase 1.5 contract.

GeoManifestGeoJsonResponse

type

string · enum · required

Enum values:

FeatureCollection

object[] · required

object · required

DomainGenAiSource

Customer-safe citation. Approved fields are available directly and through metadata for compatibility with existing integrations.

array · maxItems: 0 · required

Reserved compatibility field. This array is currently empty.

DomainGenAiSourceMetadata · required

Citation metadata returned with the source.

source_database

string

source_component

string

primary_date

string

primary_country

string

entity

string

sub_entity

string

title

string

score

number | null

Retrieval relevance score when available.

DomainGenAiUsage

prompt_tokens

integer | null · min: 0 · required

output_tokens

integer | null · min: 0 · required

total_tokens

integer | null · min: 0 · required

DomainGenAiChatResponse

status

string · enum · required

Enum values:

answer

string | null · required

response_id

string | null · required

DomainGenAiSource[] · required

conversation_id

string | null · required

conversation_expires_at

integer | null · int64 · required

conversation_absolute_expires_at

integer | null · int64 · required

DomainGenAiUsage · required

DomainGenAiConversationUnavailableError

error

string · enum · required

Enum values:

conversation_unavailable

message

string · required

DomainGenAiSourceMetadata

Citation metadata returned with the source.

source_database

string

source_component

string

primary_date

string

primary_country

string

entity

string

sub_entity

string

title

string

IcdDomainGenAiChatResponse

status

string · enum · required

Enum values:

answer

string | null · required

response_id

string | null · required

DomainGenAiSource[] · required

conversation_id

string | null · required

conversation_expires_at

integer | null · int64 · required

conversation_absolute_expires_at

integer | null · int64 · required

DomainGenAiUsage · required

IcdbDomainGenAiChatResponse

status

string · enum · required

Enum values:

answer

string | null · required

response_id

string | null · required

DomainGenAiSource[] · required

conversation_id

string | null · required

conversation_expires_at

integer | null · int64 · required

conversation_absolute_expires_at

integer | null · int64 · required

DomainGenAiUsage · required

GeoManifestItem

database

string · enum · required

Enum values:

ICD

ICDB

component

string · enum · required

Enum values:

Image

Video

uuid

string · uuid · required

component_id

integer · required

latitude

number · min: -90 · max: 90 · required

longitude

number · min: -180 · max: 180 · required

title

string | null

primary_date

string | null · date

entity

string | null

country

string | null

second_geo_layer

string | null

GeoManifestResponse

status

string · enum · required

Enum values:

database

string · enum · required

Enum values:

ICD

ICDB

component

string · enum · required

Enum values:

Image

Video

GeoManifestItem[] · required

items_returned

integer · min: 0 · max: 1000 · required

items_returned_total

integer · min: 0 · required

Cumulative valid map records returned in this cursor traversal.

source_items_scanned

integer · min: 0 · max: 1000 · required

Authorized source records examined for this response.

source_items_scanned_total

integer · min: 0 · required

Cumulative authorized source records examined in this traversal.

pagination_mode

string · enum · required

Enum values:

cursor

next_cursor

string | null · required

Opaque continuation bound to this dataset and filter snapshot. Repeat the same filters with this cursor.

page

integer · min: 1 · required

One-based response ordinal for this cursor traversal.

per_page

integer · min: 1 · max: 1000 · required

mappable_matches

integer | null · min: 0 · required

Valid map records encountered. Null until an uncapped traversal completes.

complete

boolean · required

result_limit

integer · min: 1 · required

Maximum authorized source-result window available to this consumer.

limit_reached

boolean · required

sort_order

string · enum · required

Deterministic newest-first ordering. Component ID descending resolves records with the same primary date.

Enum values:

primary_date_desc_component_id_desc

next_page

integer | null · min: 1

previous_page

integer | null · min: 1

total_matches

integer | null · min: 0

Reserved exact authorized match count. Null in the count-free Phase 1.5 contract.

DomainGenAiSource

Customer-safe citation. Approved fields are available directly and through metadata for compatibility with existing integrations.

array · maxItems: 0 · required

Reserved compatibility field. This array is currently empty.

DomainGenAiSourceMetadata · required

Citation metadata returned with the source.

source_database

string

source_component

string

primary_date

string

primary_country

string

entity

string

sub_entity

string

title

string

score

number | null

Retrieval relevance score when available.

DomainGenAiChatResponse

status

string · enum · required

Enum values:

answer

string | null · required

response_id

string | null · required

DomainGenAiSource[] · required

conversation_id

string | null · required

conversation_expires_at

integer | null · int64 · required

conversation_absolute_expires_at

integer | null · int64 · required

DomainGenAiUsage · required