@spree/docs 0.1.180 → 0.1.181

package/dist/api-reference/store.yaml

@@ -1051,8 +1051,8 @@ paths:
               example:
                 data:
                 - id: prod_UkLWZg9DAJ
-                  name: Product 2029085
-                  slug: product-2029085
+                  name: Product 2039085
+                  slug: product-2039085
                   meta_title:
                   meta_description:
                   meta_keywords:
@@ -1083,8 +1083,8 @@ paths:
                   original_price:
                   seller_id:
                 - id: prod_gbHJdmfrXB
-                  name: Product 2038209
-                  slug: product-2038209
+                  name: Product 2048209
+                  slug: product-2048209
                   meta_title:
                   meta_description:
                   meta_keywords:
@@ -1212,8 +1212,8 @@ paths:
             application/json:
               example:
                 id: prod_UkLWZg9DAJ
-                name: Product 2306885
-                slug: product-2306885
+                name: Product 2316885
+                slug: product-2316885
                 meta_title:
                 meta_description:
                 meta_keywords:
@@ -1498,6 +1498,8 @@ paths:
                   market_id: mkt_UkLWZg9DAJ
                   channel_id: ch_UkLWZg9DAJ
                   preferred_stock_location_id:
+                  company_id:
+                  company_name:
                   number: cart_UkLWZg9DAJ
                   token: ckMf2iQ6r5adLceTPfKVH9BP
                   email:
@@ -1607,6 +1609,8 @@ paths:
                   market_id: mkt_UkLWZg9DAJ
                   channel_id: ch_UkLWZg9DAJ
                   preferred_stock_location_id:
+                  company_id:
+                  company_name:
                   number: cart_gbHJdmfrXB
                   token: pvLw1ZWLLQNxh1uvSPUCdSmt
                   email:
@@ -1787,6 +1791,8 @@ paths:
                 market_id: mkt_UkLWZg9DAJ
                 channel_id: ch_UkLWZg9DAJ
                 preferred_stock_location_id:
+                company_id:
+                company_name:
                 number: cart_UkLWZg9DAJ
                 token: jBrNbC8FSNyavqebdqu7e3uL
                 email:
@@ -1955,6 +1961,8 @@ paths:
                 market_id: mkt_UkLWZg9DAJ
                 channel_id: ch_UkLWZg9DAJ
                 preferred_stock_location_id:
+                company_id:
+                company_name:
                 number: cart_UkLWZg9DAJ
                 token: HnnryvFFwjfx9P6ykByF4Gg2
                 email:
@@ -2112,6 +2120,8 @@ paths:
                 market_id: mkt_UkLWZg9DAJ
                 channel_id: ch_UkLWZg9DAJ
                 preferred_stock_location_id:
+                company_id:
+                company_name:
                 number: cart_UkLWZg9DAJ
                 token: PMVmxRAiLqMivU5QgJqfpQMD
                 email:
@@ -2391,6 +2401,8 @@ paths:
                 market_id: mkt_UkLWZg9DAJ
                 channel_id: ch_UkLWZg9DAJ
                 preferred_stock_location_id:
+                company_id:
+                company_name:
                 number: cart_UkLWZg9DAJ
                 token: rrGvkDXx3KcQVwLVk8XiVCVk
                 email: tarah@tromp.com
@@ -2476,6 +2488,7 @@ paths:
                 payments: []
                 billing_address:
                   id: addr_gbHJdmfrXB
+                  label:
                   first_name: John
                   last_name: Doe
                   full_name: John Doe
@@ -2497,6 +2510,7 @@ paths:
                   state_name: New York
                 shipping_address:
                   id: addr_UkLWZg9DAJ
+                  label:
                   first_name: John
                   last_name: Doe
                   full_name: John Doe
@@ -2607,6 +2621,8 @@ paths:
                 market_id: mkt_UkLWZg9DAJ
                 cart_id: cart_UkLWZg9DAJ
                 channel_id: ch_UkLWZg9DAJ
+                company_id:
+                company_name:
                 number: R1001
                 email: marvel@bruen.com
                 customer_note:
@@ -2783,6 +2799,7 @@ paths:
                     source_required: false
                 billing_address:
                   id: addr_uw2YK1rnl0
+                  label:
                   first_name: John
                   last_name: Doe
                   full_name: John Doe
@@ -2804,6 +2821,7 @@ paths:
                   state_name: New York
                 shipping_address:
                   id: addr_OIJLhNcSbf
+                  label:
                   first_name: John
                   last_name: Doe
                   full_name: John Doe
@@ -2918,6 +2936,8 @@ paths:
                 market_id: mkt_UkLWZg9DAJ
                 channel_id: ch_UkLWZg9DAJ
                 preferred_stock_location_id:
+                company_id:
+                company_name:
                 number: cart_UkLWZg9DAJ
                 token: 4ryA4ms4Nim9TfxNW4fZi3au
                 email:
@@ -2981,8 +3001,8 @@ paths:
                   preorder_ships_at:
                   quantity: 1
                   currency: USD
-                  name: Product 1684241
-                  slug: product-1684241
+                  name: Product 1694241
+                  slug: product-1694241
                   options_text: ''
                   price: '10.0'
                   display_price: "$10.00"
@@ -3110,6 +3130,8 @@ paths:
                 market_id: mkt_UkLWZg9DAJ
                 channel_id: ch_UkLWZg9DAJ
                 preferred_stock_location_id:
+                company_id:
+                company_name:
                 number: cart_UkLWZg9DAJ
                 token: gvr8TwNVJpxWf27uUHDj5Lj4
                 email:
@@ -3170,8 +3192,8 @@ paths:
                   preorder_ships_at:
                   quantity: 1
                   currency: USD
-                  name: Product 1703461
-                  slug: product-1703461
+                  name: Product 1713461
+                  slug: product-1713461
                   options_text: ''
                   price: '10.0'
                   display_price: "$10.00"
@@ -3293,6 +3315,8 @@ paths:
                 market_id: mkt_UkLWZg9DAJ
                 channel_id: ch_UkLWZg9DAJ
                 preferred_stock_location_id:
+                company_id:
+                company_name:
                 number: cart_UkLWZg9DAJ
                 token: KLLfFWg9T6dGonBb65hHjaZr
                 email: donya@jacobsonkunze.biz
@@ -3347,8 +3371,8 @@ paths:
                   preorder_ships_at:
                   quantity: 1
                   currency: USD
-                  name: Product 1728182
-                  slug: product-1728182
+                  name: Product 1738182
+                  slug: product-1738182
                   options_text: ''
                   price: '10.0'
                   display_price: "$10.00"
@@ -3454,10 +3478,11 @@ paths:
                 billing_address:
                 shipping_address:
                   id: addr_EfhxLZ9ck8
+                  label:
                   first_name: John
                   last_name: Doe
                   full_name: John Doe
-                  address1: 199 Lovely Street
+                  address1: 226 Lovely Street
                   address2: Northwest
                   postal_code: '10118'
                   city: New York
