{
  "info": {
    "name": "Bold Commerce API",
    "description": "Modular e-commerce APIs for subscriptions, headless checkout, and pricing, plus supporting Products, Customers, and Shops APIs. Base URL: https://api.boldcommerce.com. Authenticate with a Bearer token - an OAuth 2.0 access token (public integrations) or a scoped API access token (private integrations). Most paths are scoped to a shop_identifier GUID retrieved from the Shops API.",
    "schema": "https://schema.getpostman.com/json/collection/v2.1.0/collection.json"
  },
  "auth": {
    "type": "bearer",
    "bearer": [
      { "key": "token", "value": "{{apiToken}}", "type": "string" }
    ]
  },
  "variable": [
    { "key": "baseUrl", "value": "https://api.boldcommerce.com", "type": "string" },
    { "key": "apiToken", "value": "", "type": "string" },
    { "key": "shop_identifier", "value": "", "type": "string" },
    { "key": "shop_id", "value": "", "type": "string" }
  ],
  "item": [
    {
      "name": "Subscriptions",
      "item": [
        {
          "name": "List subscriptions",
          "request": {
            "method": "GET",
            "header": [],
            "url": { "raw": "{{baseUrl}}/subscriptions/v1/shops/{{shop_identifier}}/subscriptions", "host": ["{{baseUrl}}"], "path": ["subscriptions", "v1", "shops", "{{shop_identifier}}", "subscriptions"] },
            "description": "Retrieve a list of subscriptions for the shop."
          }
        },
        {
          "name": "Create a subscription",
          "request": {
            "method": "POST",
            "header": [{ "key": "Content-Type", "value": "application/json" }],
            "body": { "mode": "raw", "raw": "{\n  \"customer_id\": 0,\n  \"interval_id\": 0,\n  \"line_items\": []\n}" },
            "url": { "raw": "{{baseUrl}}/subscriptions/v1/shops/{{shop_identifier}}/subscriptions", "host": ["{{baseUrl}}"], "path": ["subscriptions", "v1", "shops", "{{shop_identifier}}", "subscriptions"] },
            "description": "Create a new subscription."
          }
        },
        {
          "name": "Retrieve a subscription",
          "request": {
            "method": "GET",
            "header": [],
            "url": { "raw": "{{baseUrl}}/subscriptions/v1/shops/{{shop_identifier}}/subscriptions/:subscription_id", "host": ["{{baseUrl}}"], "path": ["subscriptions", "v1", "shops", "{{shop_identifier}}", "subscriptions", ":subscription_id"], "variable": [{ "key": "subscription_id", "value": "" }] },
            "description": "Fetch an individual subscription."
          }
        },
        {
          "name": "Pause a subscription",
          "request": {
            "method": "POST",
            "header": [],
            "url": { "raw": "{{baseUrl}}/subscriptions/v1/shops/{{shop_identifier}}/subscriptions/:subscription_id/pause", "host": ["{{baseUrl}}"], "path": ["subscriptions", "v1", "shops", "{{shop_identifier}}", "subscriptions", ":subscription_id", "pause"], "variable": [{ "key": "subscription_id", "value": "" }] },
            "description": "Pause subscription processing."
          }
        },
        {
          "name": "Cancel a subscription",
          "request": {
            "method": "POST",
            "header": [],
            "url": { "raw": "{{baseUrl}}/subscriptions/v1/shops/{{shop_identifier}}/subscriptions/:subscription_id/cancel", "host": ["{{baseUrl}}"], "path": ["subscriptions", "v1", "shops", "{{shop_identifier}}", "subscriptions", ":subscription_id", "cancel"], "variable": [{ "key": "subscription_id", "value": "" }] },
            "description": "Cancel an active subscription."
          }
        },
        {
          "name": "Reactivate a subscription",
          "request": {
            "method": "POST",
            "header": [],
            "url": { "raw": "{{baseUrl}}/subscriptions/v1/shops/{{shop_identifier}}/subscriptions/:subscription_id/activate", "host": ["{{baseUrl}}"], "path": ["subscriptions", "v1", "shops", "{{shop_identifier}}", "subscriptions", ":subscription_id", "activate"], "variable": [{ "key": "subscription_id", "value": "" }] },
            "description": "Reactivate an inactive or cancelled subscription."
          }
        },
        {
          "name": "List subscription orders",
          "request": {
            "method": "GET",
            "header": [],
            "url": { "raw": "{{baseUrl}}/subscriptions/v1/shops/{{shop_identifier}}/subscriptions/:subscription_id/orders", "host": ["{{baseUrl}}"], "path": ["subscriptions", "v1", "shops", "{{shop_identifier}}", "subscriptions", ":subscription_id", "orders"], "variable": [{ "key": "subscription_id", "value": "" }] },
            "description": "List the orders for a subscription."
          }
        }
      ]
    },
    {
      "name": "Checkout",
      "item": [
        {
          "name": "Set shipping address",
          "request": {
            "method": "POST",
            "header": [{ "key": "Content-Type", "value": "application/json" }],
            "body": { "mode": "raw", "raw": "{\n  \"first_name\": \"Jane\",\n  \"last_name\": \"Doe\",\n  \"address1\": \"123 Main St\",\n  \"city\": \"Winnipeg\",\n  \"country\": \"CA\",\n  \"postal_code\": \"R3C\"\n}" },
            "url": { "raw": "{{baseUrl}}/checkout/storefront/{{shop_id}}/:order_id/addresses/shipping", "host": ["{{baseUrl}}"], "path": ["checkout", "storefront", "{{shop_id}}", ":order_id", "addresses", "shipping"], "variable": [{ "key": "order_id", "value": "" }] },
            "description": "Sets the shipping address on the order."
          }
        },
        {
          "name": "Set billing address",
          "request": {
            "method": "POST",
            "header": [{ "key": "Content-Type", "value": "application/json" }],
            "body": { "mode": "raw", "raw": "{\n  \"first_name\": \"Jane\",\n  \"last_name\": \"Doe\",\n  \"address1\": \"123 Main St\",\n  \"city\": \"Winnipeg\",\n  \"country\": \"CA\",\n  \"postal_code\": \"R3C\"\n}" },
            "url": { "raw": "{{baseUrl}}/checkout/storefront/{{shop_id}}/:order_id/addresses/billing", "host": ["{{baseUrl}}"], "path": ["checkout", "storefront", "{{shop_id}}", ":order_id", "addresses", "billing"], "variable": [{ "key": "order_id", "value": "" }] },
            "description": "Sets the billing address on the order."
          }
        },
        {
          "name": "Add line items",
          "request": {
            "method": "POST",
            "header": [{ "key": "Content-Type", "value": "application/json" }],
            "body": { "mode": "raw", "raw": "{\n  \"line_items\": []\n}" },
            "url": { "raw": "{{baseUrl}}/checkout/storefront/{{shop_id}}/:order_id/line_items", "host": ["{{baseUrl}}"], "path": ["checkout", "storefront", "{{shop_id}}", ":order_id", "line_items"], "variable": [{ "key": "order_id", "value": "" }] },
            "description": "Add line items to the order."
          }
        },
        {
          "name": "Add payment",
          "request": {
            "method": "POST",
            "header": [{ "key": "Content-Type", "value": "application/json" }],
            "body": { "mode": "raw", "raw": "{\n  \"token\": \"\",\n  \"amount\": 0\n}" },
            "url": { "raw": "{{baseUrl}}/checkout/storefront/{{shop_id}}/:order_id/payments", "host": ["{{baseUrl}}"], "path": ["checkout", "storefront", "{{shop_id}}", ":order_id", "payments"], "variable": [{ "key": "order_id", "value": "" }] },
            "description": "Add a payment to the order."
          }
        }
      ]
    },
    {
      "name": "Price Rules",
      "item": [
        {
          "name": "List rulesets",
          "request": {
            "method": "GET",
            "header": [],
            "url": { "raw": "{{baseUrl}}/price_rules/rules/v2/shops/{{shop_identifier}}/rulesets", "host": ["{{baseUrl}}"], "path": ["price_rules", "rules", "v2", "shops", "{{shop_identifier}}", "rulesets"] },
            "description": "List all rulesets available for the specified shop."
          }
        },
        {
          "name": "Create a ruleset",
          "request": {
            "method": "POST",
            "header": [{ "key": "Content-Type", "value": "application/json" }],
            "body": { "mode": "raw", "raw": "{\n  \"name\": \"Spring Sale\",\n  \"active\": true,\n  \"rules\": []\n}" },
            "url": { "raw": "{{baseUrl}}/price_rules/rules/v2/shops/{{shop_identifier}}/rulesets", "host": ["{{baseUrl}}"], "path": ["price_rules", "rules", "v2", "shops", "{{shop_identifier}}", "rulesets"] },
            "description": "Create a new ruleset. Requires the write_price_rulesets scope."
          }
        },
        {
          "name": "Process final price",
          "request": {
            "method": "POST",
            "header": [{ "key": "Content-Type", "value": "application/json" }],
            "body": { "mode": "raw", "raw": "{\n  \"line_items\": []\n}" },
            "url": { "raw": "{{baseUrl}}/price_rules/rules/v2/shops/{{shop_identifier}}/process", "host": ["{{baseUrl}}"], "path": ["price_rules", "rules", "v2", "shops", "{{shop_identifier}}", "process"] },
            "description": "Return the final price for a line item in a cart."
          }
        }
      ]
    },
    {
      "name": "Products",
      "item": [
        {
          "name": "List products",
          "request": {
            "method": "GET",
            "header": [],
            "url": { "raw": "{{baseUrl}}/products/v2/shops/{{shop_identifier}}/products", "host": ["{{baseUrl}}"], "path": ["products", "v2", "shops", "{{shop_identifier}}", "products"] },
            "description": "List the products for a shop."
          }
        }
      ]
    },
    {
      "name": "Customers",
      "item": [
        {
          "name": "List customers",
          "request": {
            "method": "GET",
            "header": [],
            "url": { "raw": "{{baseUrl}}/customers/v2/shops/{{shop_identifier}}/customers", "host": ["{{baseUrl}}"], "path": ["customers", "v2", "shops", "{{shop_identifier}}", "customers"] },
            "description": "List the customers for a shop."
          }
        }
      ]
    },
    {
      "name": "Shops",
      "item": [
        {
          "name": "Retrieve shop info",
          "request": {
            "method": "GET",
            "header": [],
            "url": { "raw": "{{baseUrl}}/shops/v1/info", "host": ["{{baseUrl}}"], "path": ["shops", "v1", "info"] },
            "description": "Retrieve the shop configuration and shop_identifier GUID."
          }
        }
      ]
    }
  ]
}
