Bootic Root API

API entry point — embeds sellers, shops, and navigation links to every resource

Operations 1

GET / API root #

Work with this as data

Every API here is available over the APIs.io API and to AI agents over MCP.

MCP server

One button, every client — Claude, Cursor, VS Code and the rest.

https://apis.io/mcp

Tools for apis

7 MCP tools reach this
  • 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.
All 92 tools →

Call it yourself

curl for this page
This API
curl "https://apis.io/api/v1/apis/bootic-root-api"
All apis
curl "https://apis.io/api/v1/apis?limit=25"

Discovery needs no key. Ratings and market analysis are Pro.

Get an API key

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 Specification

bootic-root-api-openapi.yml Raw ↑
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