Skip to main content
GET
/
v1
/
storefronts
/
{storefrontId}
/
products
List products
curl --request GET \
  --url https://api.mareaalcalina.com/v1/storefronts/{storefrontId}/products \
  --header 'Authorization: Bearer <token>'
{
  "products": [
    {
      "id": "prd_abc123",
      "title": "<string>",
      "description": "<string>",
      "price": 123,
      "salePrice": 123,
      "category": "<string>",
      "subcategory": "<string>",
      "imageUrl": "<string>",
      "thumbnailUrl": "<string>",
      "sku": "<string>",
      "slug": "<string>",
      "position": 123,
      "cartProduct": true,
      "hide": true,
      "stock": 123,
      "tags": [
        "<string>"
      ],
      "extraProductsCategory": [
        {
          "title": "<string>",
          "obligatory": true,
          "multipleOption": true,
          "maxOptions": 123,
          "minOptions": 123,
          "extraProducts": [
            {
              "title": "<string>",
              "price": 1,
              "available": true,
              "stock": 123
            }
          ]
        }
      ],
      "imageProcessingPending": true,
      "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"

Path Parameters

storefrontId
string
required

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.

includeHidden
boolean
default:false

Include products with hide: true. Defaults to false.

Response

Success.

products
object[]
required
nextCursor
string | null
required

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