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 /sources - List collection jobs ·
GET /refresh-jobs
List source coverage and freshness
GET /api/v1/sources
Registered authority, coverage, freshness and source policy.
Access: public read; no TensorTrace API key.
Parameters
| Name | Location | Required | Type / limits | Meaning |
|---|---|---|---|---|
source | query | No | string | Registered data-source ID, such as openRouter. This identifies the collecting source, not necessarily the model developer. |
status | query | No | string | Source collection status. Use the status identifiers returned by /sources. |
authority | query | No | string | Exact registered authority classification from a source’s authority field. |
access_method | query | No | string | Exact registered acquisition method from a source’s access_method field. |
freshness | query | No | string | Freshness 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
| Status | Meaning | Body type |
|---|---|---|
200 | Source-backed JSON response | array of SourceDto |
400 | Invalid query | No declared JSON body |
404 | Unknown model/source | No declared JSON body |
500 | Database unavailable | No declared JSON body |
503 | Service temporarily unavailable | No 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
| Name | Location | Required | Type / limits | Meaning |
|---|---|---|---|---|
source | query | No | string | Registered data-source ID, such as openRouter. This identifies the collecting source, not necessarily the model developer. |
limit | query | No | integer Default: 50; Minimum: 1; Maximum: 200 | Maximum number of returned rows. The documented default and range apply; numeric pagination limits are clamped unless stated otherwise. |
offset | query | No | integer Default: 0; Minimum: 0 | Zero-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
| Status | Meaning | Body type |
|---|---|---|
200 | Source-backed JSON response | RefreshJobsResponse |
400 | Invalid query | No declared JSON body |
404 | Unknown model/source | No declared JSON body |
500 | Database unavailable | No declared JSON body |
503 | Service temporarily unavailable | No 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
}
| Field | Type | Required | Meaning / constraints |
|---|---|---|---|
data | array of SourceJobDto | Yes | |
total_count | integer | Yes |