@@ -3577,6 +3602,8 @@ paths:
                 market_id: mkt_UkLWZg9DAJ
                 channel_id: ch_UkLWZg9DAJ
                 preferred_stock_location_id:
+                company_id:
+                company_name:
                 number: cart_UkLWZg9DAJ
                 token: nZjAPYSKrNaHf2ZVT6eZfNJV
                 email:
@@ -3633,8 +3660,8 @@ paths:
                   preorder_ships_at:
                   quantity: 1
                   currency: USD
-                  name: Product 1745702
-                  slug: product-1745702
+                  name: Product 1755702
+                  slug: product-1755702
                   options_text: ''
                   price: '10.0'
                   display_price: "$10.00"
@@ -3817,6 +3844,8 @@ paths:
                 market_id: mkt_UkLWZg9DAJ
                 channel_id: ch_UkLWZg9DAJ
                 preferred_stock_location_id:
+                company_id:
+                company_name:
                 number: cart_UkLWZg9DAJ
                 token: Wgq8NrLX3TUQLroJRYWFdQd5
                 email:
@@ -3877,8 +3906,8 @@ paths:
                   preorder_ships_at:
                   quantity: 1
                   currency: USD
-                  name: Product 1789569
-                  slug: product-1789569
+                  name: Product 1799569
+                  slug: product-1799569
                   options_text: ''
                   price: '10.0'
                   display_price: "$10.00"
@@ -4016,6 +4045,8 @@ paths:
                 market_id: mkt_UkLWZg9DAJ
                 channel_id: ch_UkLWZg9DAJ
                 preferred_stock_location_id:
+                company_id:
+                company_name:
                 number: cart_UkLWZg9DAJ
                 token: d12LXVnL3KtzGjXePqRawnPc
                 email:
@@ -4025,10 +4056,10 @@ paths:
                 total_quantity: 2
                 warnings:
                 - code: delivery_unavailable
-                  message: Product 18163 cannot be delivered to the selected address
+                  message: Product 18263 cannot be delivered to the selected address
                   line_item_id: li_UkLWZg9DAJ
                 - code: delivery_unavailable
-                  message: Product 182298 cannot be delivered to the selected address
+                  message: Product 183298 cannot be delivered to the selected address
                   line_item_id: li_gbHJdmfrXB
                 coupon_code:
                 item_total: '29.99'
@@ -4082,8 +4113,8 @@ paths:
                   preorder_ships_at:
                   quantity: 1
                   currency: USD
-                  name: Product 18163
-                  slug: product-18163
+                  name: Product 18263
+                  slug: product-18263
                   options_text: ''
                   price: '10.0'
                   display_price: "$10.00"
@@ -4113,8 +4144,8 @@ paths:
                   preorder_ships_at:
                   quantity: 1
                   currency: USD
-                  name: Product 182298
-                  slug: product-182298
+                  name: Product 183298
+                  slug: product-183298
                   options_text: ''
                   price: '19.99'
                   display_price: "$19.99"
@@ -4269,6 +4300,8 @@ paths:
                 market_id: mkt_UkLWZg9DAJ
                 channel_id: ch_UkLWZg9DAJ
                 preferred_stock_location_id:
+                company_id:
+                company_name:
                 number: cart_UkLWZg9DAJ
                 token: Yq5XuZqq7KS7y7n2dMsChnZM
                 email:
@@ -4333,8 +4366,8 @@ paths:
                   preorder_ships_at:
                   quantity: 1
                   currency: USD
-                  name: Product 1889165
-                  slug: product-1889165
+                  name: Product 1899165
+                  slug: product-1899165
                   options_text: ''
                   price: '10.0'
                   display_price: "$10.00"
@@ -4451,6 +4484,8 @@ paths:
                 market_id: mkt_UkLWZg9DAJ
                 channel_id: ch_UkLWZg9DAJ
                 preferred_stock_location_id:
+                company_id:
+                company_name:
                 number: cart_UkLWZg9DAJ
                 token: arTvbVzmU1krWKLbRnWDZ3cL
                 email:
@@ -5087,6 +5122,8 @@ paths:
                 market_id: mkt_UkLWZg9DAJ
                 channel_id: ch_UkLWZg9DAJ
                 preferred_stock_location_id:
+                company_id:
+                company_name:
                 number: cart_UkLWZg9DAJ
                 token: acfBZtWemHae74Y3g18LQg1f
                 email:
@@ -5143,8 +5180,8 @@ paths:
                   preorder_ships_at:
                   quantity: 1
                   currency: USD
-                  name: Product 2509789
-                  slug: product-2509789
+                  name: Product 2519789
+                  slug: product-2519789
                   options_text: ''
                   price: '10.0'
                   display_price: "$10.00"
@@ -5291,6 +5328,8 @@ paths:
                 market_id: mkt_UkLWZg9DAJ
                 channel_id: ch_UkLWZg9DAJ
                 preferred_stock_location_id:
+                company_id:
+                company_name:
                 number: cart_UkLWZg9DAJ
                 token: BHWevnp2PQxC1jSWU3ZFLejT
                 email:
@@ -5351,8 +5390,8 @@ paths:
                   preorder_ships_at:
                   quantity: 1
                   currency: USD
-                  name: Product 252179
-                  slug: product-252179
+                  name: Product 253179
+                  slug: product-253179
                   options_text: ''
                   price: '10.0'
                   display_price: "$10.00"
@@ -5471,6 +5510,8 @@ paths:
                 market_id: mkt_UkLWZg9DAJ
                 cart_id:
                 channel_id: ch_UkLWZg9DAJ
+                company_id:
+                company_name:
                 number: R1001
                 email: guest@example.com
                 customer_note:
@@ -5516,8 +5557,8 @@ paths:
                   preorder_ships_at:
                   quantity: 1
                   currency: USD
-                  name: Product 192496
-                  slug: product-192496
+                  name: Product 193496
+                  slug: product-193496
                   options_text: ''
                   price: '10.0'
                   display_price: "$10.00"
@@ -5622,10 +5663,11 @@ paths:
                 payments: []
                 billing_address:
                   id: addr_UkLWZg9DAJ
+                  label:
                   first_name: John
                   last_name: Doe
                   full_name: John Doe
-                  address1: 255 Lovely Street
+                  address1: 282 Lovely Street
                   address2: Northwest
                   postal_code: '10118'
                   city: New York
@@ -5643,10 +5685,11 @@ paths:
                   state_name: New York
                 shipping_address:
                   id: addr_gbHJdmfrXB
+                  label:
                   first_name: John
                   last_name: Doe
                   full_name: John Doe
-                  address1: 256 Lovely Street
+                  address1: 283 Lovely Street
                   address2: Northwest
                   postal_code: '10118'
                   city: New York
@@ -5748,6 +5791,7 @@ paths:
               example:
                 data:
                 - id: addr_UkLWZg9DAJ
+                  label:
                   first_name: John
                   last_name: Doe
                   full_name: John Doe
@@ -5768,6 +5812,7 @@ paths:
                   country_iso: US
                   state_name: New York
                 - id: addr_gbHJdmfrXB
