Data Quality

Ihr API-Schlüssel. Authorization: Bearer <key> wird ebenfalls akzeptiert.

The response payload.

Per-field completeness across the firearms table.

Total records matching the query across every page.

Per-field completeness, keyed by column name.

Per-field completeness across the calibers table.

Total records matching the query across every page.

Per-field completeness, keyed by column name.

Per-field completeness across the manufacturers table.

Total records matching the query across every page.

Per-field completeness, keyed by column name.

Optional. Ohne Schlüssel antwortet dieser Endpunkt nach der öffentlichen Richtlinie; ein Schlüssel erhöht Ihre Limits und schaltet planabhängige Felder frei. Authorization: Bearer <key> wird ebenfalls akzeptiert.

Report on one catalog instead of all of them. Every check is a scan of a catalog table, so a scoped call runs only the checks that concern that catalog and is the cheaper request by a wide margin. Omitted, the whole report comes back.

Akzeptiert

manufacturersfirearmscalibersattachmentsammunition

The response payload.

Which catalog this report covers, or all. Echoed so a stored copy still says what it describes.

Two different times, deliberately separate. The gap report is recomputed on every request, so computedAt describes this body. The daily snapshot is what has a last run and a next run, and it is what /v1/data/gaps/history records.

When this response was computed. Not when you read it: the response is edge-cached for a minute, so a body can be up to that old.

How often the recorded snapshot is taken.

When the last snapshot was stored, or null before the job has ever run.

The UTC day that snapshot describes.

When the next snapshot is due.

When the daily source audit last judged the catalog's citations, or null before it has ever run. Its own time rather than the snapshot's: record-cites-an-authority reads a table a separate job writes, and the two run in parallel.

Keyed by entity. Each carries its total and, per tracked field, how many records lack it. A field is missing when it is null or empty, so a column full of empty strings does not read as complete.

Visual coverage, one entry per catalog that stores media - firearms today, and an empty array for a scope that stores none. A catalog with no pictures and a catalog that does not hold pictures are different answers, so absence is never reported as zero coverage. Each kind is counted twice: records is how many records have at least one asset of that kind, which is the coverage figure, and assets is how many files exist, which is larger wherever a record carries several. none is how many records have nothing to show at all. This is what field coverage cannot report. A firearm's line drawing is a column, but its photographs, renders and 3D models are rows in a media table, so "does this record have a render" is not a question a field count can answer.

Which catalog this covers.

How many records that catalog holds.

Keyed by kind: silhouette, photo, render, model, schematic. Each carries records, assets and coveragePct.

Records with no drawing, photograph, render, model or schematic.

One entry per integrity check, each naming what passing means so a failure is actionable without reading the source.

Stable id, usable at /v1/data/gaps/checks/{checkId}.

What passing means.

Production status, one of in_production, discontinued, out_of_production, in_service, limited_production, prototype. Discontinued records are kept deliberately: a rifle built in 2004 wears parts nobody sells today.

How many records failed.

Up to five failing ids. Ask the check endpoint for the rest.

The distinct values behind the failure, present only on a check about a value rather than a record. A vocabulary failure is decided once per spelling rather than once per record, so thirty-four records reporting nineteen spellings are nineteen decisions, and ids alone would mean fetching thirty-four records to recover them. Absent on every other check rather than empty, so a check with no values to report and a check that found none cannot be confused.

Reserved for whether each cited website still resolves, which a scheduled job will fill. Reports unavailable with a reason until then.

Optional. Ohne Schlüssel antwortet dieser Endpunkt nach der öffentlichen Richtlinie; ein Schlüssel erhöht Ihre Limits und schaltet planabhängige Felder frei. Authorization: Bearer <key> wird ebenfalls akzeptiert.

Only tasks in this state.

Akzeptiert

openclaimedin_progressresolvedunverifiablenot_a_fault

Only tasks for one catalog.

Akzeptiert

manufacturersfirearmscalibersattachmentsammunition

Only one check's tasks, by the id the data quality pages print (firearm-weight-fits-its-size); the quality: prefix is optional.

