Get Store

Retrieve the currently selected store: profile, currencies, payment-method catalog, popup embed hostnames, abandoned-cart recovery defaults, tax defaults, and partner defaults.

This is the natural first call for any integration. It describes the store the request targets — your default store, or the one named in the X-Easycart-Store header (see Store selection). If your token reaches several stores, List stores enumerates them.

payment_methods and popup_allowed_domains are always present as bare arrays. Checkout setup behaviour is on the Store index. store.footer_id is omitted unless include=footer_id — see Legal footer.

Request

GET /store

Query Parameters

Parameter	Type	Required	Default	Description
include	string	No	—	Comma-separated tokens. Allowed: footer_id. Unknown tokens are ignored. Without footer_id, store.footer_id is omitted. See Legal footer.

Example Request

curl -X GET "https://cart.easy.tools/api/v1/store" \
  -H "Authorization: Bearer YOUR_API_TOKEN"

Read the legal footer:

curl -X GET "https://cart.easy.tools/api/v1/store?include=footer_id" \
  -H "Authorization: Bearer YOUR_API_TOKEN"

Response

Success Response (200)

Returns the store envelope. payment_methods is trimmed here — get store returns the full catalog.

{
  "store": {
    "id": "22b65ad7-ef20-4d46-9f04-110eba99cc77",
    "name": "Acme",
    "slug": "acme",
    "email": "store@example.com",
    "website_url": "https://mysite.com",
    "logo_url": "https://cdn.example.com/logo.png",
    "tax_id": "12-3456789",
    "company_name": "Acme Inc.",
    "full_name": "John Doe",
    "phone": "+1 212 555 0100",
    "address": {
      "street": "Main Street",
      "street_number": "123",
      "house_number": "4",
      "post_code": "10001",
      "city": "New York",
      "state": "NY",
      "country": "US"
    },
    "created_at": "2024-01-10T08:00:00+00:00",
    "payment_methods": [
      {
        "id": "card",
        "provider": "stripe",
        "is_enabled": true,
        "order": 1,
        "is_available": true
      },
      {
        "id": "applePay",
        "provider": "stripe",
        "is_enabled": true,
        "order": 2,
        "is_available": true
      },
      {
        "id": "blik",
        "provider": "stripe",
        "is_enabled": true,
        "order": 3,
        "is_available": true
      },
      {
        "id": "payPo",
        "provider": "paypo",
        "is_enabled": false,
        "order": 12,
        "is_available": false
      }
    ],
    "popup_allowed_domains": ["app.example.com"],
    "checkout_recovery": {
      "enabled": false,
      "coupon": null
    },
    "vat_rate": "23",
    "flat_rate": null,
    "gtu_code": null,
    "exempt_tax_kind": null,
    "partners": {
      "cookie_valid_days": 7,
      "commission_percent": 20
    }
  },
  "currencies": ["usd", "eur"]
}

A recovery coupon with an amount (no currency key):

{
  "enabled": true,
  "coupon": {
    "amount": 500,
    "percent": null
  }
}

A brand-new store with no details or products yet returns null for the optional profile fields, a null address, empty popup_allowed_domains, recovery off, null tax defaults, partner defaults of 7 days and 20%, and an empty currencies array. payment_methods is still the full catalog (trimmed here):

{
  "store": {
    "id": "350cfc8e-a2be-4851-9822-37f4ae010532",
    "name": "New Store",
    "slug": "new-store",
    "email": null,
    "website_url": null,
    "logo_url": null,
    "tax_id": null,
    "company_name": null,
    "full_name": null,
    "phone": null,
    "address": null,
    "created_at": "2026-05-20T12:00:00+00:00",
    "payment_methods": [
      {
        "id": "card",
        "provider": "stripe",
        "is_enabled": true,
        "order": 1,
        "is_available": false
      }
    ],
    "popup_allowed_domains": [],
    "checkout_recovery": {
      "enabled": false,
      "coupon": null
    },
    "vat_rate": null,
    "flat_rate": null,
    "gtu_code": null,
    "exempt_tax_kind": null,
    "partners": {
      "cookie_valid_days": 7,
      "commission_percent": 20
    }
  },
  "currencies": []
}

include=footer_id adds store.footer_id. A UUID when a footer is attached:

{
  "footer_id": "1f6b8e24-9c30-4a57-b2d8-7e4a0c5f3b91"
}

Nothing attached:

{
  "footer_id": null
}

The attachment could not be resolved. The rest of the store is unchanged, and this GET stays 200:

{
  "footer_id": {
    "message": "The Easytools attachment could not be resolved."
  }
}

See Store Object. currencies is derived from the store's existing products, so a brand-new store with no products returns an empty array. Note the casing: address.country is uppercase (e.g. "US") while currencies are lowercase (e.g. "usd").

Error Responses

Unauthorized Error (401)

{
  "message": "Unauthenticated."
}

Forbidden Error (403)

Returned when the selected store has not granted you API access — see Store selection.

{
  "message": "You do not have API access to the requested store."
}