Stores
Stores

Claim Store

Take ownership of an existing store that nobody owns yet.

Until this existed, owner_id was only ever set at creation, so the ~15.9k stores imported from OpenStreetMap could never be claimed by the businesses they describe. (The exact total grows with every import; list_stores above carries a dated measurement. It was stated here as 15,859 against 15,854 forty lines up — two undated counts of the same thing, which is why this one is now rounded and the precise figure lives in one place.) Proof of control is an email address on the same domain as the store's own published homepage — see app/services/store_claim.py for why that rule, and what it deliberately refuses to decide.

Refusals are 403 with a message explaining what would work, because most of them are recoverable by the claimant (use your work address) or by us (manual review). A store that already has an owner is 409, not 403: nothing the claimant does will change it.

post/v1/stores/{store_id}/claim

Request

  • Base URL: http://localhost:8000
  • URL: http://localhost:8000/v1/stores/{store_id}/claim
  • Auth: OAuth 2 (password, token URL /v1/auth/login)

Path parameters

store_idinteger required

Response

Successful Response

namestring required
type'physical' | 'online' | 'chain' required
addressstring nullable
latnumber nullable
lonnumber nullable
homepagestring nullable
countrystring nullable
languagestring nullable
idinteger required
owner_idinteger nullable
logo_filenamestring nullable
logo_content_typestring nullable
average_ratingnumber nullable
review_countinteger nullable
product_countinteger nullable
trust_scorenumber nullable
trust_report_countinteger nullable

Changes

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