+                  label:
                   first_name: John
                   last_name: Doe
                   full_name: John Doe
@@ -5788,6 +5833,7 @@ paths:
                   country_iso: US
                   state_name: New York
                 - id: addr_EfhxLZ9ck8
+                  label:
                   first_name: John
                   last_name: Doe
                   full_name: John Doe
@@ -5888,6 +5934,7 @@ paths:
             application/json:
               example:
                 id: addr_VqXmZF31wY
+                label:
                 first_name: John
                 last_name: Doe
                 full_name: John Doe
@@ -6044,6 +6091,7 @@ paths:
             application/json:
               example:
                 id: addr_EfhxLZ9ck8
+                label:
                 first_name: John
                 last_name: Doe
                 full_name: John Doe
@@ -6125,6 +6173,7 @@ paths:
             application/json:
               example:
                 id: addr_EfhxLZ9ck8
+                label:
                 first_name: John
                 last_name: Doe
                 full_name: John Doe
@@ -6571,6 +6620,8 @@ paths:
                   market_id: mkt_UkLWZg9DAJ
                   cart_id:
                   channel_id: ch_UkLWZg9DAJ
+                  company_id:
+                  company_name:
                   number: R1001
                   email: idella.ratke@runolfsdottir.us
                   customer_note:
@@ -6616,8 +6667,8 @@ paths:
                     preorder_ships_at:
                     quantity: 1
                     currency: USD
-                    name: Product 1585270
-                    slug: product-1585270
+                    name: Product 1595270
+                    slug: product-1595270
                     options_text: ''
                     price: '10.0'
                     display_price: "$10.00"
@@ -6722,10 +6773,11 @@ paths:
                   payments: []
                   billing_address:
                     id: addr_EfhxLZ9ck8
+                    label:
                     first_name: John
                     last_name: Doe
                     full_name: John Doe
-                    address1: 159 Lovely Street
+                    address1: 186 Lovely Street
                     address2: Northwest
                     postal_code: '10118'
                     city: New York
@@ -6743,10 +6795,11 @@ paths:
                     state_name: New York
                   shipping_address:
                     id: addr_VqXmZF31wY
+                    label:
                     first_name: John
                     last_name: Doe
                     full_name: John Doe
-                    address1: 160 Lovely Street
+                    address1: 187 Lovely Street
                     address2: Northwest
                     postal_code: '10118'
                     city: New York
@@ -6875,6 +6928,8 @@ paths:
                 market_id: mkt_UkLWZg9DAJ
                 cart_id:
                 channel_id: ch_UkLWZg9DAJ
+                company_id:
+                company_name:
                 number: R1001
                 email: whitney_homenick@leschwhite.co.uk
                 customer_note:
@@ -6920,8 +6975,8 @@ paths:
                   preorder_ships_at:
                   quantity: 1
                   currency: USD
-                  name: Product 1605633
-                  slug: product-1605633
+                  name: Product 1615633
+                  slug: product-1615633
                   options_text: ''
                   price: '10.0'
                   display_price: "$10.00"
@@ -7026,10 +7081,11 @@ paths:
                 payments: []
                 billing_address:
                   id: addr_EfhxLZ9ck8
+                  label:
                   first_name: John
                   last_name: Doe
                   full_name: John Doe
-                  address1: 165 Lovely Street
+                  address1: 192 Lovely Street
                   address2: Northwest
                   postal_code: '10118'
                   city: New York
@@ -7047,10 +7103,11 @@ paths:
                   state_name: New York
                 shipping_address:
                   id: addr_VqXmZF31wY
+                  label:
                   first_name: John
                   last_name: Doe
                   full_name: John Doe
-                  address1: 166 Lovely Street
+                  address1: 193 Lovely Street
                   address2: Northwest
                   postal_code: '10118'
                   city: New York
@@ -7265,10 +7322,11 @@ paths:
                 display_available_store_credit_total: "$0.00"
                 addresses:
                 - id: addr_UkLWZg9DAJ
+                  label:
                   first_name: John
                   last_name: Doe
                   full_name: John Doe
-                  address1: 171 Lovely Street
+                  address1: 198 Lovely Street
                   address2: Northwest
                   postal_code: '10118'
                   city: New York
@@ -7285,10 +7343,11 @@ paths:
                   country_iso: US
                   state_name: New York
                 - id: addr_gbHJdmfrXB
+                  label:
                   first_name: John
                   last_name: Doe
                   full_name: John Doe
-                  address1: 172 Lovely Street
+                  address1: 199 Lovely Street
                   address2: Northwest
                   postal_code: '10118'
                   city: New York
@@ -7306,10 +7365,11 @@ paths:
                   state_name: New York
                 default_billing_address:
                   id: addr_gbHJdmfrXB
+                  label:
                   first_name: John
                   last_name: Doe
                   full_name: John Doe
-                  address1: 172 Lovely Street
+                  address1: 199 Lovely Street
                   address2: Northwest
                   postal_code: '10118'
                   city: New York
@@ -7327,10 +7387,11 @@ paths:
                   state_name: New York
                 default_shipping_address:
                   id: addr_UkLWZg9DAJ
+                  label:
                   first_name: John
                   last_name: Doe
                   full_name: John Doe
-                  address1: 171 Lovely Street
+                  address1: 198 Lovely Street
                   address2: Northwest
                   postal_code: '10118'
                   city: New York
@@ -7417,10 +7478,11 @@ paths:
                 display_available_store_credit_total: "$0.00"
                 addresses:
                 - id: addr_UkLWZg9DAJ
+                  label:
                   first_name: John
                   last_name: Doe
                   full_name: John Doe
-                  address1: 173 Lovely Street
+                  address1: 200 Lovely Street
                   address2: Northwest
                   postal_code: '10118'
                   city: New York
@@ -7437,10 +7499,11 @@ paths:
                   country_iso: US
                   state_name: New York
                 - id: addr_gbHJdmfrXB
+                  label:
                   first_name: John
                   last_name: Doe
                   full_name: John Doe
-                  address1: 174 Lovely Street
+                  address1: 201 Lovely Street
                   address2: Northwest
                   postal_code: '10118'
                   city: New York
@@ -7458,10 +7521,11 @@ paths:
                   state_name: New York
                 default_billing_address:
                   id: addr_gbHJdmfrXB
+                  label:
                   first_name: John
                   last_name: Doe
                   full_name: John Doe
-                  address1: 174 Lovely Street
+                  address1: 201 Lovely Street
                   address2: Northwest
                   postal_code: '10118'
                   city: New York
@@ -7479,10 +7543,11 @@ paths:
                   state_name: New York
                 default_shipping_address:
                   id: addr_UkLWZg9DAJ
+                  label:
                   first_name: John
                   last_name: Doe
                   full_name: John Doe
-                  address1: 173 Lovely Street
+                  address1: 200 Lovely Street
                   address2: Northwest
                   postal_code: '10118'
                   city: New York
@@ -9278,7 +9343,7 @@ paths:
                 variant:
                   id: variant_gbHJdmfrXB
                   product_id: prod_gbHJdmfrXB