Beispiel

firearm-weight-fits-its-size

Only tasks about one record field.

Beispiel

weight_empty_g

Only tasks about one record.

Beispiel

glock-17

A search: a task number (12879 or #12879), or text found in the record id or the check id.

Max. Länge

120

Beispiel

enfield

Only one kind of task.

Akzeptiert

gapcontradictionvocabularyassetverifyreport

Where the work stands: queued, working, proposed (answered and waiting on a person) or accepted.

Akzeptiert

queuedworkingproposedaccepted

Several checks' tasks at once, comma-separated (at most 40), for a page listing every check that rests on one method. Each id matches with or without its quality: prefix.

Beispiel

firearm-figure-fits-its-family,firearm-barrel-fits-its-length

open is every task not yet closed (queued or being worked); closed is every closed task, newest closure first.

Akzeptiert

openclosed

Closed tasks by who closed them, newest closure first: redback (the platform's agent filed a conclusion nobody has judged yet), redback_accepted (a person accepted what the agent filed) or team (a person worked or closed it, or corrected the record so the check no longer finds it).

Akzeptiert

redbackredback_acceptedteam

research adds each task's research inputs: the rule, the steps, the evidence and the record's own fields. Never the proposal.

Akzeptiert

research

How many to return per page.

Bereich

1 – 500

Beispiel

50

The page, from 1.

Minimum

1

Beispiel

1

The response payload.

How many tasks match.

This page.

Tasks per page.

Most recently seen first; with state=closed or closer, most recently closed first.

Stable id, derived from the finding rather than assigned, so the same finding is the same task tomorrow.

The task's number; /v1/data/tasks/{number} loads it.

With include=research only: what a researcher needs, read from the task. Never its result.

What the asset is: silhouette, render, photo, schematic, model. /v1/firearms/{id}/media/{selector} addresses an asset by this.

Which catalog.

The record, or for a vocabulary task the value being decided.

The check id or field this came from.

Production status, one of in_production, discontinued, out_of_production, in_service, limited_production, prototype. Discontinued records are kept deliberately: a rifle built in 2004 wears parts nobody sells today.

How many records this would fix. One for most; a vocabulary decision covers every record holding that spelling.

When the finding was first seen.

When a worker began, or null.

When it closed, or null.

Current page number

Items per page

Total matching records (Builder and above)

Optional. Ohne Schlüssel antwortet dieser Endpunkt nach der öffentlichen Richtlinie; ein Schlüssel erhöht Ihre Limits und schaltet planabhängige Felder frei. Authorization: Bearer <key> wird ebenfalls akzeptiert.

Only tasks for one catalog.

Akzeptiert

manufacturersfirearmscalibersattachmentsammunition

The response payload.

Finding id -> state -> number of tasks. Keys are dynamic; a state with no tasks is absent rather than zero.

Tasks closed in the last 7 days, the last 30 days and all time, each split by who closed them (the closer values the task list carries).

Closed in the last 7 days.

Closed in the last 30 days.

Closed since the board began.

Optional. Ohne Schlüssel antwortet dieser Endpunkt nach der öffentlichen Richtlinie; ein Schlüssel erhöht Ihre Limits und schaltet planabhängige Felder frei. Authorization: Bearer <key> wird ebenfalls akzeptiert.

Page number, from 1 to 10,000

Bereich

1 – 10000

Beispiel

1

Items per page (max 100)

Bereich

1 – 100

Beispiel

20

One page of results

The firearm.

The task that read the page.

The record columns confirmed.

Each confirmed figure with the maker's own sentence.

The record column confirmed.

The record's value the page agrees with, in the column's own unit.

The sentence on the maker's page that states it, as found on the page.

The maker page read.

The day it was accepted.

Current page number

Items per page

Total matching records (Builder and above)

Optional. Ohne Schlüssel antwortet dieser Endpunkt nach der öffentlichen Richtlinie; ein Schlüssel erhöht Ihre Limits und schaltet planabhängige Felder frei. Authorization: Bearer <key> wird ebenfalls akzeptiert.

Page number, from 1 to 10,000

Bereich

1 – 10000

Beispiel

1

Items per page (max 100)

Bereich

1 – 100

Beispiel

20

Only sites whose host, or whose maker ids, contain this.

Max. Länge

100

Beispiel

sig

Only one kind of source.

Akzeptiert

manufacturerstandards_bodygovernmentpeer_reviewedreferenceaggregatorpressretailercommunityother

Beispiel

government

Only one tier.

Akzeptiert

authorityclassifiedunclassified

Beispiel

authority

One page of results

The site, without www.; an archived copy counts as the site it captured.

What kind of source it is, in the source hierarchy.

The kind's place in the hierarchy: 0 is the strongest (a maker's own page), 8 the weakest (unclassified).

Why it has that kind: classed by a person from the site's own pages, a catalogued maker's own website, a .gov or .mil domain, or not yet classed.

authority for a maker's own site, a standards body or a government; classified for every other kind a person has classed; unclassified otherwise.

How many citations in the catalogue point at it.

How many records of each catalog cite it at least once.

For a maker's own site, the manufacturer ids publishing from it.

What the site said it was when a person classed it, where one did.

Current page number

Items per page

Total matching records (Builder and above)

Optional. Ohne Schlüssel antwortet dieser Endpunkt nach der öffentlichen Richtlinie; ein Schlüssel erhöht Ihre Limits und schaltet planabhängige Felder frei. Authorization: Bearer <key> wird ebenfalls akzeptiert.

The response payload.

The registry as a whole: the sites cited, the citations, and how many sites are classed.

Sites cited.

Citations.

Sites that are authorities.

Sites not yet classed.

Every kind, strongest first.

The kind.

Its place in the hierarchy: 0 is the strongest.

What it is called.

What it means.

Example sites.

Sites of this kind the catalogue cites.

Citations of this kind.

Optional. Ohne Schlüssel antwortet dieser Endpunkt nach der öffentlichen Richtlinie; ein Schlüssel erhöht Ihre Limits und schaltet planabhängige Felder frei. Authorization: Bearer <key> wird ebenfalls akzeptiert.

A host (us.glock.com) or a URL-encoded page URL.

Beispiel

sigsauer.com

The response payload.

Where the record came from: a curated entry, an inference, or an import.

The site, without www.; an archived copy counts as the site it captured.

What kind of source it is, in the source hierarchy.

The kind's place in the hierarchy: 0 is the strongest (a maker's own page), 8 the weakest (unclassified).

