Bootic Root API
API entry point — embeds sellers, shops, and navigation links to every resource
API entry point — embeds sellers, shops, and navigation links to every resource
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-root-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 Root 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: Root
description: API entry point — embeds sellers, shops, and navigation links to every resource
paths:
/:
get:
tags:
- Root
summary: API root
description: 'Returns the API entry point. Embeds the authenticated account''s shops and
provides navigation links (`_links`) to all v2 resources.
The `products:list` link is a URI template — expand it with search
parameters to list products.'
operationId: getRoot
x-codeSamples:
- lang: Shell
label: cURL
source: "curl -s -H \"Authorization: Bearer $BOLDER_TOKEN\" \\\n \"https://api.onbolder.com/v2\"\n"
responses:
'200':
description: API root entity
content:
application/json:
schema:
$ref: '#/components/schemas/Root'
example:
_class:
- root
account_id: 10
account_status: active
uid: 42
email: admin@myshop.com
user_name: admin
provider: bolder
scopes: products.read,orders.read,orders.write
_links:
curies:
- name: sellers
href: https://api.onbolder.com/docs/v2#sellers:{rel}
templated: true
- name: products
href: https://api.onbolder.com/docs/v2#products:{rel}
templated: true
- name: shops
href: https://api.onbolder.com/docs/v2#shops:{rel}
templated: true
- name: orders
href: https://api.onbolder.com/docs/v2#orders:{rel}
templated: true
- name: customers
href: https://api.onbolder.com/docs/v2#customers:{rel}
templated: true
self:
href: https://api.onbolder.com/v2
sellers:list:
href: https://api.onbolder.com/v2/sellers
sellers:show:
href: https://api.onbolder.com/v2/sellers/{id}
templated: true
products:list:
href: https://api.onbolder.com/v2/products{?q,status,page,per_page,...}
templated: true
orders:list:
href: https://api.onbolder.com/v2/orders{?shop_id,status,page,...}
templated: true
customers:list:
href: https://api.onbolder.com/v2/customers{?shop_id,q,page,...}
templated: true
_embedded:
sellers:
- id: 5
account_id: 10
locale: en
currency_code: USD
products_count: 42
_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
shops:
- id: 1
name: My Shop
subdomain: myshop
url: myshop.onbolder.com
status: active
'401':
description: Invalid or missing token
'403':
description: Access denied
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
Shop:
type: object
properties:
_links:
$ref: '#/components/schemas/HalLinks'
id:
type: integer
seller_id:
type: integer
account_id:
type: integer
name:
type: string
subdomain:
type: string
url:
type: string
description:
type: string
locale:
type: string
currency_code:
type: string
timezone:
type: string
asset_count:
type: integer
product_counts:
type: object
properties:
visible:
type: integer
blocked:
type: integer
hidden:
type: integer
products_use_variant_prices:
type: boolean
created_on:
type: string
format: date-time
updated_on:
type: string
format: date-time
HalLinks:
type: object
additionalProperties:
oneOf:
- $ref: '#/components/schemas/HalLink'
- type: array
items:
$ref: '#/components/schemas/HalLink'
Root:
type: object
properties:
_links:
$ref: '#/components/schemas/HalLinks'
_class:
type: array
items:
type: string
example:
- root
account_id:
type: integer
account_status:
type: string
example: active
uid:
type: integer
description: User ID (absent for client_credentials tokens)
email:
type: string
user_name:
type: string
provider:
type: string
example: bootic
scopes:
type: string
example: products.read,orders.read,orders.write
_embedded:
type: object
properties:
sellers:
type: array
items:
$ref: '#/components/schemas/Seller'
shops:
type: array
items:
$ref: '#/components/schemas/Shop'
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