ShopEazydevelopers
API referenceMerchant API BetaProducts

Look an item up by barcode

Beta
Credentials, one of
  • Station token
  • OAuth access token
Scopes
listings:read
GET
/v1/merchant/stores/{storeId}/products/by-barcode

No match is { data: null } with 200, not a 404.

Access: OAuth scope listings:read; not write-gated.

Authorization

headerAuthorizationBearer <token>

It may call only the operations whose x-stations lists its kind, on its own store, and acts through the access of the owner or admin who paired it. Unpairing it, or that person leaving the business, ends it (401 station_revoked).

Path Parameters

storeId*string

A store the person can reach. Any other id answers 404, never 403.

Query Parameters

barcode*string

Spaces and dashes are ignored; variant barcodes win.

Response Body

OK

application/json
  1. response
data*|null
Example Request
curl -X GET 'https://api.shopeazy.co/v1/merchant/stores/<storeId>/products/by-barcode?barcode=%3Cbarcode%3E' \  -H 'Authorization: Bearer <access_token>'
Example Response
{  "data": {    "product": {      "id": "65myAK8IFZKwZBG84Gmw",      "kitId": "cbzXdyoC08TecFtCKeTn",      "title": "Monstera deliciosa, 20 cm pot",      "slug": "monstera-deliciosa-20-cm-pot",      "kind": "physical",      "price": {        "amount": 32900,        "currency": "ZAR"      },      "imageUrl": "https://images.example.com/plants/monstera.jpg",      "active": true,      "stock": 30    },    "variantId": null,    "variantTitle": null,    "barcode": "6001000000017"  }}