Filter-based merchant search (NOT ranked; deterministic order)

Order: merchant_id ASC by default; distance ASC (ties by merchant_id) when lat/lng given with order_by=distance. The registry never ranks (REQ-DATA-2).

get/v1/merchants

Request

  • Base URL: https://mercantry.org
  • URL: https://mercantry.org/v1/merchants
  • Auth: none declared

Query parameters

neighborhoodstring
latnumber
lngnumber
radius_kmnumber
cuisine_tagsstring

Comma-separated; matches ANY.

attribute_tagsstring

Comma-separated; matches ALL.

price_band_mininteger
price_band_maxinteger
open_atstring

ISO-8601 datetime; only merchants open then. Explicit offset = exact instant (evaluated per merchant timezone); naive = each merchant's local wall clock.

bookable_onlyboolean
party_sizeinteger
sandboxboolean

true = sandbox test merchants only; false = real merchants only; omitted = both.

order_by'merchant_id' | 'distance'
limitinteger
offsetinteger

Response

Deterministically ordered page of compact merchant records.

order'merchant_id' | 'distance'
totalinteger

Changes

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