> ## Documentation Index > Fetch the complete documentation index at: https://docs.mareaalcalina.com/llms.txt > Use this file to discover all available pages before exploring further. # Use this when the user wants to discover storefronts on their Marea account. > Returns the bearer user's storefronts ordered by storefront id, paginated. `published` is omitted from list items — call GET /v1/storefronts/{storefrontId} for the live publish status; `_links.publicUrl` is returned here. Pass the opaque `nextCursor` back as `cursor` for the next page; `nextCursor` is null on the last page. ## OpenAPI ````yaml /openapi.json get /v1/storefronts openapi: 3.1.0 info: title: Marea Alcalina API version: 1.0.0 servers: - url: https://api.mareaalcalina.com security: [] paths: /v1/storefronts: get: summary: >- Use this when the user wants to discover storefronts on their Marea account. description: >- Returns the bearer user's storefronts ordered by storefront id, paginated. `published` is omitted from list items — call GET /v1/storefronts/{storefrontId} for the live publish status; `_links.publicUrl` is returned here. Pass the opaque `nextCursor` back as `cursor` for the next page; `nextCursor` is null on the last page. operationId: listStorefronts parameters: - schema: type: integer minimum: 1 maximum: 50 description: Page size, 1–50. Defaults to 50. required: false description: Page size, 1–50. Defaults to 50. name: limit in: query - schema: type: string description: >- Opaque cursor from the previous response's `nextCursor`. Cursors minted before 2026-09 (raw ISO timestamps) are ignored and the page restarts from the beginning. required: false description: >- Opaque cursor from the previous response's `nextCursor`. Cursors minted before 2026-09 (raw ISO timestamps) are ignored and the page restarts from the beginning. name: cursor in: query responses: '200': description: Success content: application/json: schema: $ref: '#/components/schemas/StorefrontListResponse' '400': description: §9.6 error envelope content: application/json: schema: $ref: '#/components/schemas/ApiErrorResponse' '401': description: §9.6 error envelope content: application/json: schema: $ref: '#/components/schemas/ApiErrorResponse' '403': description: §9.6 error envelope content: application/json: schema: $ref: '#/components/schemas/ApiErrorResponse' '404': description: §9.6 error envelope content: application/json: schema: $ref: '#/components/schemas/ApiErrorResponse' '409': description: §9.6 error envelope content: application/json: schema: $ref: '#/components/schemas/ApiErrorResponse' '410': description: §9.6 error envelope content: application/json: schema: $ref: '#/components/schemas/ApiErrorResponse' '413': description: §9.6 error envelope content: application/json: schema: $ref: '#/components/schemas/ApiErrorResponse' '429': description: §9.6 error envelope content: application/json: schema: $ref: '#/components/schemas/ApiErrorResponse' '500': description: §9.6 error envelope content: application/json: schema: $ref: '#/components/schemas/ApiErrorResponse' '503': description: §9.6 error envelope content: application/json: schema: $ref: '#/components/schemas/ApiErrorResponse' security: - BearerAuth: [] components: schemas: StorefrontListResponse: type: object properties: storefronts: type: array items: $ref: '#/components/schemas/StorefrontListItem' nextCursor: type: - string - 'null' required: - storefronts - nextCursor ApiErrorResponse: type: object properties: error: $ref: '#/components/schemas/ApiErrorBody' required: - error description: §9.6 uniform error envelope. Every non-2xx response uses this shape. StorefrontListItem: type: object properties: id: type: string pattern: ^stf_ example: stf_abc123 name: type: string language: type: string enum: - es - en - pt currency: type: string businessType: type: - string - 'null' branding: type: - object - 'null' properties: logoUrl: type: - string - 'null' backgroundUrl: type: - string - 'null' theme: type: - object - 'null' properties: primary: type: - string - 'null' secondary: type: - string - 'null' tertiary: type: - string - 'null' required: - primary - secondary - tertiary font: type: - string - 'null' required: - logoUrl - backgroundUrl - theme - font schedule: type: - object - 'null' properties: monday: type: - object - 'null' properties: open: type: - string - 'null' close: type: - string - 'null' closed: type: - boolean - 'null' required: - open - close - closed tuesday: type: - object - 'null' properties: open: type: - string - 'null' close: type: - string - 'null' closed: type: - boolean - 'null' required: - open - close - closed wednesday: type: - object - 'null' properties: open: type: - string - 'null' close: type: - string - 'null' closed: type: - boolean - 'null' required: - open - close - closed thursday: type: - object - 'null' properties: open: type: - string - 'null' close: type: - string - 'null' closed: type: - boolean - 'null' required: - open - close - closed friday: type: - object - 'null' properties: open: type: - string - 'null' close: type: - string - 'null' closed: type: - boolean - 'null' required: - open - close - closed saturday: type: - object - 'null' properties: open: type: - string - 'null' close: type: - string - 'null' closed: type: - boolean - 'null' required: - open - close - closed sunday: type: - object - 'null' properties: open: type: - string - 'null' close: type: - string - 'null' closed: type: - boolean - 'null' required: - open - close - closed required: - monday - tuesday - wednesday - thursday - friday - saturday - sunday delivery: type: - object - 'null' properties: enabled: type: boolean type: type: - string - 'null' enum: - fixed - distance fixedPrice: type: - number - 'null' ranges: type: - array - 'null' items: type: object properties: fromKm: type: number toKm: type: - number - 'null' price: type: number required: - fromKm - toKm - price required: - enabled - type - fixedPrice - ranges pickup: type: - boolean - 'null' dineIn: type: - boolean - 'null' whatsapp: type: - string - 'null' biography: type: - object - 'null' properties: title: type: string description: type: string required: - title - description categories: type: - array - 'null' items: type: object properties: name: type: string position: type: - integer - 'null' required: - name - position slug: type: - string - 'null' hidden: type: - boolean - 'null' _links: $ref: '#/components/schemas/StorefrontLinks' createdAt: type: - string - 'null' updatedAt: type: - string - 'null' required: - id - name - language - currency - businessType - branding - schedule - delivery - pickup - dineIn - whatsapp - biography - categories - slug - hidden - _links - createdAt - updatedAt ApiErrorBody: type: object properties: type: type: string enum: - rate_limited - invalid_request - auth - not_found - plan_limit - internal - conflict - idempotency_conflict - service_unavailable - tos_not_accepted description: High-level error category. Agents branch on this. example: auth code: type: string description: Stable machine-readable code. example: missing_authorization message: type: string description: Human-readable, localized via Accept-Language. doc: type: string description: Link to the error reference in the docs. example: https://docs.mareaalcalina.com/concepts/errors param: type: - string - 'null' requestId: type: string example: req_30a9358b-70bd-44f3-aa5d-8983b558ad84 recoverable: type: boolean retryAfterMs: type: - integer - 'null' nextActions: type: array items: $ref: '#/components/schemas/ApiNextAction' upgrade: $ref: '#/components/schemas/ApiErrorUpgrade' requiredScopes: type: array items: type: string heldScopes: type: array items: type: string required: - type - code - message - doc - param - requestId - recoverable - retryAfterMs - nextActions - upgrade StorefrontLinks: type: object properties: editUrl: type: - string - 'null' publicUrl: type: - string - 'null' required: - editUrl - publicUrl ApiNextAction: type: object properties: label: type: string example: Validate the JSON before retrying. method: type: - string - 'null' example: null url: type: - string - 'null' example: null required: - label - method - url description: A concrete action the agent can offer the user. ApiErrorUpgrade: type: - object - 'null' properties: currentPlan: type: string example: free requiredPlan: type: string example: pro upgradeUrl: type: string example: >- https://mareaalcalina.com/menus/profile?changePlan=basic&frequency=monthly&planSource=api previewUrl: type: string description: Optional preview link the agent can surface. required: - currentPlan - requiredPlan - upgradeUrl securitySchemes: BearerAuth: type: http scheme: bearer bearerFormat: mk_dev_* | mk_user_* ````