-                  sku: SKU-306
+                  sku: SKU-307
                   options_text: ''
                   track_inventory: true
                   media_count: 0
@@ -9927,15 +9992,18 @@ paths:
                   message: Valid API key required
               schema:
                 "$ref": "#/components/schemas/ErrorResponse"
-  "/api/v3/store/delivery_methods":
+  "/api/v3/store/account/companies":
     get:
-      summary: List delivery methods
+      summary: List my company memberships
       tags:
-      - Delivery
+      - Companies
       security:
       - api_key: []
-      description: Storefront-visible delivery methods. Filter by fulfillment_type
-        to discover pickup options.
+        bearer_auth: []
+      description: |
+        Returns the authenticated customer's company memberships, each with the node it
+        is held on and the path of nodes above it. Standing covers the node and every
+        node below it, so a membership on a parent authorizes buying for its divisions.
       x-codeSamples:
       - lang: javascript
         label: Spree SDK
@@ -9947,56 +10015,63 @@ paths:
             publishableKey: '<api-key>',
           })
 
-          const { data: pickupMethods } = await client.deliveryMethods.list({
-            fulfillment_type: 'pickup',
-          })
+          // The buyer's memberships, each carrying its node and the path above it.
+          const { data: memberships } = await client.account.companies({ token: '<token>' })
       parameters:
       - name: x-spree-api-key
         in: header
         required: true
         schema:
           type: string
-      - name: fulfillment_type
-        in: query
-        required: false
-        description: 'Filter: shipping, digital, pickup'
+      - name: Authorization
+        in: header
+        required: true
         schema:
           type: string
       responses:
         '200':
-          description: delivery methods found
+          description: memberships listed
           content:
             application/json:
               example:
                 data:
-                - id: dm_gbHJdmfrXB
-                  name: Store pickup
-                  code: PICKUP
-                  estimated_transit_business_days_min:
-                  estimated_transit_business_days_max:
-                  digital: false
-                  pickup: true
-                  pickup_point: false
-                meta:
-                  page: 1
-                  limit: 25
-                  count: 1
-                  pages: 1
-                  from: 1
-                  to: 1
-                  in: 1
-                  previous:
-                  next:
-  "/api/v3/store/delivery_methods/{id}/pickup_locations":
+                - id: cmem_UkLWZg9DAJ
+                  company_id: comp_UkLWZg9DAJ
+                  customer_id: cust_UkLWZg9DAJ
+                  email: pasty.koepp@farrell.name
+                  company:
+                    id: comp_UkLWZg9DAJ
+                    name: Acme Industrial
+                    kind: company
+                    parent_id:
+                    ancestors: []
+        '401':
+          description: not authenticated
+          content:
+            application/json:
+              example:
+                error:
+                  code: authentication_required
+                  message: Authentication required
+  "/api/v3/store/companies/{id}":
+    parameters:
+    - name: id
+      in: path
+      required: true
+      description: Company node ID (comp_...)
+      schema:
+        type: string
     get:
-      summary: List pickup locations
+      summary: Get a company node
       tags:
-      - Delivery
+      - Companies
       security:
       - api_key: []
-      description: Pickup-enabled stock locations for a pickup delivery method. Pass
-        cart_id to keep only locations that can fulfill the whole cart from local
-        stock.
+        bearer_auth: []
+      description: |
+        Returns one node of the buyer's organization. Requires standing — a membership on
+        the node or on one of its ancestors; any other node is not found rather than
+        refused, so its existence is not disclosed.
       x-codeSamples:
       - lang: javascript
         label: Spree SDK
@@ -10008,104 +10083,116 @@ paths:
             publishableKey: '<api-key>',
           })
 
-          const { data: pickupLocations } = await client.deliveryMethods.pickupLocations('dm_abc123', {
-            cart_id: 'cart_abc123',
-          })
+          const company = await client.companies.get('comp_86Rf07xd4z', { token: '<token>' })
       parameters:
       - name: x-spree-api-key
         in: header
         required: true
         schema:
           type: string
-      - name: id
-        in: path
+      - name: Authorization
+        in: header
         required: true
-        description: Delivery method prefixed ID
-        schema:
-          type: string
-      - name: cart_id
-        in: query
-        required: false
-        description: Cart prefixed ID for availability filtering
         schema:
           type: string
       responses:
         '200':
-          description: pickup locations found
+          description: company found
           content:
             application/json:
               example:
-                data:
-                - id: sloc_UkLWZg9DAJ
-                  name: Downtown
-                  address1: 1600 Pennsylvania Ave NW
-                  city: Washington
-                  zipcode: '20500'
-                  country_code: US
-                  country_name: United States
-                  state_code: AL
-                  state_text: AL
-                  pickup_ready_in_minutes:
-                  pickup_instructions:
-  "/api/v3/store/sellers":
-    get:
-      summary: List sellers
+                id: comp_UkLWZg9DAJ
+                name: Acme Industrial
+                kind: company
+                parent_id:
+                ancestors: []
+        '404':
+          description: no standing over this node
+          content:
+            application/json:
+              example:
+                error:
+                  code: record_not_found
+                  message: Company not found
+    patch:
+      summary: Update a company node
       tags:
-      - Sellers
+      - Companies
       security:
       - api_key: []
-      description: |
-        Returns the sellers on this marketplace that a shopper can currently
-        buy from. A seller still onboarding, suspended, or away on holiday is
-        not listed — showing them would advertise a seller whose products
-        cannot be bought.
-
-        The payload is the seller's public profile only. Nothing about how the
-        marketplace runs them — status, payout schedule, tax handling, contact
-        addresses — is exposed here.
+        bearer_auth: []
+      description: Renames the node. Structure — the parent and the kind — is managed
+        by the merchant, not by buyers.
       parameters:
       - name: x-spree-api-key
         in: header
         required: true
         schema:
           type: string
-      - name: page
-        in: query
-        required: false
-        schema:
-          type: integer
-      - name: limit
-        in: query
-        required: false
+      - name: Authorization
+        in: header
+        required: true
         schema:
-          type: integer
-      - name: q[name_cont]
-        in: query
-        required: false
-        description: Filter by name
+          type: string
+      responses:
+        '200':
+          description: company updated
+          content:
+            application/json:
+              example:
+                id: comp_UkLWZg9DAJ
+                name: Acme Industrial Group
+                kind: company
+                parent_id:
+                ancestors: []
+      requestBody:
+        content:
+          application/json:
+            schema:
+              type: object
+              properties:
+                name:
+                  type: string
+                  example: Acme Industrial Group
+  "/api/v3/store/companies/{company_id}/members":
+    parameters:
+    - name: company_id
+      in: path
+      required: true
+      description: Company node ID (comp_...)
+      schema:
+        type: string
+    get:
+      summary: List company members
+      tags:
+      - Companies
+      security:
+      - api_key: []
+        bearer_auth: []
+      description: The people with standing over this node. Within a company every
+        member may read and manage the directory.
+      parameters:
+      - name: x-spree-api-key
+        in: header
+        required: true
         schema:
           type: string
