Evidence
Evidence connects prepared model facts to original observations. List a model’s records, aliases, receipts, source summaries, identity merges or unresolved conflicts, then request the original record explicitly.
Evidence pages retain source and receipt identifiers. Full original payloads are intentionally absent from model cards and metadata pages; fetch the record or checksum-addressed original document when needed. source filtering on model evidence is supported only for kind=records.
Original metadata, benchmark artifacts and history preserve their observation context. Links describe their destination separately from the source that discovered them. Merging model identities does not rewrite upstream receipts or invent official identifiers.
On this page
- List model observation history ·
GET /models/{provider}/{model}/history - Read published original source metadata ·
GET /sources/{source}/metadata/{checksum} - Immutable original benchmark export ·
GET /sources/{source}/artifacts/{checksum} - Paginated source metadata; original payloads are separate evidence documents ·
GET /models/{provider}/{model}/evidence - One complete original source observation ·
GET /evidence/record
List model observation history
GET /api/v1/models/{provider}/{model}/history
Access: public read; no TensorTrace API key.
Parameters
| Name | Location | Required | Type / limits | Meaning |
|---|---|---|---|---|
limit | query | No | integer Default: 500; Minimum: 1; Maximum: 1000 | 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. |
provider | path | Yes | string | Canonical model publisher namespace; URL-encode this path segment. |
model | path | Yes | string | Canonical model name within the publisher namespace. URL-encode nested slashes in this single segment. |
Request example
curl 'https://tensortrace.net/api/v1/models/google/gemini-2.5-flash/history?limit=1'
Responses
| Status | Meaning | Body type |
|---|---|---|
200 | Source-backed JSON response | ObservationHistory |
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": [
{
"source_id": "openRouter",
"source_record_id": "google/gemini-2.5-flash",
"canonical_model_id": "google/gemini-2.5-flash",
"revision_id": 1
}
],
"total_count": 1,
"limit": 1,
"offset": 0
}
| Field | Type | Required | Meaning / constraints |
|---|---|---|---|
data | array of object | Yes | |
total_count | integer | Yes | |
limit | integer | Yes | |
offset | integer | Yes |
Read published original source metadata
GET /api/v1/sources/{source}/metadata/{checksum}
Exact UTF-8 metadata bytes returned as inert JSON, with SHA-256, media type, original URL, retrieval time and base64 body. HTML is returned as source text without execution. Content is visible only after complete receipt publication.
Access: public read; no TensorTrace API key.
Parameters
| Name | Location | Required | Type / limits | Meaning |
|---|---|---|---|---|
source | path | Yes | string | Registered data-source ID, such as openRouter. This identifies the collecting source, not necessarily the model developer. |
checksum | path | Yes | string | SHA-256 checksum identifying the immutable original document. Copy it from source evidence; do not guess it. |
Request example
curl 'https://tensortrace.net/api/v1/sources/openRouter/metadata/aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa'
Responses
| Status | Meaning | Body type |
|---|---|---|
200 | Published original metadata | object |
400 | Invalid SHA-256 | No declared JSON body |
404 | Unknown published original | No declared JSON body |
Response example · 200
Illustrative values; schema-valid and not a live catalog measurement.
{
"source_id": "openRouter",
"checksum_sha256": "example",
"source_url": "example",
"media_type": "example",
"text": "example",
"body_base64": "example"
}
| Field | Type | Required | Meaning / constraints |
|---|---|---|---|
source_id | string | Yes | |
checksum_sha256 | string | Yes | |
source_url | string | Yes | |
media_type | string | Yes | |
text | string | Yes | |
body_base64 | string | Yes |
Immutable original benchmark export
GET /api/v1/sources/{source}/artifacts/{checksum}
Access: public read; no TensorTrace API key.
Parameters
| Name | Location | Required | Type / limits | Meaning |
|---|---|---|---|---|
source | path | Yes | string | Registered data-source ID, such as openRouter. This identifies the collecting source, not necessarily the model developer. |
checksum | path | Yes | string | SHA-256 checksum identifying the immutable original document. Copy it from source evidence; do not guess it. |
Request example
curl 'https://tensortrace.net/api/v1/sources/openRouter/artifacts/aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa'
Responses
| Status | Meaning | Body type |
|---|---|---|
200 | Original decoded UTF-8 export bytes, verified by SHA-256 | string |
404 | Artifact is not linked to this source | No declared JSON body |
Response example · 200
The response contains original bytes or an image. Content types: text/plain. Preserve the declared encoding and checksum; do not parse it as JSON.
Paginated source metadata; original payloads are separate evidence documents
GET /api/v1/models/{provider}/{model}/evidence
Access: public read; no TensorTrace API key.
Parameters
| Name | Location | Required | Type / limits | Meaning |
|---|---|---|---|---|
provider | path | Yes | string | Canonical model publisher namespace; URL-encode this path segment. |
model | path | Yes | string | Canonical model name within the publisher namespace. URL-encode nested slashes in this single segment. |
kind | query | No | string Default: "records"; Values: aliases, records, receipts, sources, merges, conflicts | Evidence collection: records, aliases, receipts, sources, merges or conflicts. Default records. |
limit | query | No | integer Default: 50; Minimum: 1; Maximum: 100 | 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. |
source | query | No | string | Registered source ID. This filter is accepted only with kind=records. |
Request example
curl 'https://tensortrace.net/api/v1/models/google/gemini-2.5-flash/evidence?limit=1'
Responses
| Status | Meaning | Body type |
|---|---|---|
200 | Current local observations | DetailSectionPage |
400 | Invalid request | No declared JSON body |
404 | Unknown model or section | No declared JSON body |
Response example · 200
Illustrative values; schema-valid and not a live catalog measurement.
{
"data": [
{}
],
"total_count": 1,
"limit": 1,
"offset": 0
}
| 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 |
One complete original source observation
GET /api/v1/evidence/record
Access: public read; no TensorTrace API key.
Parameters
| Name | Location | Required | Type / limits | Meaning |
|---|---|---|---|---|
source | query | Yes | string | Registered data-source ID, such as openRouter. This identifies the collecting source, not necessarily the model developer. |
record | query | Yes | string | Exact source_record_id from an evidence index entry. This is a source record key, not a canonical model ID. |
Request example
curl 'https://tensortrace.net/api/v1/evidence/record?source=example&record=example'
Responses
| Status | Meaning | Body type |
|---|---|---|
200 | Current local observations | SourceRecordDto |
400 | Invalid request | No declared JSON body |
404 | Unknown model or section | No declared JSON body |
Response example · 200
Illustrative values; schema-valid and not a live catalog measurement.
{
"source_id": "openRouter",
"source_record_id": "google/gemini-2.5-flash",
"confidence": 1,
"updated_at": "2026-10-05T00:00:00Z",
"raw_payload": "example"
}
| 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 |