Why it has that kind: classed by a person from the site's own pages, a catalogued maker's own website, a .gov or .mil domain, or not yet classed.

authority for a maker's own site, a standards body or a government; classified for every other kind a person has classed; unclassified otherwise.

How many citations in the catalogue point at it.

How many records of each catalog cite it at least once.

For a maker's own site, the manufacturer ids publishing from it.

What the site said it was when a person classed it, where one did.

Optional. Ohne Schlüssel antwortet dieser Endpunkt nach der öffentlichen Richtlinie; ein Schlüssel erhöht Ihre Limits und schaltet planabhängige Felder frei. Authorization: Bearer <key> wird ebenfalls akzeptiert.

Page number, from 1 to 10,000

Bereich

1 – 10000

Beispiel

1

Items per page (max 100)

Bereich

1 – 100

Beispiel

20

Only results accepted on or after this ISO date or timestamp

Beispiel

2026-09-25

One page of results

The task.

A value to find, or a finding to judge.

The catalogue the record is in.

The record.

The record column, on a value to find.

The check suite that raised it.

The check that raised it.

The finding's key within its check.

Found, looked for and not found, or right as it stands.

The value found, in the column's own unit.

The value as the page writes it, unit included.

The page read and its own words for the value.

The page read.

The words on the page that state it.

The agent's reasoning.

The agent that worked it.

When it was accepted.

Current page number

Items per page

Total matching records (Builder and above)

