> ## Documentation Index
> Fetch the complete documentation index at: https://docs.launchmystore.io/llms.txt
> Use this file to discover all available pages before exploring further.

# Get Shop

> Retrieve shop information and settings

# Get Shop

Returns the shop's account record and settings. The shop object is returned
as-is (it is not transformed into a Shopify-style shop resource), so the field
names match the platform's store account.

## Request

<CodeGroup>
  ```bash cURL theme={null}
  curl -X GET "https://api.launchmystore.io/api/v1/shop.json" \
    -H "Authorization: Bearer YOUR_ACCESS_TOKEN"
  ```

  ```javascript Node.js theme={null}
  const response = await fetch('https://api.launchmystore.io/api/v1/shop.json', {
    headers: {
      'Authorization': 'Bearer YOUR_ACCESS_TOKEN'
    }
  });
  ```
</CodeGroup>

## Response

The response uses the standard envelope. The shop record is nested under
`data.shop`.

<ResponseField name="status" type="integer">
  HTTP status code (e.g., `200`)
</ResponseField>

<ResponseField name="state" type="string">
  Result state — `success` on success, `error` on failure
</ResponseField>

<ResponseField name="message" type="string">
  Human-readable message, or `null` on success
</ResponseField>

<ResponseField name="data" type="object">
  Response data wrapper

  <Expandable title="data">
    <ResponseField name="shop" type="object">
      The shop account object

      <Expandable title="Shop Object">
        <ResponseField name="id" type="string">
          Unique shop ID
        </ResponseField>

        <ResponseField name="name" type="string">
          Shop name
        </ResponseField>

        <ResponseField name="email" type="string">
          Account email
        </ResponseField>

        <ResponseField name="businessEmail" type="string">
          Business contact email
        </ResponseField>

        <ResponseField name="ownerName" type="string">
          Store owner name
        </ResponseField>

        <ResponseField name="business" type="string">
          Business / legal name
        </ResponseField>

        <ResponseField name="phone" type="string">
          Shop phone number
        </ResponseField>

        <ResponseField name="storeURL" type="string">
          Store URL
        </ResponseField>

        <ResponseField name="storeAdd" type="string">
          Store address
        </ResponseField>

        <ResponseField name="country" type="string">
          Store country (drives the store's currency)
        </ResponseField>

        <ResponseField name="availableCountries" type="array">
          Countries the store ships to / supports
        </ResponseField>

        <ResponseField name="availableLanguages" type="array">
          Language codes enabled for the store
        </ResponseField>

        <ResponseField name="defaultLanguage" type="string">
          Default / primary language code
        </ResponseField>

        <ResponseField name="createdAt" type="string">
          Shop creation timestamp (ISO 8601)
        </ResponseField>

        <ResponseField name="updatedAt" type="string">
          Last update timestamp (ISO 8601)
        </ResponseField>
      </Expandable>
    </ResponseField>
  </Expandable>
</ResponseField>

<Note>
  Sensitive fields (password, verification code, internal payment-customer IDs,
  POS PIN) are always excluded from this response.
</Note>

## Example Response

```json theme={null}
{
  "status": 200,
  "state": "success",
  "message": null,
  "data": {
    "shop": {
      "id": "9f1c2b7e-3d4a-4f6b-8c1d-2e5a6b7c8d90",
      "name": "My Awesome Store",
      "email": "hello@mystore.com",
      "businessEmail": "billing@mystore.com",
      "ownerName": "Jane Doe",
      "business": "My Awesome Store LLC",
      "phone": "+1 (555) 123-4567",
      "storeURL": "mystore.launchmystore.io",
      "storeAdd": "123 Commerce St, San Francisco, CA 94102",
      "country": "United States",
      "availableCountries": ["United States", "Canada"],
      "availableLanguages": ["en"],
      "defaultLanguage": "en",
      "createdAt": "2023-01-15T10:00:00.000Z",
      "updatedAt": "2024-03-20T14:30:00.000Z"
    }
  },
  "count": null,
  "pagination": null
}
```

## Error Response

Errors return the same envelope with `state` set to `error` and a message.

```json theme={null}
{
  "status": 404,
  "state": "error",
  "message": "Shop not found",
  "data": null
}
```

| Status | Description                        |
| ------ | ---------------------------------- |
| `401`  | Invalid or missing access token    |
| `403`  | App doesn't have `read_shop` scope |
| `404`  | Shop not found                     |