Bootic Sellers API
Seller entities — the business layer between an account and its shops. An account can have multiple sellers, each owning one or more shops and their product catalog.
Seller entities — the business layer between an account and its shops. An account can have multiple sellers, each owning one or more shops and their product catalog.
Every API here is available over the APIs.io API and to AI agents over MCP.
One button, every client — Claude, Cursor, VS Code and the rest.
https://apis.io/mcp
find_apisBrowse and filter every API in the catalog.get_api_artifactsOne API's artifacts, grouped by type.get_openapiThe primary OpenAPI for this API.find_similar_apisAPIs that look like this one.apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.resolveTurn a domain, URL or GitHub org into the provider it belongs to.find_cohortsEvery scored population of providers in the catalog.curl "https://apis.io/api/v1/apis/bootic-sellers-api"
curl "https://apis.io/api/v1/apis?limit=25"
Discovery needs no key. Ratings and market analysis are Pro.
Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.
A second provider on the same verified email joins the account you already have.
openapi: 3.2.0
info:
title: Bolder API v2 Sellers API
version: '2.0'
description: '## Getting Started
The Bolder API provides programmatic access to your Bolder Shop data through a
hypermedia-driven REST interface.'
contact:
name: Bolder API Support
url: https://www.onbolder.com
servers:
- url: https://api.onbolder.com/v2
description: Production
security:
- bearerAuth: []
tags:
- name: Sellers
description: 'Seller entities — the business layer between an account and its shops.
An account can have multiple sellers, each owning one or more shops and their product catalog.'
paths:
/sellers:
get:
tags:
- Sellers
summary: List sellers
description: 'Returns all sellers belonging to the authenticated account.
Results are automatically scoped to the account associated with the token.'
operationId: listSellers
x-codeSamples:
- lang: Shell
label: cURL
source: "curl -s -H \"Authorization: Bearer $BOLDER_TOKEN\" \\\n \"https://api.onbolder.com/v2/sellers\"\n"
responses:
'200':
description: List of sellers
content:
application/json:
schema:
$ref: '#/components/schemas/SellerList'
example:
_class:
- results
- sellers
total_items: 1
_links:
self:
href: https://api.onbolder.com/v2/sellers
_embedded:
items:
- id: 5
account_id: 10
locale: en
currency_code: USD
provides_shipping: true
provides_pickup: true
prices_include_tax: true
tax_rate: 0.19
tax_name: VAT
products_count: 42
created_on: '2023-01-15T10:00:00Z'
updated_on: '2024-03-20T14:30:00Z'
_links:
self:
href: https://api.onbolder.com/v2/sellers/5
shops:show:
href: https://api.onbolder.com/v2/shops/1
shops:list:
href: https://api.onbolder.com/v2/shops?seller_id=5
products:list:
href: https://api.onbolder.com/v2/products{?seller_ids,...}
templated: true
'401':
description: Invalid or missing token
'403':
description: Access denied
/sellers/{id}:
get:
tags:
- Sellers
summary: Get a seller
description: Returns a single seller by ID. Sellers are account-scoped.
operationId: getSeller
x-codeSamples:
- lang: Shell
label: cURL
source: "curl -s -H \"Authorization: Bearer $BOLDER_TOKEN\" \\\n \"https://api.onbolder.com/v2/sellers/5\"\n"
parameters:
- name: id
in: path
required: true
schema:
type: integer
description: Seller ID
example: 5
responses:
'200':
description: Seller entity
content:
application/json:
schema:
$ref: '#/components/schemas/Seller'
example:
id: 5
account_id: 10
locale: en
currency_code: USD
provides_shipping: true
provides_pickup: true
prices_include_tax: true
tax_rate: 0.19
tax_name: VAT
products_count: 42
created_on: '2023-01-15T10:00:00Z'
updated_on: '2024-03-20T14:30:00Z'
_links:
self:
href: https://api.onbolder.com/v2/sellers/5
shops:show:
href: https://api.onbolder.com/v2/shops/1
title: Main shop
shops:list:
href: https://api.onbolder.com/v2/shops?seller_id=5
title: All shops owned by this seller
products:list:
href: https://api.onbolder.com/v2/products{?seller_ids,...}
templated: true
'401':
description: Invalid or missing token
'403':
description: Access denied
'404':
description: Seller not found
components:
schemas:
Seller:
type: object
description: 'A seller may own more than one shop. Use the `shops:list` link (`GET /v2/shops?seller_id={id}`) to enumerate all shops owned by the seller.
'
properties:
_links:
$ref: '#/components/schemas/HalLinks'
id:
type: integer
account_id:
type: integer
locale:
type: string
example: en
currency_code:
type: string
example: USD
provides_shipping:
type: boolean
provides_pickup:
type: boolean
prices_include_tax:
type: boolean
tax_rate:
type: number
example: 0.19
tax_name:
type: string
example: VAT
products_count:
type: integer
created_on:
type: string
format: date-time
updated_on:
type: string
format: date-time
SellerList:
allOf:
- $ref: '#/components/schemas/Pagination'
- type: object
properties:
_links:
$ref: '#/components/schemas/HalLinks'
_class:
type: array
items:
type: string
example:
- results
- sellers
_embedded:
type: object
properties:
items:
type: array
items:
$ref: '#/components/schemas/Seller'
Pagination:
type: object
properties:
total_items:
type: integer
example: 42
per_page:
type: integer
example: 20
page:
type: integer
example: 1
HalLinks:
type: object
additionalProperties:
oneOf:
- $ref: '#/components/schemas/HalLink'
- type: array
items:
$ref: '#/components/schemas/HalLink'
HalLink:
type: object
required:
- href
properties:
href:
type: string
templated:
type: boolean
method:
type: string
enum:
- get
- post
- put
- patch
- delete
title:
type: string
type:
type: string
securitySchemes:
bearerAuth:
type: http
scheme: bearer
bearerFormat: JWT
oauth2:
type: oauth2
flows:
clientCredentials:
tokenUrl: https://auth.onbolder.com/oauth/token
scopes:
products.read: View products, variants and collections
products.write: Create and update products
orders.read: View orders
orders.write: Create and update orders
customers.read: View customer profiles
customers.write: Update customer profiles
shops.read: View shop configuration
shops.write: Update shop configuration
hub.read: View content (posts, pages)
hub.write: Create and update content
store.read: View themes and assets
store.write: Manage themes and assets
sellers.read: View seller information
batches.read: View batch job status
batches.write: Create and run batch jobs
authorizationCode:
authorizationUrl: https://auth.onbolder.com/oauth/authorize
tokenUrl: https://auth.onbolder.com/oauth/token
scopes:
products.read: View products, variants and collections
products.write: Create and update products
orders.read: View orders
orders.write: Create and update orders
customers.read: View customer profiles
customers.write: Update customer profiles
shops.read: View shop configuration
shops.write: Update shop configuration
hub.read: View content (posts, pages)
hub.write: Create and update content
store.read: View themes and assets
store.write: Manage themes and assets
sellers.read: View seller information
batches.read: View batch job status
batches.write: Create and run batch jobs