GunSpec

Reports

Data corrections the account has reported. A report is how a consumer tells us a specification is wrong. It is reviewed by a person and never applied automatically; nothing here writes to the catalog. Session-scoped (/v1/me/*).

Auth RequiredExplorer+

Report an incorrect or missing value.

create(params: CreateReportParams): Promise<APIResponse<DataReport>>
POST/v1/me/reports

  • stringheaderrequired

    Your API key. Authorization: Bearer <key> is accepted in its place.

  • stringrequired

    Slug of the firearm this row belongs to.

  • stringrequired

    Which part of the record the report is about.

  • stringrequired

    What kind of problem: incorrect, missing, outdated.

  • stringrequired

    Prose summary of the record, where one has been written.

  • string

    What the reporter believes the value should be.

  • string[]

    Pages the reporter cited in support.

  • DataReport

    A community-submitted data correction against a firearm.

  • string

    Opaque report id.

  • string

    Slug of the firearm this row belongs to.

  • string

    Which part of the record the report is about.

  • ReportIssueType

    What a data report says is wrong.

  • string

    Prose summary of the record, where one has been written.

  • string | null

    What the reporter believes the value should be.

  • string[]

    Pages the reporter cited in support.

  • ReportStatus

    Lifecycle of a data report.

  • string

    When the record was first added, YYYY-MM-DD HH:MM:SS in UTC.

  • string | null

    When staff reviewed it, or null while it is pending.

  • 400VALIDATION_ERRORValidation error
  • 401UNAUTHORIZEDAPI key required
  • 403FORBIDDENValid key, not permitted
  • 413PAYLOAD_TOO_LARGERequest body too large
  • 429RATE_LIMITEDRate limit exceeded
  • 500INTERNAL_ERRORUnexpected server error

Minimum tier
Explorer+
Monthly quota
200/mo
Rate limit
10/min
Daily cap
50

Figures shown are for this endpoint's minimum tier. Higher tiers raise every limit.