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:bootic-collections-api"

All apis

curl "https://apis.io/api/v1/apis?limit=25"

Calls without X-API-Key need no key. Calls with it need a paid plan — get a key.

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.

GitHub Google LinkedIn

A second provider on the same verified email joins the account you already have.

OpenAPI Specification

openapi: 3.2.0
info:
  title: Bolder API v2 Collections 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: Collections
  description: 'Curated product collections (manually or rule-based). Products can belong to

    multiple collections.'
paths:
  /collections:
    get:
      tags:
      - Collections
      summary: List collections
      description: Returns collections for a shop. `shop_id` is required.
      operationId: listCollections
      parameters:
      - name: shop_id
        in: query
        required: true
        schema:
          type: integer
        description: ID of the shop whose collections to list.
        example: 1
      - name: page
        in: query
        schema:
          type: integer
          default: 1
        example: 1
      - name: per_page
        in: query
        schema:
          type: integer
          default: 20
        example: 20
      responses:
        '200':
          description: Paginated collections list
          content:
            application/json:
              example:
                _class:
                - results
                - collections
                total_items: 2
                per_page: 20
                page: 1
                _embedded:
                  items:
                  - id: 5
                    title: Summer Collection
                    slug: summer
                    _links:
                      self:
                        href: https://api.onbolder.com/v2/collections/5
  /collections/{id}:
    parameters:
    - name: id
      in: path
      required: true
      schema:
        type: integer
      description: Collection ID
      example: 5
    get:
      tags:
      - Collections
      summary: Get a collection
      responses:
        '200':
          description: Collection details
          content:
            application/json:
              example:
                id: 5
                title: Summer Collection
                slug: summer
      operationId: getCollectionsById
      x-operation-id-source: derived
    delete:
      tags:
      - Collections
      summary: Delete a collection
      description: Requires `products.write` scope on the collection's seller.
      operationId: deleteCollection
      responses:
        '204':
          description: Collection deleted
        '403':
          description: Access denied
components:
  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