Skip to main content
GET
/
v1
/
storefronts
List storefronts
curl --request GET \
  --url https://api.mareaalcalina.com/v1/storefronts \
  --header 'Authorization: Bearer <token>'
{
  "storefronts": [
    {
      "id": "stf_abc123",
      "name": "<string>",
      "currency": "<string>",
      "businessType": "<string>",
      "branding": {
        "logoUrl": "<string>",
        "backgroundUrl": "<string>",
        "theme": {
          "primary": "<string>",
          "secondary": "<string>",
          "tertiary": "<string>"
        },
        "font": "<string>"
      },
      "schedule": {
        "monday": {
          "open": "<string>",
          "close": "<string>",
          "closed": true
        },
        "tuesday": {
          "open": "<string>",
          "close": "<string>",
          "closed": true
        },
        "wednesday": {
          "open": "<string>",
          "close": "<string>",
          "closed": true
        },
        "thursday": {
          "open": "<string>",
          "close": "<string>",
          "closed": true
        },
        "friday": {
          "open": "<string>",
          "close": "<string>",
          "closed": true
        },
        "saturday": {
          "open": "<string>",
          "close": "<string>",
          "closed": true
        },
        "sunday": {
          "open": "<string>",
          "close": "<string>",
          "closed": true
        }
      },
      "delivery": {
        "enabled": true,
        "fixedPrice": 123,
        "ranges": [
          {
            "fromKm": 123,
            "toKm": 123,
            "price": 123
          }
        ]
      },
      "pickup": true,
      "dineIn": true,
      "whatsapp": "<string>",
      "biography": {
        "title": "<string>",
        "description": "<string>"
      },
      "categories": [
        {
          "name": "<string>",
          "position": 123
        }
      ],
      "slug": "<string>",
      "_links": {
        "previewUrl": "<string>",
        "editUrl": "<string>",
        "publicUrl": "<string>"
      },
      "createdAt": "<string>",
      "updatedAt": "<string>"
    }
  ],
  "nextCursor": "<string>"
}

Authorizations

Authorization
string
header
required

Marea API key. mk_dev_* keys are developer-scoped (bootstrap, list users, register webhook). mk_user_* keys are user-scoped (manage that one user's storefronts/products). Scopes: catalog:read, catalog:write, storefront:publish, me:verify, me:resendVerification, developer:bootstrap, developer:read, developer:issueUserKey, developer:webhooks.

Headers

Accept-Language
string

BCP-47 locale tag for localized error messages (es, en, pt). Defaults to es.

Example:

"es-MX"

Query Parameters

limit
integer

Page size (default 50, max 50).

Required range: 1 <= x <= 50
Example:

50

cursor
string

Opaque ISO-8601 createdAt cursor returned by the previous page response.

Response

Success.

storefronts
object[]
required
nextCursor
string | null
required

Opaque ISO-8601 createdAt cursor; pass back as ?cursor=… for the next page. null when no more results.