> ## Documentation Index
> Fetch the complete documentation index at: https://urbnbox.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# List public stores

> Returns active stores and their available capacity.



## OpenAPI

````yaml /openapi.json get /api/public/stores
openapi: 3.1.0
info:
  title: UrbnBox integration API
  version: 1.0.0
  description: >-
    Create and track delivery orders, send parcels between pickup points, and
    connect Shopify.
servers:
  - url: https://portal.urbnbox.io
    description: UrbnBox production and test-key server
security: []
tags:
  - name: Shipments
    description: Quote, create, and retrieve pickup-point shipments.
  - name: Checkout sessions
    description: Hold lockers for partner checkout sessions.
  - name: Public bookings
    description: Create browser-based locker bookings.
  - name: Store discovery
    description: Find active UrbnBox stores.
  - name: Shopify
    description: Callbacks called by Shopify.
  - name: Vendor API
    description: >-
      Vendor-authenticated endpoints for delivery orders, pickup-point shipments
      and webhooks. All require an X-API-Key header with a vendor key.
paths:
  /api/public/stores:
    get:
      tags:
        - Store discovery
      summary: List public stores
      description: Returns active stores and their available capacity.
      operationId: listPublicStores
      responses:
        '200':
          description: Active public stores.
          content:
            application/json:
              schema:
                type: array
                items:
                  $ref: '#/components/schemas/PublicStore'
        '500':
          $ref: '#/components/responses/ServerError'
      security: []
components:
  schemas:
    PublicStore:
      type: object
      properties:
        id:
          type: string
        name:
          type: string
        address:
          type: string
        lat:
          type: number
          format: double
        lng:
          type: number
          format: double
        locker_count:
          type: integer
        available_lockers:
          type: integer
        shelf_count:
          type: integer
        has_lockers:
          type: boolean
        has_shelves:
          type: boolean
      required:
        - id
        - name
        - address
        - lat
        - lng
        - locker_count
        - available_lockers
        - shelf_count
        - has_lockers
        - has_shelves
  responses:
    ServerError:
      description: UrbnBox could not complete the request.
      content:
        text/plain:
          schema:
            type: string

````

This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.