Sources

Sources identify where TensorTrace obtains data, what authority and acquisition method they have, and how their collection is refreshed. Coverage and latest receipts describe indexed observations, not a promise that every upstream model is currently available.

Freshness can be fresh, stale, refreshing, backoff, neverRefreshed or manual. A source may wait for credentials or permission. Jobs describe acquisition attempts and their outcome. The public interface is read-only; source administration and refresh triggers belong to the separate administrator service.

A stale receipt remains evidence of its original observation. It is not replaced with fabricated current values.

On this page

List source coverage and freshness

GET /api/v1/sources

Registered authority, coverage, freshness and source policy.

Access: public read; no TensorTrace API key.

Parameters

NameLocationRequiredType / limitsMeaning
sourcequeryNostringRegistered data-source ID, such as openRouter. This identifies the collecting source, not necessarily the model developer.
statusqueryNostringSource collection status. Use the status identifiers returned by /sources.
authorityqueryNostringExact registered authority classification from a source’s authority field.
access_methodqueryNostringExact registered acquisition method from a source’s access_method field.
freshnessqueryNostringFreshness state: fresh, stale, refreshing, backoff, neverRefreshed or manual. due/needsrefresh selects due sources; needsattention/failed selects active failures; all disables the filter.

Request example

curl 'https://tensortrace.net/api/v1/sources'

Responses

StatusMeaningBody type
200Source-backed JSON responsearray of SourceDto
400Invalid queryNo declared JSON body
404Unknown model/sourceNo declared JSON body
500Database unavailableNo declared JSON body
503Service temporarily unavailableNo declared JSON body

Response example · 200

Illustrative values; schema-valid and not a live catalog measurement.

[
    {
        "source_id": "openRouter",
        "display_name": "Model Reviewer",
        "short_name": "example",
        "category": "example",
        "authority": "example",
        "access_method": "example",
        "icon_name": "example",
        "accent": "example",
        "data_kinds": [
            "example"
        ],
        "is_official": false,
        "status": "example",
        "freshness": "example",
        "is_stale": false,
        "is_refresh_due": false,
        "has_active_failure": false,
        "consecutive_failures": 1,
        "coverage": {
            "canonical_model_count": 1,
            "alias_count": 1,
            "source_record_count": 1,
            "linked_source_record_count": 1,
            "capability_count": 1,
            "price_point_count": 1,
            "benchmark_score_count": 1,
            "runtime_metric_count": 1,
            "system_performance_result_count": 1,
            "safety_finding_count": 1,
            "receipt_count": 1
        }
    }
]

Type: array of SourceDto.

List collection jobs

GET /api/v1/refresh-jobs

Access: public read; no TensorTrace API key.

Parameters

NameLocationRequiredType / limitsMeaning
sourcequeryNostringRegistered data-source ID, such as openRouter. This identifies the collecting source, not necessarily the model developer.
limitqueryNointeger Default: 50; Minimum: 1; Maximum: 200Maximum number of returned rows. The documented default and range apply; numeric pagination limits are clamped unless stated otherwise.
offsetqueryNointeger Default: 0; Minimum: 0Zero-based number of matching rows to skip. Default 0; negative values are clamped to 0.

Request example

curl 'https://tensortrace.net/api/v1/refresh-jobs?limit=1'

Responses

StatusMeaningBody type
200Source-backed JSON responseRefreshJobsResponse
400Invalid queryNo declared JSON body
404Unknown model/sourceNo declared JSON body
500Database unavailableNo declared JSON body
503Service temporarily unavailableNo declared JSON body

Response example · 200

Illustrative values; schema-valid and not a live catalog measurement.

{
    "data": [
        {
            "refresh_job_id": "00000000-0000-4000-8000-000000000001",
            "source_id": "openRouter",
            "status": "example",
            "requested_by": "example",
            "force": false,
            "started_at": "2026-10-05T00:00:00Z"
        }
    ],
    "total_count": 1
}
FieldTypeRequiredMeaning / constraints
dataarray of SourceJobDtoYes
total_countintegerYes

Models

Loading
EVIDENCE / COMPARISON

Benchmarks

Explore every benchmark

Loading

These charts contain model-linked results. The charts above also include unlinked source profiles. Compare scores within each evaluation. Model quality, usage, transparency and system performance measure different things.

Install TensorTrace