Data Types
Tables come from OpenAPI and show field meanings, types, requirements and constraints. Links open nested definitions.
Optional fields may be absent; nullable fields may be null. Preserve additional fields and provenance. Examples are illustrative.
HealthResponse
| Field | Type | Required | Meaning / constraints |
|---|
status | string | Yes | |
service | string | Yes | |
ModelsResponse
| Field | Type | Required | Meaning / constraints |
|---|
data | array of CatalogModel | Yes | |
total_count | integer | Yes | |
ModelQuery
| Field | Type | Required | Meaning / constraints |
|---|
q | string or null | No | |
query | string or null | No | |
price | string or null | No | |
provider | string or null | No | |
source | string or null | No | |
input_modality | string or null | No | |
capability | array of string | Yes | |
sort | string or null | No | |
limit | integer or null | No | |
offset | integer or null | No | |
output_modalities | string or null | No | |
developer | string,null | No | Canonical developer ID; groups reviewed publisher aliases. |
inference_provider | string,null | No | Registered inference source ID; selects current source offerings, including price-only records. Adds source-scoped provider_prices; other model fields retain canonical scope. |
model_type | string or null | No | Match a displayed model classification, including secondary types. Use multimodal for MLLM, vlm for image-only VLM, llm for text LLM, or another model type ID from a classification link. unknown selects models without reported classification evidence. Omit or use all for no type filter. Combines with other discovery filters before pagination and counts; an unrecognized ID returns an empty result. |
CatalogWindowQuery
| Field | Type | Required | Meaning / constraints |
|---|
limit | integer or null | No | |
offset | integer or null | No | |
LeaderboardsQuery
| Field | Type | Required | Meaning / constraints |
|---|
q | string or null | No | |
query | string or null | No | |
source | string or null | No | |
source_id | string or null | No | |
dimension | string or null | No | |
benchmark | string or null | No | |
benchmark_id | string or null | No | |
leaderboard | string or null | No | |
leaderboard_id | string or null | No | |
entry_limit | integer or null | No | |
leaderboard_limit | integer or null | No | |
limit | integer or null | No | |
offset | integer or null | No | |
ModelAliasDto
| Field | Type | Required | Meaning / constraints |
|---|
source_id | string | Yes | |
source_model_id | string | Yes | |
alias_type | string | Yes | Source identity relationship. routing denotes an explicitly declared moving alias; its canonical target can change on source refresh. |
confidence | number | Yes | |
PricePointDto
| Field | Type | Required | Meaning / constraints |
|---|
source_id | string | Yes | |
platform | string | Yes | |
source_model_id | string | Yes | |
unit | string | Yes | |
amount_usd | number | Yes | |
currency | string | Yes | |
effective_at | string · date-time or null | No | |
source_url | string or null | No | |
source_retrieved_at | string · date-time or null | No | |
conditions | object | No | Billing qualifiers; compare only matching unit, currency and conditions. |
billing_label | string,null | No | Original published billing label. |
pricing_via | string,null | No | Gateway route, distinct from the actual serving platform. |
receipt_id | string,null · uuid | No | Exact source receipt for this quote; null denotes unknown attribution. |
PriceQuery
| Field | Type | Required | Meaning / constraints |
|---|
q | string or null | No | |
query | string or null | No | |
provider | string or null | No | |
source | string or null | No | |
platform | string or null | No | |
unit | string or null | No | |
sort | string or null | No | |
limit | integer or null | No | |
offset | integer or null | No | |
PriceComparisonResponse
PriceComparisonRowDto
| Field | Type | Required | Meaning / constraints |
|---|
canonical_model_id | string | Yes | |
provider | string | Yes | |
display_name | string | Yes | |
source_id | string | Yes | |
platform | string | Yes | |
source_model_id | string | Yes | |
unit | string | Yes | |
amount_usd | number | Yes | |
currency | string | Yes | |
effective_at | string · date-time or null | No | |
source_url | string or null | No | |
source_retrieved_at | string · date-time or null | No | |
updated_at | string · date-time | Yes | |
conditions | object | No | Billing qualifiers; compare only matching unit, currency and conditions. |
billing_label | string,null | No | Original published billing label. |
pricing_via | string,null | No | Gateway route, distinct from the actual serving platform. |
receipt_id | string,null · uuid | No | Exact source receipt for this quote; null denotes unknown attribution. |
BenchmarkScoreDto
| Field | Type | Required | Meaning / constraints |
|---|
source_id | string | Yes | |
benchmark_id | string | Yes | |
benchmark_name | string | Yes | |
leaderboard_id | string | Yes | |
leaderboard_name | string or null | No | |
dimension | string | Yes | |
metric | string | Yes | |
score | number or null | No | |
unit | string | Yes | |
rank | integer or null | No | |
confidence_lower | number or null | No | |
confidence_upper | number or null | No | |
sample_size | integer or null | No | |
evaluated_at | string · date-time or null | No | |
source_url | string or null | No | |
source_retrieved_at | string · date-time or null | No | |
source_record_id | string,null | No | |
source_model_id | string,null | No | |
aggregation_scope | object,null | No | Source aggregation coverage, including task count, revision count and sample, dataset splits and subset coverage. An aggregate spanning revisions is not a single-checkpoint measurement. |
receipt_id | string,null · uuid | No | Exact source receipt for this observation; null denotes unknown attribution. |
SourceReceiptDto
| Field | Type | Required | Meaning / constraints |
|---|
receipt_id | string · uuid | Yes | |
source_id | string | Yes | |
source_url | string | Yes | |
retrieved_at | string · date-time | Yes | |
published_at | string · date-time or null | No | |
parser_version | string | Yes | |
record_count | integer | Yes | |
checksum_sha256 | string | Yes | |
SourceRecordDto
| Field | Type | Required | Meaning / constraints |
|---|
source_id | string | Yes | |
source_record_id | string | Yes | |
receipt_id | string · uuid or null | No | |
confidence | number | Yes | |
updated_at | string · date-time | Yes | |
raw_payload | any JSON | Yes | |
link_corrections | array of SourceLinkCorrection | No | |
ModelSourceSummaryDto
| Field | Type | Required | Meaning / constraints |
|---|
source_id | string | Yes | |
data_kinds | array of string | Yes | |
record_count | integer | Yes | |
latest_updated_at | string · date-time or null | No | |
source_retrieved_at | string · date-time or null | No | |
SourceDto
| Field | Type | Required | Meaning / constraints |
|---|
source_id | string | Yes | |
display_name | string | Yes | |
short_name | string | Yes | |
category | string | Yes | |
authority | string | Yes | |
access_method | string | Yes | |
homepage | string or null | No | |
icon_name | string | Yes | |
accent | string | Yes | |
data_kinds | array of string | Yes | |
is_official | boolean | Yes | |
refresh_interval_seconds | integer or null | No | |
status | string | Yes | |
freshness | string | Yes | |
latest_receipt_age_seconds | integer or null | No | |
seconds_until_refresh | integer or null | No | |
is_stale | boolean | Yes | |
is_refresh_due | boolean | Yes | |
has_active_failure | boolean | Yes | |
latest_receipt | SourceReceiptDto or null | No | |
latest_job | SourceJobDto or null | No | |
last_success_at | string · date-time or null | No | |
last_failure_at | string · date-time or null | No | |
consecutive_failures | integer | Yes | |
next_refresh_after | string · date-time or null | No | |
last_error_message | string or null | No | |
coverage | SourceCoverageDto | Yes | |
refresh_policy | RefreshPolicy | No | |
provider_status | ProviderStatus or null | No | |
SourceQuery
| Field | Type | Required | Meaning / constraints |
|---|
source | string or null | No | |
source_id | string or null | No | |
status | string or null | No | |
authority | string or null | No | |
access_method | string or null | No | |
freshness | string or null | No | |
SourceCoverageDto
| Field | Type | Required | Meaning / constraints |
|---|
canonical_model_count | integer | Yes | |
alias_count | integer | Yes | |
source_record_count | integer | Yes | |
linked_source_record_count | integer | Yes | |
capability_count | integer | Yes | |
price_point_count | integer | Yes | |
benchmark_score_count | integer | Yes | |
runtime_metric_count | integer | Yes | |
system_performance_result_count | integer | Yes | |
safety_finding_count | integer | Yes | |
receipt_count | integer | Yes | |
distribution_coverage | object | No | |
SourceJobDto
| Field | Type | Required | Meaning / constraints |
|---|
refresh_job_id | string · uuid | Yes | |
source_id | string | Yes | |
status | string | Yes | |
requested_by | string | Yes | |
force | boolean | Yes | |
started_at | string · date-time | Yes | |
finished_at | string · date-time or null | No | |
record_count | integer or null | No | |
error_message | string or null | No | |
RefreshJobsQuery
| Field | Type | Required | Meaning / constraints |
|---|
source | string or null | No | |
source_id | string or null | No | |
limit | integer or null | No | |
offset | integer or null | No | |
RefreshJobsResponse
| Field | Type | Required | Meaning / constraints |
|---|
data | array of SourceJobDto | Yes | |
total_count | integer | Yes | |
| Field | Type | Required | Meaning / constraints |
|---|
model | string or null | No | |
scenario | string or null | No | |
suite | string or null | No | |
unit | string or null | No | |
limit | integer or null | No | |
offset | integer or null | No | |
| Field | Type | Required | Meaning / constraints |
|---|
source_id | string | Yes | |
source_record_id | string | Yes | |
canonical_model_id | string or null | No | |
benchmark_version | string or null | No | |
suite | string or null | No | |
category | string or null | No | |
submitter | string or null | No | |
availability | string or null | No | |
system_name | string or null | No | |
platform | string or null | No | |
model_name | string | Yes | |
used_model | string or null | No | |
scenario | string or null | No | |
accuracy | string or null | No | |
nodes | integer or null | No | |
processor | string or null | No | |
accelerator | string or null | No | |
total_accelerators | integer or null | No | |
software | string or null | No | |
operating_system | string or null | No | |
weight_data_types | string or null | No | |
performance_result | number or null | No | |
performance_units | string or null | No | |
details_url | string or null | No | |
code_url | string or null | No | |
updated_at | string · date-time | Yes | |
SafetyFindingsQuery
| Field | Type | Required | Meaning / constraints |
|---|
source | string or null | No | |
model | string or null | No | |
benchmark | string or null | No | |
hazard | string or null | No | |
severity | string or null | No | |
limit | integer or null | No | |
offset | integer or null | No | |
SafetyFindingsResponse
| Field | Type | Required | Meaning / constraints |
|---|
data | array of SafetyFindingDto | Yes | |
total_count | integer | Yes | |
SafetyFindingDto
| Field | Type | Required | Meaning / constraints |
|---|
source_id | string | Yes | |
source_record_id | string | Yes | |
canonical_model_id | string or null | No | |
benchmark_id | string | Yes | |
benchmark_name | string | Yes | |
taxonomy | string or null | No | |
hazard_category | string | Yes | |
hazard_name | string or null | No | |
policy_area | string or null | No | |
assessment_type | string or null | No | |
prompt_type | string or null | No | |
metric | string | Yes | |
score | number or null | No | |
unit | string | Yes | |
grade | string or null | No | |
severity | string or null | No | |
result_label | string or null | No | |
confidence_lower | number or null | No | |
confidence_upper | number or null | No | |
sample_size | integer or null | No | |
evaluated_at | string · date-time or null | No | |
source_url | string or null | No | |
updated_at | string · date-time | Yes | |
OverviewResponse
| Field | Type | Required | Meaning / constraints |
|---|
total_models | integer | Yes | |
free_models | integer | Yes | |
paid_models | integer | Yes | |
multimodal_models | integer | Yes | |
reasoning_models | integer | Yes | |
tool_calling_models | integer | Yes | |
best_context_window | integer or null | No | |
average_capability_score | number or null | No | |
latest_refresh_at | string · date-time or null | No | |
model_count | integer | Yes | Minimum: 0 |
family_count | integer | Yes | Minimum: 0 |
distribution_count | integer | Yes | Minimum: 0 |
FacetsResponse
ModelFacetsDto
| Field | Type | Required | Meaning / constraints |
|---|
providers | array of FacetOptionDto | Yes | |
price_filters | array of FacetOptionDto | Yes | |
capabilities | array of FacetOptionDto | Yes | |
input_modalities | array of FacetOptionDto | Yes | |
output_modalities | array of FacetOptionDto | Yes | |
sorts | array of FacetOptionDto | Yes | |
developers | array of FacetOptionDto | Yes | Canonical model developers in strongest-model order: Intelligence Index, capability score, Arena rating, then name. Counts include all publisher aliases; use values with the developer query parameter. |
inference_providers | array of FacetOptionDto | Yes | Inference sources with indexed models, ordered by model count then name. Includes editor availability such as GitHub Copilot and Cursor when linked. Use values with inference_provider; availability does not establish token prices. |
model_types | array of FacetOptionDto | No | Model classifications counted from published models, including primary and secondary types. Counts match the model_type filter before pagination. Ordered by count descending, then value; unknown remains available to API consumers. Optional on older prepared facet documents. |
LeaderboardFacetsDto
PriceFacetsDto
SourceFacetsDto
FacetOptionDto
| Field | Type | Required | Meaning / constraints |
|---|
value | string | Yes | |
label | string | Yes | |
count | integer or null | No | |
icon_name | string or null | No | |
group | string or null | No | |
LeaderboardsResponse
| Field | Type | Required | Meaning / constraints |
|---|
data | array of LeaderboardDto | Yes | |
total_count | integer | Yes | |
LeaderboardDto
| Field | Type | Required | Meaning / constraints |
|---|
benchmark_id | string | Yes | |
leaderboard_id | string | Yes | |
benchmark_name | string | Yes | |
leaderboard_name | string or null | No | |
dimension | string | Yes | |
entries | array of LeaderboardEntryDto | Yes | |
source_id | string | Yes | |
metric | string | Yes | |
unit | string | Yes | |
LeaderboardEntryDto
| Field | Type | Required | Meaning / constraints |
|---|
source_id | string | Yes | |
canonical_model_id | string,null | Yes | Indexed TensorTrace model destination; null if no prepared model page exists. |
display_name | string | Yes | |
provider | string | Yes | |
score | number or null | No | |
unit | string | Yes | |
rank | integer or null | No | |
source_retrieved_at | string · date-time or null | No | |
source_record_id | string,null | No | |
source_model_id | string,null | No | |
aggregation_scope | object,null | No | Source aggregation coverage, including task count, revision count and sample, dataset splits and subset coverage. An aggregate spanning revisions is not a single-checkpoint measurement. |
receipt_id | string,null · uuid | No | Exact source receipt for this observation; null denotes unknown attribution. |
model_url | string,null · uri | No | Model URL preserved from the original result or official publisher metadata. Use only when canonical_model_id is null; no URL means plain text. |
source_url | string,null | No | Official result or export URL for this observation; falls back to the registered source website. |
RefreshRequest
| Field | Type | Required | Meaning / constraints |
|---|
source | string or null | No | |
force | boolean or null | No | |
RefreshResult
| Field | Type | Required | Meaning / constraints |
|---|
source_id | string | Yes | |
status | string | Yes | |
record_count | integer | Yes | |
receipt_id | string · uuid or null | No | |
job_id | string · uuid | Yes | |
ErrorResponse
| Field | Type | Required | Meaning / constraints |
|---|
error | string | Yes | |
CatalogModel
| Field | Type | Required | Meaning / constraints |
|---|
id | string | Yes | Primary source identifier retained for v1 compatibility. |
canonical_model_id | string | Yes | Stable, source-scoped model identity. Treat as opaque; encode path components. |
provider | string | Yes | |
name | string | Yes | |
description | string,null | No | |
created | integer,null | No | |
context_length | integer,null | No | |
hugging_face_id | string,null | No | |
canonical_slug | string,null | No | |
architecture | object | No | |
pricing | object,null | No | |
branding | Branding | No | |
source_badges | array of string | No | |
source_summaries | array of ModelSourceSummaryDto | No | |
top_benchmark_scores | array of BenchmarkScoreDto | No | One selected finite representative per linked benchmark source, prioritizing its main or overall evaluation. Units, scope and source evidence are preserved; values from different metrics are not directly comparable. Use the model scores endpoint for the complete evaluation set. |
is_free | boolean | No | |
is_paid | boolean | No | |
minimum_price_points | array of PricePointDto | No | Selected global quote minima per currency/unit, retaining both preferred base and conditional minima with full conditions and attribution. Input/output minima may come from different platforms. Use provider_prices for a provider-scoped comparison. This discovery selection is not the complete price evidence. |
platform_profiles | array of PlatformProfile | No | Source-specific task, hosting, schema and limits. Full schemas are included in model detail; catalog summaries omit schemas. |
cutoff_summary | CutoffSummary | No | |
specification_observations | array of SpecificationObservation | No | Positive numeric limits and original cutoff date labels, attributed to each source model/deployment. No synthetic cross-platform token limit. |
embedding_dimensions | integer,null | No | Reported default vector dimensions. Task-specific request dimensions may vary; this is not an output-token limit. Minimum: 1 |
external_resources | array of ExternalResource | No | Current source-derived human-facing references, ordered by model scope and resource kind. Empty when evidence supplies no usable public reference. |
collection_memberships | array of CollectionMembership | No | |
developer_id | string,null | No | Canonical model author directory ID; null when author attribution is unknown or only a hosting fallback. |
provider_prices | array of PricePointDto | No | Only present for an inference_provider query. Quotes from that source, preserving route, unit and conditions. Discovery/summary selects media minima and one coherent USD token offering using Input then Output; its rates also determine provider-scoped price ordering. view=offerings returns all published quotes for the provider. |
price_scope | string | No | |
provider_price_count | integer | No | Total complete quotes for the requested inference provider; discovery returns selected media minima and one coherent basic token offering. Fetch /prices for paged quotes. Minimum: 0 |
card_price_points | array of PricePointDto | No | One coherent USD token offering for cards: input, output, cached input and cache-write quotes share source, platform, native model ID and exact billing conditions. Preferred base rates precede conditional alternatives; compare Input then Output, missing rates last, and prefer the model developer on equal basic prices (native source before gateway-attributed developer platform). Cache rates never affect selection. Prepared by the worker; independent global minima and full evidence remain separate. Max. items: 5 |
official_model_id | string,null | No | Publisher-independent official model identifier: the final slash-delimited segment of an established first-party API ID, publisher-matched upstream response ID or exact publisher-owned Hub checkpoint ID. For Ollama family entries, this is the catalog's exact family name, verified against its source record and linked family. Prepared once by the serial pipeline; casing, version and checkpoint suffixes are preserved. Full observed IDs remain in official_identity.value and source profiles. Response evidence must match the model family and any explicit checkpoint date; conflicting IDs remain unknown. Null when not established; neither the gateway route nor TensorTrace canonical ID is a fallback. This string is not globally unique and must not be used as a URL or cross-developer merge key. |
official_identity | object,null | No | Provenance for official_model_id. value retains the exact complete observed API/repository identifier or Ollama catalog family name, including publisher or transport namespaces; it is not shortened with official_model_id. Also retains API/repository/family kind, evidence_type (native_catalog or provider_response), original field path, source ID, source model ID, source record ID, source URL, receipt and acquisition time when available, or repository origins. |
developer_name | string,null | No | Display name of the canonical model developer, shared with developer directories; null when author attribution is unknown. |
task | string,null | No | Prepared model task. A first-party fallback is explicitly attributed in tensortrace_knowledge; source observations remain unchanged. |
pipeline_tag | string,null | No | Source-reported task tag. Explicit source classification takes priority over first-party fallback rules. |
tensortrace_knowledge | TensorTraceKnowledge | No | Applied first-party supplements, separate from source observations. Absent when no reviewed rule was needed. |
distribution_count | integer | No | Active deployment variants for a model family. Minimum: 0 |
distribution_summary | FamilyDistributionSummary | No | |
Branding
| Field | Type | Required | Meaning / constraints |
|---|
company | BrandAsset or null | No | |
model | BrandAsset or null | No | |
fallback | string | No | |
attribution_url | string | No | |
BrandAsset
| Field | Type | Required | Meaning / constraints |
|---|
name | string | Yes | |
logo_url | string | Yes | Asset path relative to the API host. |
FieldAssertion
| Field | Type | Required | Meaning / constraints |
|---|
field | string | Yes | |
value | any JSON | Yes | |
source_id | string | Yes | |
source_record_id | string | Yes | |
receipt_id | string,null · uuid | No | |
confidence | number | Yes | |
retrieved_at | string,null · date-time | No | |
source_url | string,null | No | |
parser_version | string,null | No | |
IdentityConflict
| Field | Type | Required | Meaning / constraints |
|---|
source_id | string | No | |
source_model_id | string | No | |
existing_canonical_model_id | string | No | |
proposed_canonical_model_id | string | No | |
detected_at | string | No | |
last_seen_at | string | No | |
ObservationHistory
| Field | Type | Required | Meaning / constraints |
|---|
data | array of object | Yes | |
total_count | integer | Yes | |
limit | integer | Yes | |
offset | integer | Yes | |
NativeProviderModelIdentity
Added to each native provider object. Null canonical_model_id means no confirmed identity; clients must not infer one from names.
| Field | Type | Required | Meaning / constraints |
|---|
canonical_model_id | string,null | No | |
source_model_id | string | No | |
NativeProviderModelsResponse
Provider-compatible cached catalog. DeepInfra uses a top-level array; other providers retain their native object wrappers. Each cached model object includes confirmed TensorTrace identity metadata.
Type: object or array of NativeProviderModelIdentity. Provider-compatible cached catalog. DeepInfra uses a top-level array; other providers retain their native object wrappers. Each cached model object includes confirmed TensorTrace identity metadata.
Distribution
| Field | Type | Required | Meaning / constraints |
|---|
source_id | string | Yes | |
source_model_id | string | Yes | |
family_model_id | string,null | Yes | |
canonical_model_id | string,null | Yes | |
execution_mode | string | Yes | Values: local, cloud |
receipt_id | string · uuid | Yes | |
discovery_receipt_id | string · uuid | Yes | |
identity_relation | string | Yes | Values: deployment_of, unresolved |
parameter_count | integer,null | No | Minimum: 1 |
artifact_size_bytes | integer,null | No | Minimum: 1 |
context_window | integer,null | No | Minimum: 1 |
context_window_is_approximate | boolean | No | |
quantization_level | string,null | No | |
format | string,null | No | |
capabilities | array of string | No | |
input_modalities | array of string | No | |
supporting_receipt_ids | array of string · uuid | No | |
DistributionResponse
| Field | Type | Required | Meaning / constraints |
|---|
data | array of Distribution | Yes | |
total_count | integer | Yes | Minimum: 0 |
Source-backed deployment profile. Absent limits and capabilities remain unknown.
| Field | Type | Required | Meaning / constraints |
|---|
source_model_id | string | Yes | |
publisher | string | Yes | |
name | string | No | |
description | string,null | No | |
pipeline_tag | string | No | |
task | string | No | |
hosting | string | Yes | Deployment hosting kind, including cloudflare-hosted, siliconflow-hosted, kling-hosted and third-party. Future source hosting kinds may be added. |
context_length | integer,null | No | Minimum: 1 |
max_output_tokens | integer,null | No | Minimum: 1 |
max_questions | integer,null | No | Minimum: 1 |
architecture | object | Yes | |
supported_parameters | array of string | No | |
question_types | array of string | No | |
schema | object,null | No | |
properties | array,null | No | |
metadata | object,null | No | Source-scoped original details. BFL includes parameter_constraints, api_operation, checkpoint (official Hub metadata), published_pricing, family and checksummed observations. List prices exclude promotions. CMS/Hub timestamps are not release dates or knowledge cutoffs. |
tags | array,null | No | |
provider_details | array,null | No | |
zdr | boolean,null | No | |
source_url | string,null | No | |
source_retrieved_at | string,null · date-time | No | |
checksum_sha256 | string,null | No | |
created_at | string,null | No | |
source_id | string | Yes | |
platforms | array of string | Yes | |
capabilities | array of string | No | |
generation | GenerationProfile | No | |
embedding_dimensions | integer,null | No | Reported default vector dimensions. Task-specific request dimensions may vary; this is not an output-token limit. Minimum: 1 |
deployments | array of NvidiaDeployment | No | Tag-scoped NVIDIA container deployment evidence. Omitted in compact catalog reads; never promoted to canonical hardware requirements. |
deployment_count | integer | No | Minimum: 0 |
family_url | string | No | Related official model family page; does not establish checkpoint equivalence. |
api_path | string | No | Published BFL operation path. Missing for checkpoint-only and price-only records. |
availability | CursorAvailability | No | |
GenerationProfile
Source-reported generation capabilities; restrictions apply to the named interface group. Model-independent services are excluded.
| Field | Type | Required | Meaning / constraints |
|---|
kind | string | Yes | Values: image, video |
resolutions | array of string | Yes | |
duration_label | string,null | No | |
aspect_ratios | array of string | No | |
features | array of object | Yes | |
CutoffDateSummary
| Field | Type | Required | Meaning / constraints |
|---|
status | string | Yes | Values: unknown, reported, conflict, unresolved |
value | string,null | Yes | |
precision | string,null | Yes | Values: year, month, day, null |
observation_count | integer | Yes | Minimum: 0 |
CutoffSummary
Knowledge cutoff includes reported training-data dates. Compatible date precision yields consensus; contradictions remain conflicts. Original date labels and field names remain attributed in specification observations.
SpecificationObservation
| Field | Type | Required | Meaning / constraints |
|---|
field | string | Yes | Values: knowledge_cutoff, context_length, max_input_tokens, max_output_tokens, embedding_dimensions |
value | any JSON | Yes | |
normalized_value | string,integer,null | Yes | |
precision | string,null | Yes | Values: year, month, day, null |
scope | any JSON | Yes | |
source_id | string | Yes | |
source_record_id | string | Yes | |
receipt_id | string,null · uuid | Yes | |
confidence | number | No | |
retrieved_at | string,null · date-time | No | |
parser_version | string,null | No | |
source_url | string,null | No | |
reported_field | string | No | Original source date field before normalization to knowledge_cutoff, such as training_data_cutoff. Raw source payloads remain unchanged. |
ExternalResourceOrigin
| Field | Type | Required | Meaning / constraints |
|---|
source_id | string | Yes | |
source_name | string | Yes | |
source_record_id | string | Yes | |
receipt_id | string,null · uuid | Yes | |
field | string | Yes | Observed field or source-owned identifier used to construct this reference. |
scope | string | Yes | Values: model, related, catalog |
repository_match | RepositoryMatchEvidence | No | |
ExternalResource
Deduplicated, attributed public reference. Links do not assert equivalent checkpoints, successful HTTP reachability or a live inference offer.
| Field | Type | Required | Meaning / constraints |
|---|
url | string · uri | Yes | Pattern: ^https:// |
title | string | Yes | Destination website and reference purpose. Attribution remains in origins. |
host | string | Yes | |
kind | string | Yes | Values: official, repository, platform, documentation, paper, code, license, evaluation, catalog |
scope | string | Yes | Values: model, related, catalog |
origins | array of ExternalResourceOrigin | Yes | Min. items: 1 |
destination | ExternalResourceDestination | Yes | |
MetricPercentiles
| Field | Type | Required | Meaning / constraints |
|---|
p50 | number,null | Yes | Minimum: 0 |
p75 | number,null | Yes | Minimum: 0 |
p90 | number,null | Yes | Minimum: 0 |
p99 | number,null | Yes | Minimum: 0 |
WorkloadMetrics
| Field | Type | Required | Meaning / constraints |
|---|
latency_seconds | MetricPercentiles | Yes | |
latency_kind | string | Yes | Values: end_to_end, time_to_first_token, time_to_first_token_or_result |
throughput_tokens_per_second | MetricPercentiles or null | Yes | |
request_count | integer,null | Yes | Minimum: 0 |
EndpointMetric
One provider route in the captured OpenRouter snapshot. Legacy latency is TTFT in seconds after conversion from source milliseconds. Uptime is successful/(successful+error) requests times 100, excluding rate-limited requests; it is not time-based availability. Null is unreported, never zero.
| Field | Type | Required | Meaning / constraints |
|---|
provider_name | string,null | Yes | |
route | string,null | Yes | |
endpoint_name | string,null | Yes | |
status | integer,null | Yes | |
latency_seconds | MetricPercentiles | Yes | |
latency_kind | any JSON | Yes | |
throughput_tokens_per_second | MetricPercentiles | Yes | |
uptime_percent | object | Yes | |
workloads | object,null | Yes | |
ModelMetricsResponse
Exact source snapshot metadata. An unlisted model has no OpenRouter routing alias; listed is catalog coverage, not an inference health assertion. First-fetch failure returns 503.
| Field | Type | Required | Meaning / constraints |
|---|
canonical_model_id | string | Yes | |
source_id | any JSON | Yes | |
source_model_id | string,null | Yes | |
source_url | string,null | Yes | |
retrieved_at | string,null · date-time | Yes | |
stale | boolean | Yes | |
coverage | any JSON | Yes | Values: listed, not_listed |
window | any JSON | Yes | |
providers | array of EndpointMetric | Yes | |
ListedQuoteObservation
| Field | Type | Required | Meaning / constraints |
|---|
source_model_id | string | Yes | |
receipt_id | string · uuid | Yes | |
source_url | string | Yes | |
observed_at | string · date-time | Yes | |
unit | any JSON | Yes | Values: input_tokens_per_million, output_tokens_per_million |
amount_usd | number | Yes | Minimum: 0 |
currency | any JSON | Yes | |
raw_field | string | Yes | |
original_amount | any JSON | Yes | |
source_pricing | object | Yes | |
ModelPriceHistoryResponse
Immutable catalog quote observations, including evidenced canonical redirect lineage. Pagination counts raw observations; an observation can yield zero, one or two reviewed token quotes. Times are source retrieval times, not effective price-change times or actual customer payments. Pages select newest observations first; each page returns points chronologically.
| Field | Type | Required | Meaning / constraints |
|---|
canonical_model_id | string | Yes | |
source_id | any JSON | Yes | |
quote_kind | any JSON | Yes | |
data | array of ListedQuoteObservation | Yes | |
total_observations | integer | Yes | Minimum: 0 |
returned_observations | integer | Yes | Minimum: 0 |
limit | integer | Yes | Minimum: 1; Maximum: 1000 |
offset | integer | Yes | Minimum: 0 |
has_more | boolean | Yes | |
CopilotModelsResponse
| Field | Type | Required | Meaning / constraints |
|---|
source_id | any JSON | Yes | |
models | array of object | Yes | |
count | integer | Yes | Minimum: 0 |
total | integer | Yes | Minimum: 0 |
limit | integer | Yes | Minimum: 1; Maximum: 1000 |
offset | integer | Yes | Minimum: 0 |
RepositoryMatchEvidence
Optional evidence for an exact publisher and repository-name link to an indexed Hugging Face observation. The outer origin identifies the current model record; this evidence identifies the independent repository record and its receipt. No identities or model facts are merged.
| Field | Type | Required | Meaning / constraints |
|---|
rule | string | Yes | Values: same-publisher-exact-model-name |
source_id | string | Yes | Values: huggingFace |
source_record_id | string | Yes | |
canonical_model_id | string | Yes | |
receipt_id | string · uuid | Yes | |
field | string | Yes | Values: source_record_id |
CollectionMembership
Current curated selection, not a rank or capability; removed with the next successful complete snapshot.
| Field | Type | Required | Meaning / constraints |
|---|
source_id | string | Yes | |
source_name | string | Yes | |
source_record_id | string | Yes | |
receipt_id | string · uuid | Yes | |
collection_id | string | Yes | |
collection_title | string | Yes | |
collection_url | string · uri | Yes | |
repository_id | string | Yes | |
repository_url | string · uri | Yes | |
kind | any JSON | Yes | |
label | string | Yes | |
position | integer | Yes | Order within collection, not benchmark rank. Minimum: 0 |
source_updated_at | string · date-time | Yes | |
observed_at | string · date-time | Yes | |
note | string,null | No | Attributed original source note; may describe an older evaluation. |
RefreshPolicy
| Field | Type | Required | Meaning / constraints |
|---|
mode | string | Yes | Values: scheduled, disabled, needsConfiguration, derived, unavailable, paused |
adapter_supported | boolean | Yes | |
configured | boolean | Yes | |
scheduler_enabled | boolean | Yes | |
scheduler_interval_seconds | integer | Yes | Minimum: 1 |
parent_source_id | string,null | Yes | |
InsightEntry
| Field | Type | Required | Meaning / constraints |
|---|
source_record_id | string | Yes | |
canonical_model_id | string,null | Yes | |
label | string | Yes | |
organization | string,null | Yes | |
score | number | Yes | |
rank | integer,null | Yes | |
confidence_lower | number,null | Yes | |
confidence_upper | number,null | Yes | |
sample_size | integer,null | Yes | |
sample_unit | string,null | Yes | |
cost_usd | number,null | Yes | BFCL estimated cost of the entire benchmark in USD; not per-token or per-task price. |
latency_seconds | number,null | Yes | BFCL mean call latency, seconds. |
profile | string,null | Yes | |
submitted_at | string,null · date | Yes | |
checked | boolean,null | Yes | |
warning | string,null | Yes | |
model_url | string,null · uri | No | Model URL preserved from the original result or official publisher metadata. Use only when canonical_model_id is null; no URL means plain text. |
InsightBoard
| Field | Type | Required | Meaning / constraints |
|---|
id | string | Yes | |
title | string | Yes | |
source_id | string | Yes | |
source_url | string · uri | Yes | |
metric | string | Yes | |
unit | string | Yes | Values: rating, percent |
methodology | string | Yes | |
published_at | string,null · date | Yes | |
retrieved_at | string,null · date-time | Yes | |
receipt_id | string,null · uuid | Yes | |
source_record_count | integer | Yes | Minimum: 0 |
scored_entry_count | integer | Yes | Minimum: 0 |
linked_entry_count | integer | Yes | Minimum: 0 |
entries | array of InsightEntry | Yes | Max. items: 500 |
InsightsResponse
| Field | Type | Required | Meaning / constraints |
|---|
boards | array of InsightBoard | Yes | Max. items: 13 |
NvidiaDeployment
| Field | Type | Required | Meaning / constraints |
|---|
resource_id | string | Yes | |
tag | string | No | |
source_url | string · uri | Yes | |
retrieved_at | string · date-time | Yes | |
checksum_sha256 | string | Yes | |
metadata_status | string | Yes | Values: available, restricted, not_found, not_reported, outside_nim_namespace |
container | object | No | |
metadata_source_url | string · uri | No | |
metadata_checksum_sha256 | string | No | |
metadata_retrieved_at | string · date-time | No | |
metadata | object | No | Complete reported NIM Metadata JSON for this resource/tag, including unknown future fields. Missing values differ from false/zero. Hardware memory is per device; non-standard throughput is not a comparable benchmark. |
ProviderStatus
Live serving-platform status, independent of catalog ingestion and individual model endpoint health. Unverified/failing/stale feeds have state unknown. Last reported state is retained separately. All times are UTC. Raw evidence and checks are retained seven days plus the last successful evidence.
| Field | Type | Required | Meaning / constraints |
|---|
source_id | string | Yes | |
display_name | string | Yes | |
scope | string | Yes | |
page_url | string,null · uri | No | |
format | string,null | No | |
feed_urls | array of string · uri | Yes | |
component_ids | array of string | No | |
group_ids | array of string | No | |
note | string,null | No | |
state | string | Yes | Values: operational, degraded, partial_outage, major_outage, maintenance, incident_reported, no_reported_incidents, unknown |
freshness | string | Yes | Values: fresh, stale, fetch_failed, not_checked, unverified |
reported_state | string,null | No | |
checked_at | string,null · date-time | No | |
last_success_at | string,null · date-time | No | |
expires_at | string,null · date-time | No | |
consecutive_failures | integer | No | |
error_message | string,null | No | |
snapshot | object,null | No | |
evidence | array of object | No | |
poll_interval_seconds | integer | Yes | |
scheduler_enabled | boolean | Yes | |
history_retention_days | integer | Yes | |
Organization
| Field | Type | Required | Meaning / constraints |
|---|
id | string | Yes | |
name | string | Yes | |
role | string | Yes | Values: developer, inference_provider |
model_count | integer | Yes | Minimum: 0 |
description | string | Yes | Collected short introduction; empty when no usable official description has been collected. |
catalog_scope | string | Yes | |
aliases | array of string | No | |
logo_url | string | No | |
homepage | string,null | No | |
source_status | string | No | |
observed_at | string,null · date-time | No | |
offering_count | integer | No | |
priced_model_count | integer | No | |
best_model | object,null | No | |
governance | array of OrganizationGovernanceFinding | No | Developer company disclosure assessments, prepared independently of model matches. Empty when no assessment is recorded; omitted for inference providers. |
leading_models | array of ProviderLeadingModel | No | Up to three leaders from the developer's models or inference provider's catalog, ordered by intelligence, capability, benchmark rating, name and canonical ID. Publisher aliases are combined for developers and each canonical model appears once. Empty when no models are available; omitted by older prepared directories. Developer best_model is retained as the first entry for compatibility. Max. items: 3 |
profile | OrganizationProfile or null | No | Worker-collected company or inference-service profile. Null when unavailable; collection never runs in API requests. |
OrganizationDirectory
| Field | Type | Required | Meaning / constraints |
|---|
data | array of Organization | Yes | |
total_count | integer | Yes | |
offset | integer | Yes | |
limit | integer | Yes | |
PublicUser
| Field | Type | Required | Meaning / constraints |
|---|
id | string · uuid | Yes | |
username | string | Yes | Max. length: 15 |
display_name | string | Yes | Max. length: 100 |
avatar_url | string | Yes | |
avatar_fallback | string | Yes | |
created_at | string · date-time | Yes | |
Account
| Field | Type | Required | Meaning / constraints |
|---|
id | string · uuid | Yes | |
username | string | Yes | Max. length: 15 |
display_name | string | Yes | Max. length: 100 |
avatar_url | string | Yes | |
avatar_fallback | string | Yes | |
created_at | string · date-time | Yes | |
email | string,null | Yes | |
first_name | string | No | |
last_name | string | No | |
username_confirmed | boolean | Yes | |
identities | array of string | Yes | |
AccountSession
| Field | Type | Required | Meaning / constraints |
|---|
user | Account or null | Yes | |
csrf_token | string | Yes | |
ProfileUpdate
| Field | Type | Required | Meaning / constraints |
|---|
username | string | Yes | Globally unique username: 1–15 ASCII letters, digits, underscores or hyphens. Case-insensitive collisions and reserved names are rejected. Updating also confirms a generated candidate. Pattern: ^[A-Za-z0-9_][A-Za-z0-9_-]{0,14}$ |
display_name | string | No | Optional public display name; does not need to be globally unique. Max. length: 100 |
first_name | string | No | Optional first name from the account profile. Max. length: 100 |
last_name | string | No | Optional last name from the account profile. Max. length: 100 |
| Field | Type | Required | Meaning / constraints |
|---|
text | string | Yes | |
kind | string | Yes | Values: user, topic, stock, model |
href | string | Yes | |
user_id | string · uuid | No | |
model_id | string | No | |
| Field | Type | Required | Meaning / constraints |
|---|
id | string · uuid | Yes | |
author | PublicUser | Yes | |
model_id | string | Yes | |
model_name | string | No | |
body | string | Yes | Min. length: 1; Max. length: 1024 |
references | array of CommentReference | Yes | |
created_at | string · date-time | Yes | |
| Field | Type | Required | Meaning / constraints |
|---|
data | array of CommunityComment | Yes | |
next_cursor | string,null | Yes | |
CursorModelsResponse
Cursor recommended agent models for the configured account/team only. Includes unmatched observations and routing IDs, with null canonical_model_id. Platform aliases/parameters/variants do not establish model identity, universal access or token prices. Empty before the first authenticated refresh. Updated every six hours when CURSOR_API_KEY is configured.
| Field | Type | Required | Meaning / constraints |
|---|
source_id | any JSON | Yes | |
models | array of object | Yes | |
count | integer | Yes | Minimum: 0 |
total | integer | Yes | Minimum: 0 |
limit | integer | Yes | Minimum: 1; Maximum: 1000 |
offset | integer | Yes | Minimum: 0 |
CursorAvailability
| Field | Type | Required | Meaning / constraints |
|---|
status | any JSON | Yes | |
scope | any JSON | Yes | |
surface | any JSON | Yes | |
coverage | any JSON | Yes | |
observed_at | string · date-time | Yes | |
CursorParameterValue
| Field | Type | Required | Meaning / constraints |
|---|
value | string | Yes | |
displayName | string,null | No | |
CursorParameter
| Field | Type | Required | Meaning / constraints |
|---|
id | string | Yes | |
displayName | string,null | No | |
values | array of CursorParameterValue | Yes | |
CursorVariant
| Field | Type | Required | Meaning / constraints |
|---|
displayName | string | Yes | |
description | string,null | No | |
isDefault | boolean,null | No | |
params | array of object | Yes | |
ModelPage
| Field | Type | Required | Meaning / constraints |
|---|
data | array of CatalogModel | Yes | Max. items: 100 |
total_count | integer | Yes | Minimum: 0 |
limit | integer | Yes | Minimum: 1; Maximum: 100 |
offset | integer | Yes | Minimum: 0 |
DirectoryPage
| Field | Type | Required | Meaning / constraints |
|---|
data | array of Organization | Yes | Max. items: 100 |
total_count | integer | Yes | Minimum: 0 |
limit | integer | Yes | Minimum: 1; Maximum: 100 |
offset | integer | Yes | Minimum: 0 |
CatalogFacets
| Field | Type | Required | Meaning / constraints |
|---|
models | ModelFacetsDto | Yes | |
model_sources | array of object | Yes | |
CatalogOverview
| Field | Type | Required | Meaning / constraints |
|---|
total_models | integer | Yes | |
free_models | integer | Yes | |
paid_models | integer | Yes | |
multimodal_models | integer | Yes | |
reasoning_models | integer | Yes | |
tool_calling_models | integer | Yes | |
best_context_window | integer or null | No | |
average_capability_score | number or null | No | |
latest_refresh_at | string · date-time or null | No | |
model_count | integer | Yes | Minimum: 0 |
family_count | integer | Yes | Minimum: 0 |
distribution_count | integer | Yes | Minimum: 0 |
ModelPricePage
| Field | Type | Required | Meaning / constraints |
|---|
data | array of PricePointDto | Yes | Max. items: 100 |
platform_profiles | array of PlatformProfile | Yes | |
total_count | integer | Yes | Minimum: 0 |
limit | integer | Yes | Minimum: 1; Maximum: 100 |
offset | integer | Yes | Minimum: 0 |
ModelOverview
| Field | Type | Required | Meaning / constraints |
|---|
canonical_model_id | string | Yes | |
model | CatalogModel | Yes | |
capabilities | array of string | Yes | |
benchmark_score_counts | object | Yes | |
sections | object | Yes | |
references | array of ContentReference | No | Exactly anchored model/distribution metadata. Base-model or derived-from relationships do not establish identity. Max. items: 20 |
DetailSectionPage
| Field | Type | Required | Meaning / constraints |
|---|
data | array of object | Yes | Max. items: 100 |
total_count | integer | Yes | Minimum: 0 |
limit | integer | Yes | Minimum: 1; Maximum: 100 |
offset | integer | Yes | Minimum: 0 |
SourceLinkCorrection
Audited canonical association repair; the original receipt and observation history are unchanged.
| Field | Type | Required | Meaning / constraints |
|---|
source_id | string | Yes | |
source_record_id | string | Yes | |
previous_model_id | string | Yes | |
reason | string | Yes | |
receipt_id | string · uuid | Yes | |
canonical_model_id | string,null | Yes | |
evidence | object | Yes | |
corrected_at | string · date-time | Yes | |
ExternalResourceDestination
Derived from the reference URL at preparation time; never inferred from the observation source.
| Field | Type | Required | Meaning / constraints |
|---|
id | string,null | Yes | Recognized destination platform branding ID, independent of origin source IDs. Null for unrecognized hosts. Min. length: 1 |
name | string | Yes | Target website name, or its exact hostname when unrecognized. Min. length: 1 |
OrganizationGovernanceFinding
Company disclosure assessment from the original organization record. Not a score of any individual model.
| Field | Type | Required | Meaning / constraints |
|---|
source_id | string | Yes | |
source_record_id | string | Yes | |
receipt_id | string,null · uuid | No | |
source_url | string,null · uri | No | |
observed_at | string,null · date-time | No | |
scope | string | Yes | Values: organization |
score | number | Yes | |
unit | string | Yes | Values: score |
organization | string,null | No | |
benchmark_id | string,null | No | |
benchmark_name | string,null | No | |
assessment_type | string,null | No | |
hazard_name | string,null | No | |
metric | string,null | No | |
result_label | string,null | No | |
max_score | number,null | No | |
indicator_count | integer,null | No | Minimum: 0 |
disclosed_indicator_count | integer,null | No | Minimum: 0 |
partial_indicator_count | integer,null | No | Minimum: 0 |
OfflineManifest
| Field | Type | Required | Meaning / constraints |
|---|
schema | integer | Yes | |
generation | string | Yes | |
generated_at | string · date-time | Yes | |
model_count | integer | Yes | |
chunks | array of object | Yes | |
TensorTraceKnowledge
Versioned TensorTrace knowledge applied during serial preparation. Shared by discovery, detail and offline documents.
TensorTraceKnowledgeRule
Attribution for a reviewed first-party fallback. This is not an acquired source observation or proof of model equivalence.
| Field | Type | Required | Meaning / constraints |
|---|
rule_id | string | Yes | |
rule_revision | integer | Yes | Minimum: 1 |
reviewed_at | string · date | Yes | |
kind | string | Yes | Values: model_type_fallback |
field | string | Yes | Values: task |
value | string | Yes | Values: text-generation |
references | array of string · uri | Yes | Min. items: 1 |
FamilyDistributionSummary
Prepared counts of active family deployments, independent of paged artifact rows. Base models count distinct confirmed canonical links.
| Field | Type | Required | Meaning / constraints |
|---|
variants | integer | Yes | Minimum: 0 |
local | integer | Yes | Minimum: 0 |
cloud | integer | Yes | Minimum: 0 |
confirmed_base_models | integer | Yes | Minimum: 0 |
NewsPublisher
| Field | Type | Required | Meaning / constraints |
|---|
role | string | No | Optional curated feed publisher classification, not a verification of its claims. Values: official, media, author |
name | string | Yes | Selected article publisher. |
url | string | Yes | Publisher homepage, or empty if unsafe. |
icon_url | string,null · uri | No | Optional declared publisher icon from Mercury; unsafe URLs are removed. |
NewsContext
| Field | Type | Required | Meaning / constraints |
|---|
kind | string | Yes | Context chosen by the server. Values: topic, model |
model_id | string,null | Yes | Resolved canonical model, null for topic feed. |
developer | string,null | Yes | Indexed developer, null if unreported. |
model_terms | array of string | Yes | Derived model spellings. |
developer_terms | array of string | Yes | Derived developer terms with AI qualifiers where necessary. |
keywords | array of string | Yes | Effective query entries, normalized by the shared search engine. |
operator | string | Yes | Values: and, or |
language | string | Yes | Max. length: 63 |
NewsArticle
| Field | Type | Required | Meaning / constraints |
|---|
id | integer | Yes | Selected TensorTrace news-entry ID. |
title | string | Yes | Original article title. |
summary | string,null | Yes | Stored preview: up to 300 visible characters with ellipsis; balanced inline Markdown/links/TeX, up to 4 KiB encoded. Full body unchanged. |
url | string · uri | Yes | Selected original HTTP(S) article URL. |
source | NewsPublisher | Yes | |
published_at | string,null · date-time | Yes | Source publication time, null when missing. |
created_at | string · date-time | Yes | TensorTrace receipt time and ordering fallback. |
discussion_url | string,null · uri | Yes | Optional original discussion URL. |
relevance | string | Yes | Topic query, or explicit model/developer context in the title/summary. Related means TensorTrace matched elsewhere; labels never filter articles. Values: topic, model, developer, related |
image_urls | array of string · uri | No | Safe, deduplicated original article images in TensorTrace order, preview first. Empty when unavailable; clients may show the first image. Max. items: 20 |
references | array of PackageReference | No | Optional exact-version package evidence, separate from the article/release text. Max. items: 5 |
NewsFeed
| Field | Type | Required | Meaning / constraints |
|---|
data | array of NewsArticle | Yes | Matching first-party articles in publication order; body-only and shared-URL records are retained. Max. items: 100 |
context | NewsContext | Yes | |
fetched_at | string · date-time | Yes | Time this database query completed; not source acquisition or publication time. |
upstream_total | integer | Yes | Matching database entry count retained for installed-client compatibility. Minimum: 0 |
source | string | Yes | First-party service. Values: TensorTrace |
next_cursor | string,null | Yes | Opaque continuation for older results, or null when exhausted. |
pagination | NewsPagination | Yes | |
ProviderLeadingModel
| Field | Type | Required | Meaning / constraints |
|---|
canonical_model_id | string | Yes | |
name | string | Yes | |
provider | string | Yes | Original model publisher, distinct from the inference provider. |
branding | Branding or null | Yes | Prepared model-family and company branding from the Model Library. Null only when absent from an older prepared model. |
intelligence_index | number,null | Yes | |
capability_score | number,null | Yes | |
best_rating | number,null | Yes | |
developer_id | string,null | Yes | Normalized developer directory ID, or null when attribution is unknown. |
developer_name | string,null | Yes | Developer company, lab or author name, or null when attribution is unknown. |
| Field | Type | Required | Meaning / constraints |
|---|
language | string | Yes | |
keywords | array of string | Yes | |
operator | string | Yes | Values: and, or |
total | integer | Yes | Minimum: 0 |
unfiltered_total | integer | Yes | Minimum: 0 |
count | integer | Yes | Minimum: 0 |
limit | integer | Yes | Minimum: 1; Maximum: 100 |
has_older | boolean | Yes | |
has_newer | boolean | Yes | |
older_cursor | string,null | Yes | |
newer_cursor | string,null | Yes | |
older_url | string,null | Yes | |
newer_url | string,null | Yes | |
NewsDetail
| Field | Type | Required | Meaning / constraints |
|---|
id | integer | Yes | Selected TensorTrace news-entry ID. |
title | string | Yes | Original article title. |
summary | string,null | Yes | Stored description from accepted article/release text, at most 300 characters with a final ellipsis when shortened. |
url | string · uri | Yes | Selected original HTTP(S) article URL. |
source | NewsPublisher | Yes | |
published_at | string,null · date-time | Yes | Source publication time, null when missing. |
created_at | string · date-time | Yes | TensorTrace receipt time and ordering fallback. |
discussion_url | string,null · uri | No | Optional original discussion URL. |
image_urls | array of string · uri | No | Safe, deduplicated original article images in TensorTrace order, preview first. Empty when unavailable; clients may show the first image. Max. items: 20 |
content | string | Yes | Complete plain-text article; no raw extraction HTML. |
language | string | Yes | |
author | string,null | Yes | |
references | array of PackageReference | No | Optional exact-version package evidence, separate from the article/release text. Max. items: 5 |
Paper
| Field | Type | Required | Meaning / constraints |
|---|
arxiv_id | string,null | Yes | External arXiv identity; null for works indexed only from other sources. |
title | string | Yes | |
abstract | string | Yes | |
url | string | Yes | |
id | integer | Yes | Minimum: 1 |
pdf_url | string,null | Yes | |
doi | string,null | Yes | |
license_url | string,null | Yes | |
comments | string,null | Yes | |
journal_ref | string,null | Yes | |
authors | array of object | Yes | |
categories | array of string | Yes | |
published_on | ResearchCalendarDate | Yes | |
revised_on | ResearchCalendarDate | Yes | |
created_at | string · date-time | Yes | |
updated_at | string · date-time | Yes | |
source | object | Yes | |
image_urls | array of string · uri | Yes | Up to 5 safe source media URLs. arXiv HTML enrichment supplies its first figure; HF metadata can supply more. Empty means unavailable or not yet indexed. Max. items: 5 |
ecosystem_url | string | No | Optional same-origin discovery link, supplied only when an exact arXiv/DOI relationship is indexed. |
published_date | integer,null | Yes | Compatible YYYYMMDD calendar integer; DD=00 for month precision, MMDD=0000 for year precision, null when unknown. Never a Unix timestamp. |
published_precision | string | Yes | Values: day, month, year, unknown |
research_id | string · uuid | No | Stable source-neutral work UUID. The positive numeric id remains a compatible alias. |
research_url | string | No | Same-origin canonical work page. |
sources | array of ResearchSource | No | Explicit external identities for one work; no title similarity matching. |
versions | array of ResearchVersion | No | Source-specific preprint/publication versions retain their own dates. |
notices | array of object | No | Correction/retraction relationships, not aliases or replacement publication dates. |
reviews | array of ResearchReview | No | |
references | array of ContentReference | No | Up to 3 compact list references or 20 full detail references; reference_count reports the complete total. Max. items: 20 |
reference_count | integer | No | All current exact supporting relationships; may exceed the bounded preview. Minimum: 0 |
availability | string | No | Stored work availability. Withdrawn/retracted evidence remains attributable. |
| Field | Type | Required | Meaning / constraints |
|---|
count | integer | Yes | Minimum: 0 |
total | integer | Yes | Minimum: 0 |
unfiltered_total | integer | Yes | Minimum: 0 |
limit | integer | Yes | Minimum: 1; Maximum: 100 |
keywords | array of string | Yes | |
operator | string | Yes | Values: and, or |
category | string,null | Yes | |
before | string,null | Yes | |
after | string,null | Yes | |
next_cursor | string,null | Yes | |
previous_cursor | string,null | Yes | |
next | string,null | Yes | |
previous | string,null | Yes | |
PaperPage
| Field | Type | Required | Meaning / constraints |
|---|
data | array of Paper | Yes | Max. items: 100 |
pagination | PaperPagination | Yes | |
OrganizationProfile
| Field | Type | Required | Meaning / constraints |
|---|
summary | string | Yes | Plain-text excerpt, at most 260 characters plus an ellipsis. |
description | string | Yes | Plain text with blank lines between collected paragraphs. No AI rewriting or untrusted HTML. |
homepage | string · uri | Yes | |
source_url | string · uri | Yes | |
source_kind | string | Yes | Values: official_website, publisher_profile |
retrieved_at | string · date-time | Yes | |
receipt_id | string · uuid | Yes | |
parser_version | string | Yes | |
links | array of object | Yes | |
UnifiedSearchItem
| Field | Type | Required | Meaning / constraints |
|---|
id | string | Yes | Stable source or canonical ID within the category. |
title | string | Yes | Public title or display name, as plain text. |
url | string | Yes | TensorTrace model or organization path, or the original HTTP(S) news/paper source URL. |
description | string,null | Yes | Bounded plain-text description; escape before rendering. |
image_url | string,null | Yes | Optional public image URL. |
subtitle | string,null | Yes | Optional public publisher, author or category context. |
UnifiedSearchGroup
| Field | Type | Required | Meaning / constraints |
|---|
category | string | Yes | Kind of content in this group. Values: models, news, papers, developers, providers |
total | integer | Yes | Exact number of matches in this category. Minimum: 0 |
offset | integer | Yes | Ranked hits skipped in this category. Minimum: 0; Maximum: 10000 |
limit | integer | Yes | Requested maximum number of hits in this group. Minimum: 1; Maximum: 18 |
has_more | boolean | Yes | Whether further matching hits follow this page. |
items | array of UnifiedSearchItem | Yes | Ranked hits in this page, ordered by relevance then stable ID. |
UnifiedSearchResponse
| Field | Type | Required | Meaning / constraints |
|---|
query | string | Yes | Normalized query used for matching. |
total | integer | Yes | Sum of match counts for the returned groups. Minimum: 0 |
groups | array of UnifiedSearchGroup | Yes | Models, news, papers, developers and providers in that order, or one selected category. |
EcosystemLink
| Field | Type | Required | Meaning / constraints |
|---|
relation | string | Yes | |
namespace | string | Yes | |
external_id | string | Yes | |
url | string,null | No | |
model_id | string,null | No | |
EcosystemRecord
Source-native facts retain their units, cohorts, licensing and observation clocks. Missing facts are null/omitted, never invented. Card responses contain a bounded subset of facts; detail contains all normalized facts.
| Field | Type | Required | Meaning / constraints |
|---|
id | string · uuid | Yes | |
external_id | string | Yes | |
kind | string | Yes | Values: paper, review, release, software, dataset, dataset_schema, tool, advisory, artifact, evaluation, incident, statistic, change, entity |
title | string | Yes | |
summary | string,null | No | |
url | string · uri | Yes | |
published_at | string,null · date-time | No | |
date_precision | string,null | No | Values: date, timestamp, null |
availability | string | No | Values: active, deprecated, deleted, withdrawn, retracted, unknown |
license | string,null | No | |
facts | object | Yes | |
links | array of EcosystemLink | Yes | |
source | object | Yes | |
receipt_id | string · uuid | Yes | |
first_observed_at | string · date-time | No | |
last_observed_at | string · date-time | No | |
updated_at | string · date-time | No | |
EcosystemPage
| Field | Type | Required | Meaning / constraints |
|---|
data | array of EcosystemRecord | Yes | Max. items: 20 |
pagination | object | Yes | |
observed_at | string · date-time | Yes | |
EcosystemSources
| Field | Type | Required | Meaning / constraints |
|---|
data | array of object | No | |
EcosystemHistory
| Field | Type | Required | Meaning / constraints |
|---|
data | array of object | No | Max. items: 20 |
total_count | integer | No | |
limit | integer | No | |
offset | integer | No | |
evidence_scope | string | No | |
ResearchSource
| Field | Type | Required | Meaning / constraints |
|---|
source_id | string | Yes | |
name | string | Yes | |
url | string · uri | Yes | |
external_id | string | Yes | |
license | string,null | No | |
citations | integer,null | No | |
citation_scope | string,null | No | |
venue | string,null | No | |
availability | string | No | Current availability reported by this source; independent of availability of the whole work. |
published_on | ResearchCalendarDate | No | |
published_precision | string | No | Values: day, month, year, unknown |
ResearchVersion
| Field | Type | Required | Meaning / constraints |
|---|
id | string | Yes | |
kind | string | Yes | |
label | string | No | |
source_id | string | Yes | |
url | string · uri | Yes | |
published_on | ResearchCalendarDate | No | |
published_precision | string | No | Values: day, month, year, unknown |
revised_on | ResearchCalendarDate | No | |
ResearchReview
Original venue-specific review evidence; no averaged quality score.
| Field | Type | Required | Meaning / constraints |
|---|
source_id | string | Yes | |
url | string · uri | Yes | |
venue | string,null | Yes | |
decision | string,null | Yes | |
review_count | integer | Yes | Minimum: 0 |
ratings | array of object | Yes | |
scope | string | No | Reviews observed in the indexed public notes; not a guaranteed complete forum total. |
ContentReference
Exact supporting evidence; file facts describe only the inspected file/shard.
| Field | Type | Required | Meaning / constraints |
|---|
source_id | string | Yes | |
name | string | Yes | |
url | string · uri | Yes | |
external_id | string | No | |
source_homepage | string,null · uri | No | |
relation | string | Yes | |
kind | string | Yes | |
title | string | Yes | |
facts | object | Yes | Source-qualified metadata. Lists use compact facts; detail retains bounded audit/schema/file facts. |
license | string,null | No | |
receipt_id | string · uuid | No | |
observed_at | string · date-time | No | |
audit_url | string,null · uri | No | |
dataset_url | string,null · uri | No | Recognized Hugging Face dataset repository URL; null when the original pointer does not establish dataset identity. |
related_url | string,null · uri | No | Original safe related pointer from the source; may be a paper or project homepage rather than a dataset. |
PackageReference
Declared PyPI metadata, not resolved dependencies or compatibility/security assurance.
| Field | Type | Required | Meaning / constraints |
|---|
relation | string | Yes | |
kind | string | Yes | |
source_id | string | Yes | |
name | string | Yes | |
url | string · uri | Yes | |
version | string | Yes | |
requires_python | string,null | Yes | |
requires_dist | array of string | Yes | Max. items: 50 |
dependency_count | integer | Yes | Minimum: 0 |
license | string,null | Yes | |
receipt_id | string · uuid | Yes | |
observed_at | string · date-time | Yes | |
scope | string | Yes | |
ReportChartContext
| Field | Type | Required | Meaning / constraints |
|---|
report_year | integer | Yes | |
chapter | string,null | No | |
chart | object | Yes | |
columns | array of string | Yes | |
rows | array of array of string | Yes | Max. items: 100 |
source_file | string · uri | Yes | |
source_file_id | string | No | |
source_filename | string | No | |
report_url | string,null · uri | No | |
semantic_reference | string · uri | No | |
attribution | string,null | No | |
scope | string | Yes | |
IncidentContext
| Field | Type | Required | Meaning / constraints |
|---|
summary | string,null | No | |
license | string,null | No | |
incident | object | Yes | Original incident/classification fields, with unknown/estimated dates retained. |
roles | array of EcosystemLink | Yes | |
scope | string | Yes | |
denominator | null | Yes | |
causality_inferred | boolean | Yes | |
SafetyGradeContext
Original ordinal grade; absent numeric scores remain null.
| Field | Type | Required | Meaning / constraints |
|---|
grade | string,null | Yes | |
score | number,null | Yes | |
metric | string | Yes | |
unit | string | Yes | |
evidence | object | Yes | |
BenchmarkContext
A reviewed report chart, incident, or original safety grade; separate observation domains.
| Field | Type | Required | Meaning / constraints |
|---|
source_id | string | Yes | |
context_id | string | Yes | |
kind | string | Yes | Values: report_chart, incident, safety_grade |
title | string | Yes | |
source_url | string · uri | Yes | |
receipt_id | string · uuid | Yes | |
updated_at | string · date-time | Yes | |
context | ReportChartContext or IncidentContext or SafetyGradeContext | Yes | |
BenchmarkContextSummary
Stored coverage across sources, independent of page filters; not prevalence or company risk rates.
| Field | Type | Required | Meaning / constraints |
|---|
sources | array of object | Yes | |
evaluations | array of object | Yes | |
incident_years | array of object | Yes | |
incident_risks | array of object | Yes | |
incident_date_coverage | object | Yes | |
denominator | null | Yes | |
company_risk_ranking | boolean | Yes | |
ResearchCalendarDate
Original YYYY-MM-DD, YYYY-MM, YYYY or null. No invented first day or timestamp.
Type: string,null. Original YYYY-MM-DD, YYYY-MM, YYYY or null. No invented first day or timestamp.