Get Store

Retrieve information about the currently selected store: its own details plus the currencies it already transacts in.

This is the natural first call for any integration. It takes no parameters and 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.

Request

GET /store

Example Request

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

Response

Success Response (200)

Returns the store details.

{
  "store": {
    "id": "550e8400-e29b-41d4-a716-446655440000",
    "name": "Acme",
    "slug": "acme",
    "email": "store@acme.com",
    "website_url": "https://acme.com",
    "logo_url": "https://example.com/logo.png",
    "tax_id": "5251234560",
    "company_name": "Acme Sp. z o.o.",
    "full_name": "John Doe",
    "phone": "+48 600 100 200",
    "address": {
      "street": "Main Street",
      "street_number": "123",
      "house_number": "4",
      "post_code": "90210",
      "city": "Springfield",
      "state": "California",
      "country": "US"
    },
    "created_at": "2024-01-10T08:00:00+00:00"
  },
  "currencies": ["pln", "usd"]
}

A brand-new store with no details or products yet returns null for the optional fields, a null address, and an empty currencies array:

{
  "store": {
    "id": "550e8400-e29b-41d4-a716-446655440001",
    "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"
  },
  "currencies": []
}

Response Fields

Field	Type	Nullable	Description
store	object	No	The store's own information
store.id	string	No	Unique store identifier (UUID)
store.name	string	No	Store name
store.slug	string	No	URL-friendly store identifier
store.email	string	Yes	Primary contact email
store.website_url	string	Yes	Store website URL
store.logo_url	string	Yes	Store logo URL
store.tax_id	string	Yes	Tax identification number
store.company_name	string	Yes	Registered company / billing name
store.full_name	string	Yes	Contact person's full name
store.phone	string	Yes	Contact phone number
store.address	object	Yes	Store billing address. null when the store has no details set.
store.address.street	string	Yes	Street name
store.address.street_number	string	Yes	Street / building number
store.address.house_number	string	Yes	Apartment / house number
store.address.post_code	string	Yes	Postal code
store.address.city	string	Yes	City
store.address.state	string	Yes	State / region / province
store.address.country	string	Yes	Uppercase ISO 3166-1 alpha-2 country code (e.g. "PL")
store.created_at	string	No	When the store was created (ISO 8601 format)
currencies	array	No	Lowercase ISO currency codes the store already has products in. May be empty.

note

currencies is derived from the store's existing products. A brand-new store with no products returns an empty array.

info

address.country is uppercase (e.g. "PL"), while currencies are lowercase (e.g. "pln"), matching the casing used across the rest of the API.

Error Responses

Unauthorized (401)

{
  "message": "Unauthenticated."
}

Forbidden (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."
}