MikMak Cart API

openapi: 3.2.0
info:
  version: '1.0'
  title: Commerce API (v1) Cart API
servers:
- url: https://api.mikmak.ai
security:
- ApiKeyAuth: []
tags:
- name: Cart
paths:
  /commerce/v1/availabilities/cart/{id}:
    get:
      tags:
      - Cart
      security:
      - ApiKeyAuth: []
      - JWTBearerAuth: []
      description: Returns store-level cart availability grouped by store. Distances are in the metric system (m).
      parameters:
      - name: id
        in: path
        required: true
        description: The list of the requested product ids separated by a comma
        schema:
          type: string
        example: 0048001353855,0048001213586
      - name: idType
        in: query
        description: 'The type of the unique product identifier (default - MikMak default Product Id, gtin, mpn, product_id). (eg: gtin)'
        schema:
          type: string
          default: default
          enum:
          - default
          - gtin
          - mpn
          - product_id
      - name: wtbId
        in: query
        required: true
        description: The experience id
        schema:
          type: string
        example: 54511c2f827bef6f9c68f29a
      - name: draft
        in: query
        description: True to use the draft experience configuration
        schema:
          type: boolean
      - name: maxDistance
        in: query
        description: Max search distance (radius) in km, this parameter can override subaccount default setting
        schema:
          type: integer
        example: 5
      - name: maxReturnedStores
        in: query
        description: Maximum number of returned stores
        schema:
          type: string
        example: 10
      - name: language
        in: query
        description: Requested language or locale for the product and retailers
        schema:
          type: string
        examples:
          language:
            value: en
            summary: Language code
          lcoale:
            value: en-US
            summary: Locale code
      - name: latitude
        in: query
        description: Search location latitude (any combination of Latitude + Longitude OR ZipCode + Country must be provided)
        required: true
        schema:
          type: number
        example: 48.8640493
      - name: longitude
        in: query
        description: Search location longitude (any combination of Latitude + Longitude OR ZipCode + Country must be provided)
        required: true
        schema:
          type: number
        example: 2.331052600000021
      - name: country
        in: query
        required: true
        description: Search location country code (2-letters)  (any combination of Latitude + Longitude OR ZipCode + Country must be provided)
        schema:
          type: string
        example: US
      - name: zipCode
        in: query
        required: true
        description: Search location zip code (any combination of Latitude + Longitude OR ZipCode + Country must be provided)
        schema:
          type: string
        example: 20004
      - name: city
        in: query
        description: Search location city
        schema:
          type: string
        example: Washington D.C
      - name: address
        in: query
        description: Search location address
        schema:
          type: string
        example: 401 9th St NW
      - name: state
        in: query
        description: Search location state
        schema:
          type: string
        example: DC
      - name: requestedCountry
        in: query
        description: Requested country code (2-letters). Only for multiple countries experience. If the location country is different from the requestedCountry, the location falls back to default location for the requested country.
        schema:
          type: string
        example: US
      - name: sessionId
        in: query
        description: Id for the current session so the events can be properly tracked.
        schema:
          type: string
        example: 1234abcd
      - name: currentUrl
        in: query
        description: The full URL visible in the shopper's browser as they interact with the Experience. It must include all query parameters. This is necessary to report on UTM parameters.
        schema:
          type: string
        example: https://www.mikmak.com/
      - name: sessionUrl
        in: query
        description: The full URL visible in the shopper's browser when they first arrived on the website. This has to be persisted throughout the session. It must include all query parameters. This is necessary to report on UTM parameters.
        schema:
          type: string
        example: https://www.mikmak.com/
      - name: includeOutOfStock
        in: query
        description: True to include out of stock products
        schema:
          type: boolean
        example: true
      - name: hideOutOfStockOfflineStores
        in: query
        description: True to hide out of stock offline stores
        schema:
          type: boolean
        example: true
      - name: applyTiedHouseLaw
        in: query
        description: To override the experience setting for applying tied house law
        schema:
          type: boolean
        example: true
      - name: retailerIds
        in: query
        description: Comma-separated list of retailer IDs to filter availability results. Only stores from the specified retailers will be returned. If omitted, all in-scope retailers are returned.
        schema:
          type: string
        example: 1,2,3
      - name: modes
        in: query
        description: Delivery mode filter (delivery, clickAndCollect, brickAndMortar). Filters availability results to only include stores that support the specified delivery modes
        schema:
          type: string
        example: delivery
      - name: src
        in: query
        description: Source identifier for tracking where the request originated from
        schema:
          type: string
      - name: instanceId
        in: query
        description: Instance identifier for multi-tenant or distributed system tracking
        schema:
          type: string
      responses:
        '200':
          description: 200 response
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/CartResponse'
              example:
                location:
                  latitude: 32.781339
                  longitude: -96.799759
                  address: null
                  city: Dallas
                  country: US
                  state: TX
                  zipCode: '75270'
                  placeType: null
                  isMetricRegion: false
                products:
                - id: 0048001353855
                  ids:
                  - 0048001353855
                  gtin: 0048001353855
                  gtins:
                  - 0048001353855
                  imageUrl: https://img.static-swaven.com/v7/https%3A%2F%2Fassets.unileversolutions.com%2Fv1%2F1195565.png?width=500&org_if_sml=1&ci_url_encoded=1
                  thumbnailImageUrl: https://img.static-swaven.com/v7/https%3A%2F%2Fassets.unileversolutions.com%2Fv1%2F1195565.png?width=144&ci_url_encoded=1&force_format=webp,png&func=fit
                  brand: hellmann's
                  title: Mayonnaise Dressing with Olive Oil
                  subtitle: null
                  description: Hellmann's Mayonnaise Dressing with Olive Oil combines the creamy, rich taste you love from Hellmann's with the delicious goodness of olive oil.
                  packaging: 20 oz
                  review: null
                - id: 0048001213586
                  ids:
                  - 0048001213586
                  gtin: 0048001213586
                  gtins:
                  - 0048001213586
                  imageUrl: https://img.static-swaven.com/v7/https%3A%2F%2Fassets.unileversolutions.com%2Fv1%2F116893611.png?width=500&org_if_sml=1&ci_url_encoded=1
                  thumbnailImageUrl: https://img.static-swaven.com/v7/https%3A%2F%2Fassets.unileversolutions.com%2Fv1%2F116893611.png?width=144&ci_url_encoded=1&force_format=webp,png&func=fit
                  brand: hellmann's
                  title: Light Mayonnaise
                  subtitle: null
                  description: Looking for a lighter mayonnaise? Hellmann's Light Mayo has half the calories & half the fat of our Real Mayonnaise with the same rich, creamy taste!
                  packaging: 30 oz
                  review: null
                carts:
                - store:
                    retailer:
                      id: 245
                      name: Walmart
                      logo:
                        isDefault: false
                        url: https://img.static-swaven.com/v7/https%3A%2F%2Fcontent-nocache.static-swaven.com%2Fimg%2Fretailers%2Fhd%2F245.png?width=200&org_if_sml=1&ci_url_encoded=1
                        type: rectangle
                      logos:
                      - url: https://img.static-swaven.com/v7/https%3A%2F%2Fcontent-nocache.static-swaven.com%2Fimg%2Fretailers%2Fhd%2F245.png?width=200&org_if_sml=1&ci_url_encoded=1
                        type: rectangle
                      - url: https://img.static-swaven.com/v7/https%3A%2F%2Fcontent-nocache.static-swaven.com%2Fimg%2Fretailers%2Fsquare%2F245.png?width=200&org_if_sml=1&ci_url_encoded=1
                        type: square
                      url: https://www.walmart.com
                      pickUpOptionAvailable: true
                      category: MASS
                    id: 245_WEB
                    name: Walmart
                    phoneNumber: null
                    internationalPhoneNumber: null
                    whatsappNumber: null
                    delivery: true
                    clickAndCollect: false
                    brickAndMortar: false
                    url: https://www.walmart.com
                    storeOpeningHoursSchema: null
                  addToCartUrl: https://wtb-api-hub-stg.swaven.com/wtb/v3/api_click?wtbid=699485f7dbdacda1bbe63aaf&d=eyJ2IjoiMTc3NDM2NDQ0MTQwMyIsImFjdGlvbiI6ImJ1eSIsImZtdCI6ImFwaSIsInR5cGUiOiJhcGkiLCJtb2R1bGUiOiJ3dGIiLCJ0b3VjaHBvaW50IjoiQVBJIiwid3RiaWQiOiI2OTk0ODVmN2RiZGFjZGExYmJlNjNhYWYiLCJvcHNjb2RlIjoiIiwidGVzdCI6MCwiY3QiOiJVUyIsInBpZCI6IjAwNDgwMDEzNTM4NTUsMDA0ODAwMTIxMzU4NiIsImFwdWlkIjpudWxsLCJvcmRpZCI6IjIzNWUzMWYwLTFjOWYtNDk0Ny04NmVjLWQzNTYwYmE3ZWM1MiIsInNpZCI6IjI0NV9XRUIiLCJwcmMiOiIxMS45NCIsInByY19jdXJyZW5jeSI6IlVTRCIsImRpc3QiOiIwLjAwIiwiZGx2IjoiSEQiLCJxdCI6MiwiaXNfYnVuZGxlIjoxLCJhdnBpZHMiOiIwMDQ4MDAxMzUzODU1LDAwNDgwMDEyMTM1ODYiLCJhdl9hcHVpZHMiOm51bGwsImF2cGlkIjpudWxsLCJhdl9hcHVpZCI6bnVsbCwiYXZncGMiOjEyLjQ1LCJhdmdkaXN0IjowLCJuYnJlcyI6MiwibmJyZWZyZXQiOm51bGwsInNpZHMiOiIyNDVfV0VCLDEyODhfV0VCIiwiY2xrdXJsYWZmIjoxLCJjbGt1cmxhZmZfcHJnaWQiOjcwMzg4LCJjbGt1cmx0Ijo1LCJ1cmwiOiJodHRwczovL3d0Yi1hcGktaHViLXN0Zy5zd2F2ZW4uY29tL3d0Yi92My9vdXRib3VuZF9jbGljaz93dGJpZD02OTk0ODVmN2RiZGFjZGExYmJlNjNhYWZcdTAwMjZtb2R1bGU9d3RiXHUwMDI2dG91Y2hwb2ludD1BUElcdTAwMjZsYW5nPWVuLVVTXHUwMDI2c2lkPTI0NV9XRUJcdTAwMjZhdnBpZD0wMDQ4MDAxMzUzODU1XHUwMDI2cHJjPTExLjk0XHUwMDI2cHJjX2N1cnJlbmN5PVVTRFx1MDAyNmNsa3VybHQ9NVx1MDAyNmlzX2J1bmRsZT0xXHUwMDI2YXZwaWRzPTAwNDgwMDEzNTM4NTUsMDA0ODAwMTIxMzU4Nlx1MDAyNmNsa3VybGFmZj0xXHUwMDI2Y2xrdXJsYWZmX3ByZ2lkPTcwMzg4XHUwMDI2dWxvY19jb3VudHJ5PVVTXHUwMDI2dWxvY19yZWdpb249VFhcdTAwMjZ1bG9jX2NpdHk9RGFsbGFzXHUwMDI2dWxvY196aXBjb2RlPTc1MjcwXHUwMDI2dWxvY19sYXQ9MzIuNzhcdTAwMjZ1bG9jX2xuZz0tOTYuODBcdTAwMjZ1cmw9YUhSMGNITTZMeTluYjNSdkxuZGhiRzFoY25RdVkyOXRMMk12TXpreU9EUTBMelUyTlRjd05pODVNemd6UDNabGFEMWhabVltYzI5MWNtTmxhV1E5YVcxd1h6QXdNREF4TVRFeE1qSXlNak16TXpNME5DWnpkV0pKWkRFOU5qazVORGcxWmpka1ltUmhZMlJoTVdKaVpUWXpZV0ZtSm5OMVlrbGtNajE3VTFkT0xVeEZRVVJKUkgwbWMzVmlTV1F6UFh0VFYwNHRSVUZPZlNaemRXSkpaRFE5ZTFOWFRpMURURWxFZlNaMVBXaDBkSEJ6SlROaEpUSm1KVEptWVdabWFXd3VkMkZzYldGeWRDNWpiMjBsTW1aallYSjBKVEptWW5WNWJtOTNKVE5tYVhSbGJYTWxNMlEwTXpnNU16RTRPU1UzWXpFbE1tTXhNREk1TVRjek15VTNZekUlM2RcdTAwMjZ2PXt2fVx1MDAyNnNfdXJsPXtTV04tU1VSTH1cdTAwMjZyZnIyPXtTV04tUkZSMn1cdTAwMjZzX3Jmcj17U1dOLVNSRlJ9XHUwMDI2cmZyPXtTV04tUkZSfSIsImxlYWRpZCI6Ijk3OTk5MWUzODYzODQ2ZTc4NmU3MDA5MjBhNjUwMjcwIiwicmZyIjpudWxsLCJyZnIyIjoiaHR0cDovL2FwaS1xYS5taWttYWsuYWkvY29tbWVyY2UvdjEvYXZhaWxhYmlsaXRpZXMvY2FydC8wMDQ4MDAxMzUzODU1LDAwNDgwMDEyMTM1ODY/d3RiaWQ9Njk5NDg1ZjdkYmRhY2RhMWJiZTYzYWFmXHUwMDI2bGFuZ3VhZ2U9ZW4tVVNcdTAwMjZyZXF1ZXN0ZWRDb3VudHJ5PVVTXHUwMDI2X2ludGVybmFsVXNhZ2U9dHJ1ZVx1MDAyNmluY2x1ZGVPdXRPZlN0b2NrPWZhbHNlXHUwMDI2bGF0aXR1ZGU9MzIuNzgxMzM5XHUwMDI2bG9uZ2l0dWRlPS05Ni43OTk3NTlcdTAwMjZjb3VudHJ5PVVTXHUwMDI2c3RhdGU9VFhcdTAwMjZjaXR5PURhbGxhc1x1MDAyNm5leHRFbmRwb2ludFYyPXRydWUiLCJvdXRib3VuZCI6MSwieF9wdXJwb3NlIjpudWxsLCJpaWQiOiIifQ==
                  doNotTrackAddToCartUrl: https://affil.walmart.com/cart/buynow?items=43893189%7c1%2c10291733%7c1
                  totalPrice:
                    currency: USD
                    value: 11.94
                    valueFormatted: '11.94'
                  totalQuantity: 2
                  productCount: 2
                  averagePrice:
                    currency: USD
                    value: 5.97
                    valueFormatted: '5.97'
                  availableProducts: 2
                  requestedProducts: 2
                  availabilities:
                  - productId: 0048001353855
                    gtin: 0048001353855
                    quantity: 1
                    stockStatus: Available
                    price:
                      currency: USD
                      value: 5.97
                      valueFormatted: '5.97'
                    totalPrice:
                      currency: USD
                      value: 5.97
                      valueFormatted: '5.97'
                    clickUrl: https://wtb-api-hub-stg.swaven.com/wtb/v3/outbound_click?wtbid=699485f7dbdacda1bbe63aaf&module=wtb&touchpoint=API&lang=en-US&sid=245_WEB&avpid=0048001353855&prc=5.97&prc_currency=USD&clkurlt=3&clkurlaff=1&clkurlaff_prgid=70388&uloc_country=US&uloc_region=TX&uloc_city=Dallas&uloc_zipcode=75270&uloc_lat=32.78&uloc_lng=-96.80&url=aHR0cHM6Ly9nb3RvLndhbG1hcnQuY29tL2MvMzkyODQ0LzE0NDY3NjAvOTM4Mz9wcm9kc2t1PTQzODkzMTg5JnN1YklkMT02OTk0ODVmN2RiZGFjZGExYmJlNjNhYWYmc3ViSWQyPXtTV04tTEVBRElEfSZzdWJJZDM9MDA0ODAwMTM1Mzg1NSZzdWJJZDQ9e1NXTi1DTElEfSZzdWJJZDU9bWlrbWFrMyZ1PWh0dHBzJTNBJTJGJTJGd3d3LndhbG1hcnQuY29tJTJGaXAlMkZIZWxsbWFubi1zLUhpZ2gtaW4tT21lZ2EtMy1BTEEtYW5kLVZpdGFtaW4tRS1PbGl2ZS1PaWwtTWF5b25uYWlzZS0yMC1mbC1vei1Cb3R0bGUlMkY0Mzg5MzE4OSZpbnRzcmM9Q0FURl8xMDY2NQ%3d%3d&v=1774364441386&s_url={SWN-SURL}&rfr2={SWN-RFR2}&s_rfr={SWN-SRFR}&rfr={SWN-RFR}&url_to=aHR0cHM6Ly93d3cud2FsbWFydC5jb20vaXAvSGVsbG1hbm4tcy1NYXlvbm5haXNlLURyZXNzaW5nLXdpdGgtT2xpdmUtT2lsLVJpY2gtaW4tT21lZ2EtMy1BTEEtMjAtb3ovNDM4OTMxODk%2fZmlsdGVycz1beyJpbnRlbnQiOiJyZXRhaWxlciIsInZhbHVlcyI6WyJXYWxtYXJ0Il19XQ%3d%3d
                    doNotTrackClickUrl: https://www.walmart.com/ip/Hellmann-s-Mayonnaise-Dressing-with-Olive-Oil-Rich-in-Omega-3-ALA-20-oz/43893189?filters=%5b%7b%22intent%22%3a%22retailer%22%2c%22values%22%3a%5b%22Walmart%22%5d%7d%5d
                    isTiedHouseLaw: false
                  - productId: 0048001213586
                    gtin: 0048001213586
                    quantity: 1
                    stockStatus: Available
                    price:
                      currency: USD
                      value: 5.97
                      valueFormatted: '5.97'
                    totalPrice:
                      currency: USD
                      value: 5.97
                      valueFormatted: '5.97'
                    clickUrl: https://wtb-api-hub-stg.swaven.com/wtb/v3/outbound_click?wtbid=699485f7dbdacda1bbe63aaf&module=wtb&touchpoint=API&lang=en-US&sid=245_WEB&avpid=0048001213586&prc=5.97&prc_currency=USD&clkurlt=3&clkurlaff=1&clkurlaff_prgid=70388&uloc_country=US&uloc_region=TX&uloc_city=Dallas&uloc_zipcode=75270&uloc_lat=32.78&uloc_lng=-96.80&url=aHR0cHM6Ly9nb3RvLndhbG1hcnQuY29tL2MvMzkyODQ0LzE0NDY3NjAvOTM4Mz9wcm9kc2t1PTEwMjkxNzMzJnN1YklkMT02OTk0ODVmN2RiZGFjZGExYmJlNjNhYWYmc3ViSWQyPXtTV04tTEVBRElEfSZzdWJJZDM9MDA0ODAwMTIxMzU4NiZzdWJJZDQ9e1NXTi1DTElEfSZzdWJJZDU9bWlrbWFrMyZ1PWh0dHBzJTNBJTJGJTJGd3d3LndhbG1hcnQuY29tJTJGaXAlMkZIZWxsbWFubi1zLU1hZGUtd2l0aC1DYWdlLUZyZWUtRWdncy1MaWdodC1NYXlvbm5haXNlLTMwLWZsLW96LUphciUyRjEwMjkxNzMzJmludHNyYz1DQVRGXzEwNjY1&v=1774364441386&s_url={SWN-SURL}&rfr2={SWN-RFR2}&s_rfr={SWN-SRFR}&rfr={SWN-RFR}&url_to=aHR0cHM6Ly93d3cud2FsbWFydC5jb20vaXAvSGVsbG1hbm4tcy1NYWRlLXdpdGgtQ2FnZS1GcmVlLUVnZ3MtTGlnaHQtTWF5b25uYWlzZS1Db25kaW1lbnRzLTMwLWZsLW96LUphci8xMDI5MTczMz9maWx0ZXJzPVslN0IiaW50ZW50IjoicmV0YWlsZXIiLCJ2YWx1ZXMiOlsiV2FsbWFydCJdJTdEXQ%3d%3d
                    doNotTrackClickUrl: https://www.walmart.com/ip/Hellmann-s-Made-with-Cage-Free-Eggs-Light-Mayonnaise-Condiments-30-fl-oz-Jar/10291733?filters=%5b%7b%22intent%22%3a%22retailer%22%2c%22values%22%3a%5b%22Walmart%22%5d%7d%5d
                    isTiedHouseLaw: false
                - store:
                    retailer:
                      id: 1288
                      name: Instacart
                      logo:
                        isDefault: false
                        url: https://img.static-swaven.com/v7/https%3A%2F%2Fcontent-nocache.static-swaven.com%2Fimg%2Fretailers%2Fhd%2F1288.png?width=200&org_if_sml=1&ci_url_encoded=1
                        type: rectangle
                      logos:
                      - url: https://img.static-swaven.com/v7/https%3A%2F%2Fcontent-nocache.static-swaven.com%2Fimg%2Fretailers%2Fhd%2F1288.png?width=200&org_if_sml=1&ci_url_encoded=1
                        type: rectangle
                      - url: https://img.static-swaven.com/v7/https%3A%2F%2Fcontent-nocache.static-swaven.com%2Fimg%2Fretailers%2Fsquare%2F1288.png?width=200&org_if_sml=1&ci_url_encoded=1
                        type: square
                      url: https://www.instacart.com/
                      pickUpOptionAvailable: false
                      category: DELIVERY_SERVICES
                    id: 1288_WEB
                    name: Instacart
                    phoneNumber: null
                    internationalPhoneNumber: null
                    whatsappNumber: null
                    delivery: true
                    clickAndCollect: false
                    brickAndMortar: false
                    url: https://www.instacart.com/
                    storeOpeningHoursSchema: null
                  addToCartUrl: https://wtb-api-hub-stg.swaven.com/wtb/v3/api_click?wtbid=699485f7dbdacda1bbe63aaf&d=eyJ2IjoiMTc3NDM2NDQ0MTQyNSIsImFjdGlvbiI6ImJ1eSIsImZtdCI6ImFwaSIsInR5cGUiOiJhcGkiLCJtb2R1bGUiOiJ3dGIiLCJ0b3VjaHBvaW50IjoiQVBJIiwid3RiaWQiOiI2OTk0ODVmN2RiZGFjZGExYmJlNjNhYWYiLCJvcHNjb2RlIjoiIiwidGVzdCI6MCwiY3QiOiJVUyIsInBpZCI6IjAwNDgwMDEyMTM1ODYiLCJhcHVpZCI6bnVsbCwib3JkaWQiOiIzMzYwOWU0Yy02ZWM0LTQ4MDUtYjhjOS1iM2JlNjU2M2M5ZWQiLCJzaWQiOiIxMjg4X1dFQiIsInByYyI6IjYuOTkiLCJwcmNfY3VycmVuY3kiOiJVU0QiLCJkaXN0IjoiMC4wMCIsImRsdiI6IkhEIiwicXQiOjEsImlzX2J1bmRsZSI6bnVsbCwiYXZwaWRzIjpudWxsLCJhdl9hcHVpZHMiOm51bGwsImF2cGlkIjoiMDA0ODAwMTIxMzU4NiIsImF2X2FwdWlkIjpudWxsLCJhdmdwYyI6MTIuNDUsImF2Z2Rpc3QiOjAsIm5icmVzIjoyLCJuYnJlZnJldCI6bnVsbCwic2lkcyI6IjI0NV9XRUIsMTI4OF9XRUIiLCJjbGt1cmxhZmYiOjEsImNsa3VybGFmZl9wcmdpZCI6MTAwOTU4LCJjbGt1cmx0Ijo1LCJ1cmwiOiJodHRwczovL3d0Yi1hcGktaHViLXN0Zy5zd2F2ZW4uY29tL3d0Yi92My9vdXRib3VuZF9jbGljaz93dGJpZD02OTk0ODVmN2RiZGFjZGExYmJlNjNhYWZcdTAwMjZtb2R1bGU9d3RiXHUwMDI2dG91Y2hwb2ludD1BUElcdTAwMjZsYW5nPWVuLVVTXHUwMDI2c2lkPTEyODhfV0VCXHUwMDI2YXZwaWQ9MDA0ODAwMTIxMzU4Nlx1MDAyNnByYz02Ljk5XHUwMDI2cHJjX2N1cnJlbmN5PVVTRFx1MDAyNmNsa3VybHQ9NVx1MDAyNmNsa3VybGFmZj0xXHUwMDI2Y2xrdXJsYWZmX3ByZ2lkPTEwMDk1OFx1MDAyNnVsb2NfY291bnRyeT1VU1x1MDAyNnVsb2NfcmVnaW9uPVRYXHUwMDI2dWxvY19jaXR5PURhbGxhc1x1MDAyNnVsb2NfemlwY29kZT03NTI3MFx1MDAyNnVsb2NfbGF0PTMyLjc4XHUwMDI2dWxvY19sbmc9LTk2LjgwXHUwMDI2dXJsPWFIUjBjSE02THk5M2RHSXRZWEJwTFdoMVlpMXBiblF1YzNkaGRtVnVMbU52YlM5aGNHa3ZkalF2WTJGeWRDOXlaV1JwY21WamREOTNkR0pKWkQwMk9UazBPRFZtTjJSaVpHRmpaR0V4WW1KbE5qTmhZV1ltY21WMFlXbHNaWEpKWkQweE1qZzRKbWwwWlcxelBVeHBaMmgwSlRJMU1qQk5ZWGx2Ym01aGFYTmxPakUlM2RcdTAwMjZ2PXt2fVx1MDAyNnNfdXJsPXtTV04tU1VSTH1cdTAwMjZyZnIyPXtTV04tUkZSMn1cdTAwMjZzX3Jmcj17U1dOLVNSRlJ9XHUwMDI2cmZyPXtTV04tUkZSfSIsImxlYWRpZCI6ImQ3NzBiMWM3ZjM5ZjQ3MjU5ZWQwOGVhYWQwYzkwNmU3IiwicmZyIjpudWxsLCJyZnIyIjoiaHR0cDovL2FwaS1xYS5taWttYWsuYWkvY29tbWVyY2UvdjEvYXZhaWxhYmlsaXRpZXMvY2FydC8wMDQ4MDAxMzUzODU1LDAwNDgwMDEyMTM1ODY/d3RiaWQ9Njk5NDg1ZjdkYmRhY2RhMWJiZTYzYWFmXHUwMDI2bGFuZ3VhZ2U9ZW4tVVNcdTAwMjZyZXF1ZXN0ZWRDb3VudHJ5PVVTXHUwMDI2X2ludGVybmFsVXNhZ2U9dHJ1ZVx1MDAyNmluY2x1ZGVPdXRPZlN0b2NrPWZhbHNlXHUwMDI2bGF0aXR1ZGU9MzIuNzgxMzM5XHUwMDI2bG9uZ2l0dWRlPS05Ni43OTk3NTlcdTAwMjZjb3VudHJ5PVVTXHUwMDI2c3RhdGU9VFhcdTAwMjZjaXR5PURhbGxhc1x1MDAyNm5leHRFbmRwb2ludFYyPXRydWUiLCJvdXRib3VuZCI6MSwieF9wdXJwb3NlIjpudWxsLCJpaWQiOiIifQ==
                  doNotTrackAddToCartUrl: https://wtb-api-hub-int.swaven.com/api/v4/cart/redirect?wtbId=699485f7dbdacda1bbe63aaf&retailerId=1288&items=Light%2520Mayonnaise%3a1
                  totalPrice:
                    currency: USD
                    value: 6.99
                    valueFormatted: '6.99'
                  totalQuantity: 1
                  productCount: 1
                  averagePrice:
                    currency: USD
                    value: 6.99
                    valueFormatted: '6.99'
                  availableProducts: 1
                  requestedProducts: 2
                  availabilities:
                  - productId: 0048001213586
                    gtin: 0048001213586
                    quantity: 1
                    stockStatus: Available
                    price:
                      currency: USD
                      value: 6.99
                      valueFormatted: '6.99'
                    totalPrice:
                      currency: USD
                      value: 6.99
                      valueFormatted: '6.99'
                    clickUrl: https://wtb-api-hub-stg.swaven.com/wtb/v3/outbound_click?wtbid=699485f7dbdacda1bbe63aaf&module=wtb&touchpoint=API&lang=en-US&sid=1288_WEB&avpid=0048001213586&prc=6.99&prc_currency=USD&clkurlt=3&clkurlaff=1&clkurlaff_prgid=100958&uloc_country=US&uloc_region=TX&uloc_city=Dallas&uloc_zipcode=75270&uloc_lat=32.78&uloc_lng=-96.80&url=aHR0cHM6Ly9pbnN0YWNhcnQub2xvaXliLm5ldC9jLzM5Mjg0NC8xMjg2NTI0Lzc0MTI%2fcHJvZHNrdT02Nzk0NjA2Njg0NjEmc3ViSWQxPTY5OTQ4NWY3ZGJkYWNkYTFiYmU2M2FhZiZzdWJJZDI9e1NXTi1MRUFESUR9JnN1YklkMz0wMDQ4MDAxMjEzNTg2JnN1YklkND17U1dOLUNMSUR9JnN1YklkNT1taWttYWszJnU9aHR0cHMlM0ElMkYlMkZ3d3cuaW5zdGFjYXJ0LmNvbSUyRmxhbmRpbmclM0Zwcm9kdWN0X2lkJTNENzExNTclMjYmaW50c3JjPUNBVEZfOTc5Nw%3d%3d&v=1774364441386&s_url={SWN-SURL}&rfr2={SWN-RFR2}&s_rfr={SWN-SRFR}&rfr={SWN-RFR}&url_to=aHR0cHM6Ly93d3cuaW5zdGFjYXJ0LmNvbS9wcm9kdWN0cy83MTE1Nz9jc3I9dHJ1ZQ%3d%3d
                    doNotTrackClickUrl: https://www.instacart.com/products/71157?csr=true
                    isTiedHouseLaw: false
                sessionId: NjljMmE3MTlmYTA1NDI2MGYxYWVjNzNjXzAwNDgwMDEzNTM4NTUsMDA0ODAwMTIxMzU4Ng==
        '400':
          description: '**Bad Request.** The request is invalid and cannot be processed.


            > **When:** Returned when required parameters are missing, malformed, or fail validation (e.g., invalid IDs, query parameters, or location data).

            '
        '401':
          description: '**Unauthorized.** Authentication failed.


            > **When:** Returned when the request is missing a valid API key or JWT, or when the token is expired or invalid.

            '
        '403':
          description: '**Forbidden.** The request is authenticated but not allowed.


            > **When:** Returned when access is restricted due to configuration rules, disallowed countries, disabled operators, or unauthorized products.

            '
        '404':
          description: '**Not Found.** The requested resource does not exist.


            > **When:** Returned when a configuration, product, experience, or continuation token cannot be found.

            '
        '500':
          description: '**Internal Server Error.** An unexpected server error occurred.


            > **When:** Returned when the server encounters an unhandled error while processing the request.

            '
