One licence from the national listing

GET

/v1/ffl/{license_number}

curl --request GET \
  --url https://api.oldsteelarsenal.com/v1/ffl/example \
  --header 'x-client-id: <x-client-id>' \
  --header 'x-signature: <x-signature>' \
  --header 'x-timestamp: <x-timestamp>'

Lookup by licence number on its stable identity (any expiration code resolves; exact match wins when several rows share the identity). Monthly-listing data plus mailing address; expiration_date is the 2-char code from the listing, NOT a date — verify returns the real date. Scope: ffl:read.

Authorizations

• ClientId
• Signature
• Timestamp

Parameters

Path Parameters

license_number

required

License Number

string

Header Parameters

x-client-id

Any of:

string

string

null

null

x-timestamp

Any of:

string

string

null

null

x-signature

Any of:

string

string

null

null

Responses

200

Successful Response

Media typeapplication/json

FflDetailResponse

object

distance_miles

required

Distance Miles

Miles from the search ZIP centroid; 0.0 in text-only searches.

number

expiration_date

required

Any of:

string

string

null

null

license_name

required

Any of:

string

string

null

null

license_number

required

License Number

Canonical 6-segment licence number with the real expiration code in segment 5.

string

mailing_city

Any of:

string

string

null

null

mailing_state

Any of:

string

string

null

null

mailing_street

Any of:

string

string

null

null

mailing_zip

Any of:

string

string

null

null

premise_city

required

Any of:

string

string

null

null

premise_state

required

Any of:

string

string

null

null

premise_street

required

Any of:

string

string

null

null

premise_zip

required

Any of:

string

string

null

null

trade_name

required

Any of:

string

string

null

null

type_code

required

Any of:

string

string

null

null

voice_phone

required

Any of:

string

string

null

null

Example^generated

{
  "distance_miles": 1,
  "expiration_date": "example",
  "license_name": "example",
  "license_number": "example",
  "mailing_city": "example",
  "mailing_state": "example",
  "mailing_street": "example",
  "mailing_zip": "example",
  "premise_city": "example",
  "premise_state": "example",
  "premise_street": "example",
  "premise_zip": "example",
  "trade_name": "example",
  "type_code": "example",
  "voice_phone": "example"
}

401

Missing/invalid HMAC auth

403

Missing ffl:read

404

No active licence with this identity

422

Validation Error

Media typeapplication/json

HTTPValidationError

object

detail

Detail

Array<object>

ValidationError

object

ctx

Context

object

input

Input

loc

required

Location

Array

msg

required

Message

string

type

required

Error Type

string

Example^generated

{
  "detail": [
    {
      "ctx": {},
      "input": "example",
      "loc": [
        "example"
      ],
      "msg": "example",
      "type": "example"
    }
  ]
}