API Controller: `api/v1/sellers`

Generated from OpenclawSellercentralApiRegistry. Run bin/rails sellercentral_api_docs:sync after API updates.

Endpoints

`GET /api/v1/sellers`

Returns all sellers this key’s user can access and marks the seller tied to the current key.

Query Options

None.

Request Examples

List sellers in the authenticated user’s scope

curl -s \
  -H "Authorization: Bearer oc_sk_your_key_here" \
  https://app.shipmentbot.com/api/v1/sellers

Response Examples

Success (`200`)

{
  "sellers": [
    {
      "name": "alpha seller",
      "current": true,
      "key_generated": "2026-03-04T10:32:12Z",
      "link": "https://app.shipmentbot.com/businesses/101-alpha-seller"
    },
    {
      "name": "bravo seller",
      "current": false,
      "key_generated": false,
      "link": "https://app.shipmentbot.com/businesses/102-bravo-seller"
    }
  ]
}

Error Examples

Missing access token (`401`)

{
  "error": "Unauthorized",
  "message": "Missing access token"
}

Invalid or expired token (`401`)

{
  "error": "Unauthorized",
  "message": "Invalid or expired access token"
}

API Controller: api/v1/sellers