components:
  schemas:
    CatalogProduct:
      type: object
      description: Product metadata returned with availability and cart responses (catalog fields; not store-specific).
      properties:
        id:
          type: string
          description: Product id (when applicable)
        ids:
          type: array
          description: Alternate product identifiers
          items:
            type: string
        gtin:
          type: string
          description: GTIN
        gtins:
          type: array
          description: List of GTINs
          items:
            type: string
            description: GTIN
        imageUrl:
          type: string
          description: Product image URL
        thumbnailImageUrl:
          type: string
          description: Product thumbnail image URL (optimized for small displays, 144px width)
        brand:
          type: string
          description: Brand
        title:
          type: string
          description: Title
        subtitle:
          type:
          - string
          - 'null'
          description: Subtitle
        description:
          type: string
          description: Product description (empty by default)
        packaging:
          type: string
          description: Containing or color
        review:
          type: object
          description: Review
          properties:
            count:
              type: number
              description: Count
            averageRating:
              type: number
              description: Rating
            roundedAverageRating:
              type: number
              description: Rounded rating
    CartAvailabilityLine:
      type: object
      description: Line item within a store cart (public `CartAvailability` shape)
      properties:
        productId:
          type: string
          description: Product identifier
        gtin:
          type: string
          description: GTIN
        quantity:
          type: integer
          description: Quantity in cart
        stockStatus:
          type: string
          description: Stock status for the line
        price:
          type: object
          description: Unit price
          properties:
            currency:
              type: string
              description: Currency
            value:
              type: number
              description: Value
            valueFormatted:
              type: string
              description: Display-formatted price string
            valueWithVoucher:
              type:
              - number
              - 'null'
              description: Unit price after voucher when applicable
        totalPrice:
          type: object
          description: Line total price
          properties:
            currency:
              type: string
              description: Currency
            value:
              type: number
              description: Value
            valueFormatted:
              type: string
              description: Display-formatted price string
            valueWithVoucher:
              type:
              - number
              - 'null'
              description: Line total after voucher when applicable
        voucher:
          allOf:
          - $ref: '#/components/schemas/Voucher'
        clickUrl:
          type: string
          description: Tracked click URL for this line
        doNotTrackClickUrl:
          type: string
          description: Click URL without tracking
        isTiedHouseLaw:
          type: boolean
          description: Whether tied house law applies to this line
    Voucher:
      type: object
      description: Promotional voucher that may apply to a line item
      properties:
        id:
          type: string
        versionId:
          type: string
        name:
          type: string
        code:
          type: string
        retailerId:
          type:
          - integer
          - 'null'
        online:
          type:
          - boolean
          - 'null'
        offline:
          type: boolean
        startDate:
          type:
          - string
          - 'null'
          format: date-time
        endDate:
          type:
          - string
          - 'null'
          format: date-time
        type:
          type: string
          description: Voucher type (configuration enum)
        text:
          type: string
        imageUrl:
          type: string
        description:
          type: string
        ctaText:
          type: string
        discountType:
          type:
          - string
          - 'null'
        discountPercent:
          type:
          - number
          - 'null'
          format: double
        discountAmount:
          type:
          - number
          - 'null'
          format: double
        url:
          type: string
        gtins:
          type: array
          items:
            type: string
        hasSecondStep:
          type: boolean
        secondStepUrl:
          type: string
        secondStepType:
          type:
          - string
          - 'null'
        formId:
          type:
          - string
          - 'null'
        locales:
          type: object
    CartResponse:
      type: object
      description: Public cart response (location, requested products, per-store carts, optional sessionId and alcoholSettings).
      properties:
        location:
          $ref: '#/components/schemas/Location'
        products:
          type: array
          description: Requested products (catalog metadata)
          items:
            $ref: '#/components/schemas/CatalogProduct'
        carts:
          type: array
          description: One entry per store with aggregated cart totals and per-line availability
          items:
            $ref: '#/components/schemas/CartStoreGroup'
        sessionId:
          type:
          - string
          - 'null'
          description: SessionID value
        alcoholSettings:
          type:
          - object
          - 'null'
          description: Alcohol settings configuration
          properties:
            tiedHouseLaw:
              type: integer
              description: Tied house law setting code
              example: 4
            showLocalRetailers:
              type: boolean
              description: Whether to show local retailers
              example: true
            showRetailerText:
              type: boolean
              description: Whether to show retailer text
              example: true
            settingCode:
              type: integer
              description: Alcohol setting code
              example: 3
            applyTiedHouseLaw:
              type: boolean
              description: Whether to apply tied house law
              example: true
            tiedHouseConditionMet:
              type: boolean
              description: Whether tied house condition is met (null if applyTiedHouseLaw is false)
              example: false
    Location:
      type: object
      description: Resolved or requested search location (shared across products, availabilities, and cart responses).
      properties:
        latitude:
          type: number
          description: Latitude
        longitude:
          type: number
          description: Longitude
        address:
          type:
          - string
          - 'null'
          description: Address
        city:
          type: string
          description: City
        country:
          type: string
          description: Country
        state:
          type: string
          description: State
        zipCode:
          type: string
          description: Zip code
        placeType:
          type:
          - string
          - 'null'
          description: Place type
        isMetricRegion:
          type: boolean
          description: Country is standard metric system (m) or not (miles)
    CartStoreGroup:
      type: object
      description: Store-level cart with aggregated totals and line items (public `Cart` shape)
      properties:
        store:
          type: object
          description: Store details (same general shape as store on each availability item in AvailabilitiesResponse)
          properties:
            retailer:
              type: object
              description: Retailer
              properties:
                id:
                  type: number
                  description: Id
                name:
                  type: string
                  description: Name
                lo

# --- truncated at 32 KB (40 KB total) ---
# Full source: https://raw.githubusercontent.com/api-evangelist/mikmak/refs/heads/main/openapi/mikmak-cart-api-openapi.yml