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+

client.reports.list()

The reports this account has filed, newest first, with their review state.

list(params?: ListReportsParams): Promise<PaginatedResponse<DataReport>>
GET/v1/me/reports

Explorer+

  • stringheaderrequired

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

  • integerdefault1

    Page number, from 1 to 10,000

    Range
    1 – 10000
    Example
  • integerdefault20

    Items per page (max 100)

    Range
    1 – 100
    Example

application/json

  • 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.

  • number

    Current page number

  • number

    Items per page

  • number

    Total matching records (Builder and above)

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

Full rate limits

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.