Shop Details

🔒

Requires read_shop access scope. For more access scope

The Shop Details API allows developers to fetch comprehensive information about a shop by using its unique identifier and configurable query parameters. This endpoint supports retrieving specific fields based on the user’s request. For instance, users can request key shop attributes such as id, name, and email.This API is especially useful for:

  1. Retrieving store metadata like name, owner details, and operational settings.
  2. Customizing query results by specifying required fields.
  3. Verifying shop details through its unique domain prefix (shopdomain).Example: If the shop’s domain is https://store123.myshoplazza.com, the shopdomain would be store123.

Request Parameters

Public Request Parameters

📘

Public Request Parameters

Query Parameters

ParameterTypeRequiredExampleDescription
fieldsStringNoid,name,emailSpecifies which fields to include in the response. Use commas to separate multiple fields.

Response Explanation

Public Response Parameters

📘

Public Response Parameters

Successful Response

FieldTypeExampleDescription
shop.accountString[email protected]Email address of the shop account.
shop.address1Stringaddress1Primary address of the shop.
shop.cityStringcityCity where the shop is located.
shop.country_codeStringCNCountry code of the shop's location.
shop.created_atString2023-11-08T11:51:39ZISO timestamp when the shop was created.
shop.currencyStringUSDDefault currency used by the shop.
shop.emailString[email protected]Contact email address of the shop owner.
shop.idInteger633130Unique identifier for the shop.
shop.nameStringtest-shoplazzaName of the shop.
shop.stateStringavailableCurrent operational state of the shop.
shop.timezoneString+0800Timezone offset for the shop location.
shop.subscriptionObject{ "type": "base" }Shop plan info
shop.subscription.typeStringbasePlan type.

Error Response

Error responses in the API can be represented using two different fields: errors and error. Both fields provide details about issues encountered during request processing. Below is an explanation of the fields with their respective examples and descriptions.

FieldTypeExampleDescription
errorsArray["Context"]A list of errors encountered during the request processing.
FieldTypeExampleDescription
errorString "store is not active"Indicates an error encountered during the process.

Error Detail

HTTP Status CodeError MessageDescription
400Bad RequestThe request is malformed or contains invalid parameters.
401UnauthorizedErrorMissing or invalid authentication credentials.
404store is not activeThe requested store is inactive or unavailable.
500Response message parsing errorInternal server error caused by a failure in parsing the response message.
520No contextThe request lacks sufficient context to process successfully.
Language
Credentials
Header
URL
Click Try It! to start a request and see the response here!