-      - name: fields
-        in: query
-        required: false
-        description: Comma-separated list of fields to include. id is always included.
+      - name: Authorization
+        in: header
+        required: true
         schema:
           type: string
       responses:
         '200':
-          description: sellers found
+          description: members listed
           content:
             application/json:
               example:
                 data:
-                - id: sel_UkLWZg9DAJ
-                  name: Sparks Audio
-                  slug: sparks-audio
-                  about: ''
-                  about_html: ''
-                  logo_url:
-                  square_logo_url:
-                  cover_photo_url:
+                - id: cmem_UkLWZg9DAJ
+                  company_id: comp_UkLWZg9DAJ
+                  customer_id: cust_UkLWZg9DAJ
+                  email: su_kuvalis@ward.biz
                 meta:
                   page: 1
                   limit: 25
@@ -10116,75 +10203,895 @@ paths:
                   in: 1
                   previous:
                   next:
-              schema:
-                type: object
-                properties:
-                  data:
-                    type: array
-                    items:
-                      "$ref": "#/components/schemas/Seller"
-                  meta:
-                    "$ref": "#/components/schemas/PaginationMeta"
-        '401':
-          description: unauthorized
-          content:
-            application/json:
-              example:
-                error:
-                  code: invalid_token
-                  message: Valid API key required
-              schema:
-                "$ref": "#/components/schemas/ErrorResponse"
-  "/api/v3/store/sellers/{id}":
-    get:
-      summary: Get a seller
+    post:
+      summary: Add a member by email
       tags:
-      - Sellers
+      - Companies
       security:
       - api_key: []
+        bearer_auth: []
       description: |
-        Returns a single seller's public profile, by slug or prefixed ID, so a
-        storefront can route `/sellers/sparks-audio` without holding an id.
+        Adds a person to the node by email. An email that already belongs to a customer of
+        this store becomes a membership immediately (a `cmem_...` id); any other email
+        becomes an invitation (a `cinv_...` id) and the invite email goes out.
+      x-codeSamples:
+      - lang: javascript
+        label: Spree SDK
+        source: |-
+          import { createClient } from '@spree/sdk'
 
-        A seller who cannot currently sell returns 404 rather than a profile.
+          const client = createClient({
+            baseUrl: 'https://your-store.com',
+            publishableKey: '<api-key>',
+          })
+
+          // An existing customer joins immediately (cmem_…); anyone else is emailed an
+          // invitation (cinv_…).
+          const member = await client.companies.members.create(
+            'comp_86Rf07xd4z',
+            { customer_email: 'colleague@acme.test' },
+            { token: '<token>' },
+          )
       parameters:
       - name: x-spree-api-key
         in: header
         required: true
         schema:
           type: string
-      - name: id
-        in: path
+      - name: Authorization
+        in: header
         required: true
-        description: Seller slug (e.g., sparks-audio) or prefixed ID (e.g., sel_abc123)
-        schema:
-          type: string
-      - name: fields
-        in: query
-        required: false
-        description: Comma-separated list of fields to include. id is always included.
         schema:
           type: string
       responses:
-        '200':
-          description: seller found by slug
+        '201':
+          description: member added or invitation sent
           content:
             application/json:
               example:
