Account

Report a data correction

Flags incorrect, missing, or outdated specification data on a firearm. Reports are reviewed by staff before the catalog changes.

Requires an API key belonging to a user account. Acts on the calling account's own data.

post/v1/me/reports

Request

  • Base URL: https://api.gunspec.io
  • URL: https://api.gunspec.io/v1/me/reports
  • Auth: one of:
    • API key in header X-API-Key
    • HTTP bearer

Request body

firearmIdstring required

Slug of the firearm this row belongs to.

section'game-stats' | 'specs' | 'ballistics' | 'barrel' | 'materials' | 'operating' | 'calibers' | 'users' | 'description' required

Which part of the record the report is about.

issueType'incorrect' | 'missing' | 'outdated' required

What kind of problem: incorrect, missing, outdated.

descriptionstring required

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

suggestedValuestring

What the reporter believes the value should be.

referencesstring[]

Pages the reporter cited in support.

Example request

{
  "firearmId": "glock-g17-gen5",
  "section": "specs",
  "issueType": "incorrect",
  "description": "The barrel length is listed in inches, not millimetres.",
  "suggestedValue": "114",
  "references": [
    "https://example.com/spec-sheet"
  ]
}

Response

The created report

successboolean required

Always true on a successful response. Every error carries false and an error object instead.

Example response

{
  "success": true,
  "data": {
    "id": "rep_01H8",
    "firearmId": "glock-g17-gen5",
    "section": "specifications",
    "suggestedValue": "114",
    "references": [
      "https://www.glock.com/en/products/g17"
    ],
    "createdAt": "2026-08-23T02:00:00.000Z"
  }
}

Changes

No recorded changes to this operation across all 1 revision of this API.