Optional. Ohne Schlüssel antwortet dieser Endpunkt nach der öffentlichen Richtlinie; ein Schlüssel erhöht Ihre Limits und schaltet planabhängige Felder frei. Authorization: Bearer <key> wird ebenfalls akzeptiert.

The task, by its key as the list reports it or by its number: 1204 and its key load the same task.

Beispiel

contradiction:caliber-confidence-has-a-source:12-gauge-3-5

research adds what the check found (research, as the list gives it), the accepted decision (decision) and, where the catalogue fixed it, what the fix was and the pages it rests on (fix).

Akzeptiert

research

The response payload.

The task, in the public shape the list returns.

With include=research only: what the check found, in the shape the list gives it.

With include=research only: what was decided, once a person accepted it; null before that, and on a task closed because the record was corrected.

Found, looked for and not found, or right as it stands.

The value written to the record, where there is one.

The value as the page states it.

The quotes the decision rests on.

The worker's reasoning.

The agent that worked it, or null for the team.

When it was accepted.

With include=research only: what fixed the task, on a task that closed because the record was corrected in the catalogue: the value now written and the pages and words it rests on, read from the catalogue's research ledger when the task closed. Null on a task that closed any other way, and where the ledger holds nothing for the field.

The value written to the record: text, a number, or a list of feature tags.

The value as the page states it, unit included, on a figure.

The pages read and their own words for the value, one entry per distinct quote.

The day the research was written down.

Optional. Ohne Schlüssel antwortet dieser Endpunkt nach der öffentlichen Richtlinie; ein Schlüssel erhöht Ihre Limits und schaltet planabhängige Felder frei. Authorization: Bearer <key> wird ebenfalls akzeptiert.

How many days back to read. One row per day, so 90 is a quarter.

Bereich

1 – 365

Beispiel

90

The response payload.

The window that was read.

One row per day, oldest first.

The UTC day this row describes.

When the snapshot was taken.

Which catalog the run covered.

How many integrity checks ran.

How many of them failed.

How many records were behind those failures, summed across checks.

Weighted field coverage across every tracked catalog, as a percentage of possible values. Null before any field is tracked.

Ihr API-Schlüssel. Authorization: Bearer <key> wird ebenfalls akzeptiert.

Which catalog to report on

Akzeptiert

manufacturersfirearmscalibersattachmentsammunition

Beispiel

manufacturers

The field the records are missing. Which fields are valid depends on entity, since each catalog tracks different columns: a field the named entity does not track is refused with 400 and the error lists the ones it does.

Max. Länge

60

Beispiel

website

Page number, from 1 to 10,000

Bereich

1 – 10000

Beispiel

1

Items per page (max 100)

Bereich

1 – 100

Beispiel

20

One page of results

Slug of the record.

Its name, so a worklist is readable without a second lookup.

The field this row is missing. Echoed so a stored batch still says what it was collected for.

What the record holds in that field. Always null here: the query selects records missing it, so this says "no value" rather than "not looked at".

The pages the record already cites. Carried so a consumer can judge whether the missing value is findable without fetching the record first.

Current page number

Items per page

Total matching records (Builder and above)

Ihr API-Schlüssel. Authorization: Bearer <key> wird ebenfalls akzeptiert.

The check id, as /v1/data/gaps reports it.

Beispiel

firearm-manufacturer-exists

The response payload.

The check.

What passing means.

Every failing record.

Ihr API-Schlüssel. Authorization: Bearer <key> wird ebenfalls akzeptiert.

Only return records scoring below this threshold

Bereich

0 – 1

Beispiel

0.5

Page number, from 1 to 10,000

Bereich

1 – 10000

Beispiel

1

Items per page (max 100)

Bereich

1 – 100

Beispiel

20

One page of results

Slug of the firearm.

Display name, as the maker writes it.

How completely the record is specified and how well it is sourced, 0 to 1. A record-level completeness and provenance measure, not a per-field probability of correctness. dataConfidence on the camelCase endpoints.

Current page number

Items per page

Total matching records (Builder and above)