-                id: sel_UkLWZg9DAJ
-                name: Sparks Audio
-                slug: sparks-audio
-                about: ''
-                about_html: ''
-                logo_url:
-                square_logo_url:
-                cover_photo_url:
-              schema:
-                "$ref": "#/components/schemas/Seller"
-        '404':
-          description: seller not found
-          content:
-            application/json:
+                id: cmem_gbHJdmfrXB
+                company_id: comp_UkLWZg9DAJ
+                customer_id: cust_gbHJdmfrXB
+                email: colleague@acme.test
+      requestBody:
+        content:
+          application/json:
+            schema:
+              type: object
+              properties:
+                customer_email:
+                  type: string
+                  example: colleague@acme.test
+              required:
+              - customer_email
+  "/api/v3/store/companies/{company_id}/addresses":
+    parameters:
+    - name: company_id
+      in: path
+      required: true
+      description: Company node ID (comp_...)
+      schema:
+        type: string
+    get:
+      summary: List the company address book
+      tags:
+      - Companies
+      security:
+      - api_key: []
+        bearer_auth: []
+      description: The labeled ship-to and bill-to sites this node owns. A node with
+        no default of its own falls back to its nearest ancestor when prefilling checkout.
+      parameters:
+      - name: x-spree-api-key
+        in: header
+        required: true
+        schema:
+          type: string
+      - name: Authorization
+        in: header
+        required: true
+        schema:
+          type: string
+      responses:
+        '200':
+          description: addresses listed
+          content:
+            application/json:
+              example:
+                data:
+                - id: addr_EfhxLZ9ck8
+                  label: Headquarters
+                  first_name:
+                  last_name:
+                  full_name: ''
+                  address1: 159 Lovely Street
+                  address2: Northwest
+                  postal_code: '10118'
+                  city: New York
+                  phone: 555-555-0199
+                  company: Company
+                  country_name: United States
+                  country_code: US
+                  state_text: NY
+                  state_code: NY
+                  quick_checkout: false
+                  is_default_billing: false
+                  is_default_shipping: false
+                  state_abbr: NY
+                  country_iso: US
+                  state_name: New York
+                meta:
+                  page: 1
+                  limit: 25
+                  count: 1
+                  pages: 1
+                  from: 1
+                  to: 1
+                  in: 1
+                  previous:
+                  next:
+  "/api/v3/store/companies/{company_id}/addresses/{id}":
+    parameters:
+    - name: company_id
+      in: path
+      required: true
+      description: Company node ID (comp_...)
+      schema:
+        type: string
+    - name: id
+      in: path
+      required: true
+      description: Address ID (addr_...)
+      schema:
+        type: string
+    patch:
+      summary: Update an address book entry
+      tags:
+      - Companies
+      security:
+      - api_key: []
+        bearer_auth: []
+      description: Renames a site or moves the default ship-to or bill-to flag to
+        it. Only one entry per node holds each default.
+      parameters:
+      - name: x-spree-api-key
+        in: header
+        required: true
+        schema:
+          type: string
+      - name: Authorization
+        in: header
+        required: true
+        schema:
+          type: string
+      responses:
+        '200':
+          description: address book entry updated
+          content:
+            application/json:
+              example:
+                id: addr_EfhxLZ9ck8
+                label: Northern Warehouse
+                first_name:
+                last_name:
+                full_name: ''
+                address1: 162 Lovely Street
+                address2: Northwest
+                postal_code: '10118'
+                city: New York
+                phone: 555-555-0199
+                company: Company
+                country_name: United States
+                country_code: US
+                state_text: NY
+                state_code: NY
+                quick_checkout: false
+                is_default_billing: false
+                is_default_shipping: true
+                state_abbr: NY
+                country_iso: US
+                state_name: New York
+      requestBody:
+        content:
+          application/json:
+            schema:
+              type: object
+              properties:
+                label:
+                  type: string
+                  example: Northern Warehouse
+                default_shipping:
+                  type: boolean
+                  example: true
+    delete:
+      summary: Remove an address book entry
+      tags:
+      - Companies
+      security:
+      - api_key: []
+        bearer_auth: []
+      description: Takes the site out of the address book. Orders already placed to
+        it keep their own copy of the address.
+      parameters:
+      - name: x-spree-api-key
+        in: header
+        required: true
+        schema:
+          type: string
+      - name: Authorization
+        in: header
+        required: true
+        schema:
+          type: string
+      responses:
+        '204':
+          description: address book entry removed
+  "/api/v3/store/companies/{company_id}/invitations/{id}":
+    parameters:
+    - name: company_id
+      in: path
+      required: true
+      description: Company node ID (comp_...)
+      schema:
+        type: string
+    - name: id
+      in: path
+      required: true
+      description: Invitation ID (cinv_...)
+      schema:
+        type: string
+    delete:
+      summary: Revoke an invitation
+      tags:
+      - Companies
+      security:
+      - api_key: []
+        bearer_auth: []
+      description: Withdraws a pending invitation, spending its token. Any member
+        with standing over the node may revoke.
+      parameters:
+      - name: x-spree-api-key
+        in: header
+        required: true
+        schema:
+          type: string
+      - name: Authorization
+        in: header
+        required: true
+        schema:
+          type: string
+      responses:
+        '204':
+          description: invitation revoked
+  "/api/v3/store/companies/{company_id}/orders":
+    parameters:
+    - name: company_id
+      in: path
+      required: true
+      description: Company node ID (comp_...)
+      schema:
+        type: string
+    get:
+      summary: List the company purchases
+      tags:
+      - Companies
+      security:
+      - api_key: []
+        bearer_auth: []
+      description: Completed orders placed for this node and every node below it,
+        so a parent sees what its divisions bought.
+      parameters:
+      - name: x-spree-api-key
+        in: header
+        required: true
+        schema:
+          type: string
+      - name: Authorization
+        in: header
+        required: true
+        schema:
+          type: string
+      responses:
+        '200':
+          description: orders listed
+          content:
+            application/json:
+              example:
+                data:
+                - id: or_UkLWZg9DAJ
+                  market_id: mkt_UkLWZg9DAJ
+                  cart_id:
+                  channel_id: ch_UkLWZg9DAJ
+                  company_id: comp_UkLWZg9DAJ
+                  company_name: Acme Industrial
+                  number: R1001
+                  email: chanell_langosh@schamberger.info
+                  customer_note:
+                  currency: USD
+                  locale: en
+                  total_quantity: 1
+                  coupon_code:
+                  fulfillment_status:
+                  payment_status:
+                  completed_at: '2026-01-15T12:00:00.000Z'
+                  item_total: '10.0'
+                  display_item_total: "$10.00"
+                  adjustment_total: '0.0'
+                  display_adjustment_total: "$0.00"
+                  discount_total: '0.0'
+                  display_discount_total: "$0.00"
+                  tax_total: '0.0'
+                  display_tax_total: "$0.00"
+                  included_tax_total: '0.0'
+                  display_included_tax_total: "$0.00"
+                  additional_tax_total: '0.0'
+                  display_additional_tax_total: "$0.00"
+                  total: '110.0'
+                  display_total: "$110.00"
+                  gift_card_total: '0.0'
+                  display_gift_card_total: "$0.00"
+                  amount_due: '110.0'
+                  display_amount_due: "$110.00"
+                  delivery_total: '100.0'
+                  display_delivery_total: "$100.00"
+                  fee_total: '0.0'
+                  display_fee_total: "$0.00"
+                  store_credit_total: '0.0'
+                  display_store_credit_total: "$0.00"
+                  covered_by_store_credit: false
+                  discounts: []
+                  fees: []
+                  items:
+                  - id: li_UkLWZg9DAJ
+                    variant_id: variant_UkLWZg9DAJ
+                    seller_id:
+                    preorder: false
+                    preorder_ships_at:
+                    quantity: 1
+                    currency: USD
+                    name: Product 1585649
+                    slug: product-1585649
+                    options_text: ''
+                    price: '10.0'
+                    display_price: "$10.00"
+                    total: '10.0'
+                    display_total: "$10.00"
+                    adjustment_total: '0.0'
+                    display_adjustment_total: "$0.00"
+                    additional_tax_total: '0.0'
+                    display_additional_tax_total: "$0.00"
+                    included_tax_total: '0.0'
+                    display_included_tax_total: "$0.00"
+                    discount_total: '0.0'
+                    display_discount_total: "$0.00"
+                    pre_tax_amount: '10.0'
+                    display_pre_tax_amount: "$10.00"
+                    discounted_amount: '10.0'
+                    display_discounted_amount: "$10.00"
+                    display_compare_at_amount: "$0.00"
+                    compare_at_amount:
+                    thumbnail_url:
+                    option_values: []
+                    digital_links: []
+                  fulfillments:
+                  - id: ful_UkLWZg9DAJ
+                    number: R1001-F1
+                    tracking: U10000
+                    tracking_url:
+                    tracking_carrier:
+                    tracking_carrier_name:
+                    pickup_point_data:
+                    selected_delivery_rate_id: dr_gbHJdmfrXB
+                    cost: '100.0'
+                    display_cost: "$100.00"
+                    total: '100.0'
+                    display_total: "$100.00"
+                    discount_total: '0.0'
+                    display_discount_total: "$0.00"
+                    additional_tax_total: '0.0'
+                    display_additional_tax_total: "$0.00"
+                    included_tax_total: '0.0'
+                    display_included_tax_total: "$0.00"
+                    tax_total: '0.0'
+                    display_tax_total: "$0.00"
+                    status: unfulfilled
+                    fulfillment_type: shipping
+                    fulfilled_at:
+                    tracking_status:
+                    estimated_delivery_at:
+                    delivered_at:
+                    items:
+                    - item_id: li_UkLWZg9DAJ
+                      variant_id: variant_UkLWZg9DAJ
+                      quantity: 1
+                    delivery_method:
+                      id: dm_UkLWZg9DAJ
+                      name: UPS Ground
+                      code: UPS_GROUND
+                      estimated_transit_business_days_min:
+                      estimated_transit_business_days_max:
+                      digital: false
+                      pickup: false
+                      pickup_point: false
+                    stock_location:
+                      id: sloc_UkLWZg9DAJ
+                      name: Kali Pacocha
+                      address1: 1600 Pennsylvania Ave NW
+                      city: Washington
+                      zipcode: '20500'
+                      country_code: US
+                      country_name: United States
+                      state_code: AL
+                      state_text: AL
+                      pickup_ready_in_minutes:
+                      pickup_instructions:
+                    delivery_rates:
+                    - id: dr_gbHJdmfrXB
+                      delivery_method_id: dm_UkLWZg9DAJ
+                      name: UPS Ground
+                      selected: true
+                      cost: '10.0'
+                      total: '10.0'
+                      additional_tax_total: '0.0'
+                      included_tax_total: '0.0'
+                      tax_total: '0.0'
+                      carrier:
+                      service_level:
+                      estimated_delivery_date:
+                      display_cost: "$10.00"
+                      display_total: "$10.00"
+                      display_additional_tax_total: "$0.00"
+                      display_included_tax_total: "$0.00"
+                      display_tax_total: "$0.00"
+                      delivery_method:
+                        id: dm_UkLWZg9DAJ
+                        name: UPS Ground
+                        code: UPS_GROUND
+                        estimated_transit_business_days_min:
+                        estimated_transit_business_days_max:
+                        digital: false
+                        pickup: false
+                        pickup_point: false
+                  payments: []
+                  billing_address:
+                    id: addr_EfhxLZ9ck8
+                    label:
+                    first_name: John
+                    last_name: Doe
+                    full_name: John Doe
+                    address1: 170 Lovely Street
+                    address2: Northwest
+                    postal_code: '10118'
+                    city: New York
+                    phone: 555-555-0199
+                    company: Company
+                    country_name: United States
+                    country_code: US
+                    state_text: NY
+                    state_code: NY
+                    quick_checkout: false
+                    is_default_billing: false
+                    is_default_shipping: false
+                    state_abbr: NY
+                    country_iso: US
+                    state_name: New York
+                  shipping_address:
+                    id: addr_VqXmZF31wY
+                    label:
+                    first_name: John
+                    last_name: Doe
+                    full_name: John Doe
+                    address1: 171 Lovely Street
+                    address2: Northwest
+                    postal_code: '10118'
+                    city: New York
+                    phone: 555-555-0199
+                    company: Company
+                    country_name: United States
+                    country_code: US
+                    state_text: NY
+                    state_code: NY
+                    quick_checkout: false
+                    is_default_billing: false
+                    is_default_shipping: false
+                    state_abbr: NY
+                    country_iso: US
+                    state_name: New York
+                  gift_card:
+                  market:
+                    id: mkt_UkLWZg9DAJ
+                    name: United States
+                    currency: USD
+                    default_locale: en
+                    tax_inclusive: false
+                    default: true
+                    country_codes:
+                    - US
+                    supported_locales:
+                    - en
+                meta:
+                  page: 1
+                  limit: 25
+                  count: 1
+                  pages: 1
+                  from: 1
+                  to: 1
+                  in: 1
+                  previous:
+                  next:
+  "/api/v3/store/company_invitations/{token}":
+    parameters:
+    - name: token
+      in: path
+      required: true
+      description: Plaintext invitation token from the invite email
+      schema:
+        type: string
+    get:
+      summary: Look up an invitation
+      tags:
+      - Companies
+      security:
+      - api_key: []
+      description: |
+        Shows what is being joined, so the acceptance page can render before the invitee
+        has an account. Deliberately unauthenticated — the token from the email is the
+        credential. Spent, revoked and expired tokens are not found.
+      parameters:
+      - name: x-spree-api-key
+        in: header
+        required: true
+        schema:
+          type: string
+      responses:
+        '200':
+          description: invitation found
+          content:
+            application/json:
+              example:
+                id: cinv_UkLWZg9DAJ
+                email: new@acme.test
+                expires_at: '2026-02-14T12:00:00.000Z'
+                company_id: comp_UkLWZg9DAJ
+                status: pending
+                company_name: Acme Industrial
+                store_name: Spree Test Store
+        '404':
+          description: token spent, revoked or expired
+          content:
+            application/json:
+              example:
+                error:
+                  code: record_not_found
+                  message: Company invitation not found
+  "/api/v3/store/company_invitations/{token}/accept":
+    parameters:
+    - name: token
+      in: path
+      required: true
+      description: Plaintext invitation token from the invite email
+      schema:
+        type: string
+    post:
+      summary: Accept an invitation
+      tags:
+      - Companies
+      security:
+      - api_key: []
+      description: |
+        Turns the invitation into a membership. Send a registration payload to create the
+        account — it is always created with the invited email — or call it authenticated as
+        the customer who owns that email to bind the invitation to the existing account.
+      x-codeSamples:
+      - lang: javascript
+        label: Spree SDK
+        source: |-
+          import { createClient } from '@spree/sdk'
+
+          const client = createClient({
+            baseUrl: 'https://your-store.com',
+            publishableKey: '<api-key>',
+          })
+
+          // Unauthenticated: the token from the invite email is the credential, and the
+          // registration payload creates the account with the invited address.
+          const membership = await client.companyInvitations.accept('<invitation-token>', {
+            first_name: 'Ada',
+            password: 'a-strong-password',
+            password_confirmation: 'a-strong-password',
+          })
+      parameters:
+      - name: x-spree-api-key
+        in: header
+        required: true
+        schema:
+          type: string
+      responses:
+        '201':
+          description: membership created
+          content:
+            application/json:
+              example:
+                id: cmem_UkLWZg9DAJ
+                company_id: comp_UkLWZg9DAJ
+                customer_id: cust_UkLWZg9DAJ
+                email: new@acme.test
+      requestBody:
+        content:
+          application/json:
+            schema:
+              type: object
+              properties:
+                first_name:
+                  type: string
+                  example: Ada
+                last_name:
+                  type: string
+                  example: Lovelace
+                password:
+                  type: string
+                  example: a-strong-password
+                password_confirmation:
+                  type: string
+                  example: a-strong-password
+  "/api/v3/store/delivery_methods":
+    get:
+      summary: List delivery methods
+      tags:
+      - Delivery
+      security:
+      - api_key: []
+      description: Storefront-visible delivery methods. Filter by fulfillment_type
+        to discover pickup options.
+      x-codeSamples:
+      - lang: javascript
+        label: Spree SDK
+        source: |-
+          import { createClient } from '@spree/sdk'
+
+          const client = createClient({
+            baseUrl: 'https://your-store.com',
+            publishableKey: '<api-key>',
+          })
+
+          const { data: pickupMethods } = await client.deliveryMethods.list({
+            fulfillment_type: 'pickup',
+          })
+      parameters:
+      - name: x-spree-api-key
+        in: header
+        required: true
+        schema:
+          type: string
+      - name: fulfillment_type
+        in: query
+        required: false
+        description: 'Filter: shipping, digital, pickup'
+        schema:
+          type: string
+      responses:
+        '200':
+          description: delivery methods found
+          content:
+            application/json:
+              example:
+                data:
+                - id: dm_gbHJdmfrXB
+                  name: Store pickup
+                  code: PICKUP
+                  estimated_transit_business_days_min:
+                  estimated_transit_business_days_max:
+                  digital: false
+                  pickup: true
+                  pickup_point: false
+                meta:
+                  page: 1
+                  limit: 25
+                  count: 1
+                  pages: 1
+                  from: 1
+                  to: 1
+                  in: 1
+                  previous:
+                  next:
+  "/api/v3/store/delivery_methods/{id}/pickup_locations":
+    get:
+      summary: List pickup locations
+      tags:
+      - Delivery
+      security:
+      - api_key: []
+      description: Pickup-enabled stock locations for a pickup delivery method. Pass
+        cart_id to keep only locations that can fulfill the whole cart from local
+        stock.
+      x-codeSamples:
+      - lang: javascript
+        label: Spree SDK
+        source: |-
+          import { createClient } from '@spree/sdk'
+
+          const client = createClient({
+            baseUrl: 'https://your-store.com',
+            publishableKey: '<api-key>',
+          })
+
+          const { data: pickupLocations } = await client.deliveryMethods.pickupLocations('dm_abc123', {
+            cart_id: 'cart_abc123',
+          })
+      parameters:
+      - name: x-spree-api-key
+        in: header
+        required: true
+        schema:
+          type: string
+      - name: id
+        in: path
+        required: true
+        description: Delivery method prefixed ID
+        schema:
+          type: string
+      - name: cart_id
+        in: query
+        required: false
+        description: Cart prefixed ID for availability filtering
+        schema:
+          type: string
+      responses:
+        '200':
+          description: pickup locations found
+          content:
+            application/json:
+              example:
+                data:
+                - id: sloc_UkLWZg9DAJ
+                  name: Downtown
+                  address1: 1600 Pennsylvania Ave NW
+                  city: Washington
+                  zipcode: '20500'
+                  country_code: US
+                  country_name: United States
+                  state_code: AL
+                  state_text: AL
+                  pickup_ready_in_minutes:
+                  pickup_instructions:
+  "/api/v3/store/sellers":
+    get:
+      summary: List sellers
+      tags:
+      - Sellers
+      security:
+      - api_key: []
+      description: |
+        Returns the sellers on this marketplace that a shopper can currently
+        buy from. A seller still onboarding, suspended, or away on holiday is
+        not listed — showing them would advertise a seller whose products
+        cannot be bought.
+
+        The payload is the seller's public profile only. Nothing about how the
+        marketplace runs them — status, payout schedule, tax handling, contact
+        addresses — is exposed here.
+      parameters:
+      - name: x-spree-api-key
+        in: header
+        required: true
+        schema:
+          type: string
+      - name: page
+        in: query
+        required: false
+        schema:
+          type: integer
+      - name: limit
+        in: query
+        required: false
+        schema:
+          type: integer
+      - name: q[name_cont]
+        in: query
+        required: false
+        description: Filter by name
+        schema:
+          type: string
+      - name: fields
+        in: query
+        required: false
+        description: Comma-separated list of fields to include. id is always included.
+        schema:
+          type: string
+      responses:
+        '200':
+          description: sellers found
+          content:
+            application/json:
+              example:
+                data:
+                - id: sel_UkLWZg9DAJ
+                  name: Sparks Audio
+                  slug: sparks-audio
+                  about: ''
+                  about_html: ''
+                  logo_url:
+                  square_logo_url:
+                  cover_photo_url:
+                meta:
+                  page: 1
+                  limit: 25
+                  count: 1
+                  pages: 1
+                  from: 1
+                  to: 1
+                  in: 1
+                  previous:
+                  next:
+              schema:
+                type: object
+                properties:
+                  data:
+                    type: array
+                    items:
+                      "$ref": "#/components/schemas/Seller"
+                  meta:
+                    "$ref": "#/components/schemas/PaginationMeta"
+        '401':
+          description: unauthorized
+          content:
+            application/json:
+              example:
+                error:
+                  code: invalid_token
+                  message: Valid API key required
+              schema:
+                "$ref": "#/components/schemas/ErrorResponse"
+  "/api/v3/store/sellers/{id}":
+    get:
+      summary: Get a seller
+      tags:
+      - Sellers
+      security:
+      - api_key: []
+      description: |
+        Returns a single seller's public profile, by slug or prefixed ID, so a
+        storefront can route `/sellers/sparks-audio` without holding an id.
+
+        A seller who cannot currently sell returns 404 rather than a profile.
+      parameters:
+      - name: x-spree-api-key
+        in: header
+        required: true
+        schema:
+          type: string
+      - name: id
+        in: path
+        required: true
+        description: Seller slug (e.g., sparks-audio) or prefixed ID (e.g., sel_abc123)
+        schema:
+          type: string
+      - name: fields
+        in: query
+        required: false
+        description: Comma-separated list of fields to include. id is always included.
+        schema:
+          type: string
+      responses:
+        '200':
+          description: seller found by slug
+          content:
+            application/json:
+              example:
+                id: sel_UkLWZg9DAJ
+                name: Sparks Audio
+                slug: sparks-audio
+                about: ''
+                about_html: ''
+                logo_url:
+                square_logo_url:
+                cover_photo_url:
+              schema:
+                "$ref": "#/components/schemas/Seller"
+        '404':
+          description: seller not found
+          content:
+            application/json:
               example:
                 error:
                   code: record_not_found
