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

# List active shipping methods available to a store

> Returns every active shipping method offered by the warehouses assigned to the store.
Use the `id` values when creating orders or shipping groups that reference a shipping
method. Carrier names are the customer-facing names.




## OpenAPI

````yaml /openapi.yaml get /shipping-methods
openapi: 3.1.0
info:
  title: Cubbo Clients API
  version: '1.0'
  summary: >-
    Orders, inventory, replenishments, returns, shipping and webhooks for Cubbo
    fulfillment.
  description: >
    The Cubbo Clients API connects your store, ERP or marketplace with Cubbo's
    fulfillment network.

    All endpoints except `POST /auth/token` require a bearer token; see the
    Authentication guide.

    Request and response bodies are JSON. Errors are JSON objects with an
    `error` key.
  contact:
    name: Cubbo integrations
    email: integraciones@cubbo.com
servers:
  - url: https://api.cubbo.com/v1
    description: Production
security:
  - bearerAuth: []
tags:
  - name: Authentication
    description: Exchange client credentials for a bearer token.
  - name: Orders
    description: Create, update, hold, cancel and read sales orders.
  - name: Shipping labels
    description: Read the shipping labels generated for an order.
  - name: Inventory
    description: Products and stock per store.
  - name: Lots
    description: Lot-level inventory for products with expiration or batch tracking.
  - name: Reports
    description: Bulk reports for reconciliation.
  - name: Replenishments
    description: Inbound shipments to the warehouse.
  - name: Returns
    description: Returns and exchanges.
  - name: Stores
    description: Store provisioning and settings.
  - name: Shipping methods
    description: Available shipping methods, coverage and quotes.
  - name: Click and collect
    description: Pickup points and in-store pickup orders.
paths:
  /shipping-methods:
    get:
      tags:
        - Shipping methods
      summary: List active shipping methods available to a store
      description: >
        Returns every active shipping method offered by the warehouses assigned
        to the store.

        Use the `id` values when creating orders or shipping groups that
        reference a shipping

        method. Carrier names are the customer-facing names.
      operationId: listShippingMethods
      parameters:
        - name: store_id
          in: query
          required: true
          description: Id of the store. Your credential must have access to it.
          schema:
            type: integer
            example: 1234
      responses:
        '200':
          description: Active shipping methods
          content:
            application/json:
              schema:
                type: array
                items:
                  $ref: '#/components/schemas/ShippingMethod'
              example:
                - id: 12
                  carrier_name: ESTAFETA
                  shipping_type: national
                  delivery_type: Ground
                  country: MX
                  is_cod: false
                - id: 15
                  carrier_name: CUBBO
                  shipping_type: national
                  delivery_type: NextDay
                  country: MX
                  is_cod: false
        '401':
          description: Missing or invalid token, or no access to the store
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/UnauthorizedError'
              examples:
                invalidToken:
                  value:
                    error: Unauthorized
                    message: invalid token
                noStoreAccess:
                  value:
                    error: Unauthorized
                    message: not allowed to show? this Store
        '422':
          description: Validation error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
              examples:
                missingStoreId:
                  value:
                    error: Parameter store_id is required
        '500':
          description: Unexpected error, including an unknown `store_id`
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
              example:
                error: 'unexpected error, timestamp: 1700000000'
      security:
        - bearerAuth: []
components:
  schemas:
    ShippingMethod:
      type: object
      description: A shipping method as exposed to API clients
      required:
        - id
        - carrier_name
        - shipping_type
        - delivery_type
        - country
        - is_cod
      properties:
        id:
          type: integer
          description: Shipping method id
          example: 12
        carrier_name:
          type: string
          description: Customer-facing carrier name
          example: ESTAFETA
        shipping_type:
          type: string
          description: Scope of the method
          enum:
            - national
            - international
            - pickup
          example: national
        delivery_type:
          type: string
          description: Delivery service level
          enum:
            - SameDay
            - NextDay
            - Ground
            - Pickup
            - International
          example: Ground
        country:
          type: string
          description: ISO 3166-1 alpha-2 country of the method
          example: MX
        is_cod:
          type: boolean
          description: Whether this is a dedicated cash-on-delivery method
          example: false
    UnauthorizedError:
      type: object
      description: Body of every 401 response
      properties:
        error:
          type: string
          description: Always `Unauthorized`
          example: Unauthorized
        message:
          type: string
          description: Why the request was refused
          example: invalid token
      required:
        - error
        - message
    Error:
      type: object
      description: Error body returned by every failed request.
      required:
        - error
      properties:
        error:
          type: string
          description: >-
            Human-readable description of the failure. For `401` responses it is
            always `Unauthorized`.
          example: Parameter store_id is required
        message:
          type: string
          description: >-
            Present on `401` responses only; the reason the request was
            rejected.
          example: invalid token
        code:
          type:
            - string
            - 'null'
          description: >-
            Stable machine-readable code, present on some order, return and
            replenishment errors.
          example: ORDER_ALREADY_EXISTS
        context:
          type:
            - object
            - 'null'
          description: >-
            Extra data about the failure when available, for example the id of
            the conflicting order.
          additionalProperties: true
          example:
            order_id: 987654
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer
      bearerFormat: JWT
      description: >-
        Token returned by `POST /auth/token`, sent as `Authorization: Bearer
        <token>`.

````

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