@@ -10557,6 +11464,9 @@ components:
       properties:
         id:
           type: string
+        label:
+          type: string
+          nullable: true
         first_name:
           type: string
           nullable: true
@@ -10609,6 +11519,7 @@ components:
           nullable: true
       required:
       - id
+      - label
       - first_name
       - last_name
       - full_name
@@ -10681,6 +11592,12 @@ components:
         preferred_stock_location_id:
           type: string
           nullable: true
+        company_id:
+          type: string
+          nullable: true
+        company_name:
+          type: string
+          nullable: true
         number:
           type: string
         token:
@@ -10836,6 +11753,8 @@ components:
       - market_id
       - channel_id
       - preferred_stock_location_id
+      - company_id
+      - company_name
       - number
       - token
       - email
@@ -11149,6 +12068,66 @@ components:
       - image_url
       - square_image_url
       x-typelizer: true
+    CompanyInvitation:
+      type: object
+      properties:
+        id:
+          type: string
+        email:
+          type: string
+        expires_at:
+          type: string
+          nullable: true
+        company_id:
+          type: string
+        status:
+          type: string
+      required:
+      - id
+      - email
+      - expires_at
+      - company_id
+      - status
+      x-typelizer: true
+    CompanyMembership:
+      type: object
+      properties:
+        id:
+          type: string
+        company_id:
+          type: string
+        customer_id:
+          type: string
+        email:
+          type: string
+          nullable: true
+      required:
+      - id
+      - company_id
+      - customer_id
+      - email
+      x-typelizer: true
+    Company:
+      type: object
+      properties:
+        id:
+          type: string
+        name:
+          type: string
+        kind:
+          type: string
+        parent_id:
+          type: string
+          nullable: true
+        ancestors:
+          type: object
+      required:
+      - id
+      - name
+      - kind
+      - parent_id
+      - ancestors
+      x-typelizer: true
     Country:
       type: object
       properties:
@@ -12330,6 +13309,12 @@ components:
         channel_id:
           type: string
           nullable: true
+        company_id:
+          type: string
+          nullable: true
+        company_name:
+          type: string
+          nullable: true
         number:
           type: string
         email:
@@ -12471,6 +13456,8 @@ components:
       - market_id
       - cart_id
       - channel_id
+      - company_id
+      - company_name
       - number
       - email
       - customer_note