{
  "info": {
    "name": "Billsby — mcp.ai",
    "description": "REST API for the Billsby MCP. Set {{apiKey}} to a workspace key (sk_live_…) created at https://mcp.ai/settings/api-keys.",
    "schema": "https://schema.getpostman.com/json/collection/v2.1.0/collection.json"
  },
  "auth": {
    "type": "bearer",
    "bearer": [
      {
        "key": "token",
        "value": "{{apiKey}}",
        "type": "string"
      }
    ]
  },
  "variable": [
    {
      "key": "baseUrl",
      "value": "https://api.mcp.ai/api/billsby",
      "type": "string"
    },
    {
      "key": "apiKey",
      "value": "sk_live_...",
      "type": "string"
    }
  ],
  "item": [
    {
      "name": "billsby_create_customer",
      "request": {
        "method": "POST",
        "header": [
          {
            "key": "Content-Type",
            "value": "application/json"
          }
        ],
        "url": {
          "raw": "{{baseUrl}}/create/customer",
          "host": [
            "{{baseUrl}}"
          ],
          "path": [
            "create",
            "customer"
          ]
        },
        "description": "Create a Billsby customer without a subscription or payment card. This does not start recurring billing.",
        "body": {
          "mode": "raw",
          "raw": "{\n  \"email\": \"\",\n  \"last_name\": \"\",\n  \"first_name\": \"\",\n  \"billing_address\": {}\n}",
          "options": {
            "raw": {
              "language": "json"
            }
          }
        }
      }
    },
    {
      "name": "billsby_get_customer",
      "request": {
        "method": "POST",
        "header": [
          {
            "key": "Content-Type",
            "value": "application/json"
          }
        ],
        "url": {
          "raw": "{{baseUrl}}/get/customer",
          "host": [
            "{{baseUrl}}"
          ],
          "path": [
            "get",
            "customer"
          ]
        },
        "description": "Get billing, contact, payment-status, and account details for one Billsby customer.",
        "body": {
          "mode": "raw",
          "raw": "{\n  \"customer_unique_id\": \"\"\n}",
          "options": {
            "raw": {
              "language": "json"
            }
          }
        }
      }
    },
    {
      "name": "billsby_get_subscription",
      "request": {
        "method": "POST",
        "header": [
          {
            "key": "Content-Type",
            "value": "application/json"
          }
        ],
        "url": {
          "raw": "{{baseUrl}}/get/subscription",
          "host": [
            "{{baseUrl}}"
          ],
          "path": [
            "get",
            "subscription"
          ]
        },
        "description": "Get billing schedule, customer, product, plan, pricing, status, and revenue details for one Billsby subscription.",
        "body": {
          "mode": "raw",
          "raw": "{\n  \"subscription_unique_id\": \"\"\n}",
          "options": {
            "raw": {
              "language": "json"
            }
          }
        }
      }
    },
    {
      "name": "billsby_get_subscription_shipping_address",
      "request": {
        "method": "POST",
        "header": [
          {
            "key": "Content-Type",
            "value": "application/json"
          }
        ],
        "url": {
          "raw": "{{baseUrl}}/get/subscription/shipping/address",
          "host": [
            "{{baseUrl}}"
          ],
          "path": [
            "get",
            "subscription",
            "shipping",
            "address"
          ]
        },
        "description": "Get the shipping address associated with one Billsby subscription.",
        "body": {
          "mode": "raw",
          "raw": "{\n  \"subscription_unique_id\": \"\"\n}",
          "options": {
            "raw": {
              "language": "json"
            }
          }
        }
      }
    },
    {
      "name": "billsby_list_customer_subscriptions",
      "request": {
        "method": "POST",
        "header": [
          {
            "key": "Content-Type",
            "value": "application/json"
          }
        ],
        "url": {
          "raw": "{{baseUrl}}/list/customer/subscriptions",
          "host": [
            "{{baseUrl}}"
          ],
          "path": [
            "list",
            "customer",
            "subscriptions"
          ]
        },
        "description": "List all subscriptions belonging to one Billsby customer.",
        "body": {
          "mode": "raw",
          "raw": "{\n  \"customer_unique_id\": \"\"\n}",
          "options": {
            "raw": {
              "language": "json"
            }
          }
        }
      }
    },
    {
      "name": "billsby_list_customers",
      "request": {
        "method": "POST",
        "header": [
          {
            "key": "Content-Type",
            "value": "application/json"
          }
        ],
        "url": {
          "raw": "{{baseUrl}}/list/customers",
          "host": [
            "{{baseUrl}}"
          ],
          "path": [
            "list",
            "customers"
          ]
        },
        "description": "Return one page of customers for the connected Billsby company, optionally filtered by a partial customer name.",
        "body": {
          "mode": "raw",
          "raw": "{\n  \"search\": \"\",\n  \"page_size\": 0,\n  \"next_cursor\": \"\"\n}",
          "options": {
            "raw": {
              "language": "json"
            }
          }
        }
      }
    },
    {
      "name": "billsby_list_product_plans",
      "request": {
        "method": "POST",
        "header": [
          {
            "key": "Content-Type",
            "value": "application/json"
          }
        ],
        "url": {
          "raw": "{{baseUrl}}/list/product/plans",
          "host": [
            "{{baseUrl}}"
          ],
          "path": [
            "list",
            "product",
            "plans"
          ]
        },
        "description": "List the plans and billing cycles configured for one Billsby product.",
        "body": {
          "mode": "raw",
          "raw": "{\n  \"product_id\": 0\n}",
          "options": {
            "raw": {
              "language": "json"
            }
          }
        }
      }
    },
    {
      "name": "billsby_list_products",
      "request": {
        "method": "POST",
        "header": [
          {
            "key": "Content-Type",
            "value": "application/json"
          }
        ],
        "url": {
          "raw": "{{baseUrl}}/list/products",
          "host": [
            "{{baseUrl}}"
          ],
          "path": [
            "list",
            "products"
          ]
        },
        "description": "Return one page of Billsby products, optionally filtered by name or visibility.",
        "body": {
          "mode": "raw",
          "raw": "{\n  \"search\": \"\",\n  \"page_size\": 0,\n  \"visibility\": 0,\n  \"next_cursor\": \"\"\n}",
          "options": {
            "raw": {
              "language": "json"
            }
          }
        }
      }
    },
    {
      "name": "billsby_list_subscriptions",
      "request": {
        "method": "POST",
        "header": [
          {
            "key": "Content-Type",
            "value": "application/json"
          }
        ],
        "url": {
          "raw": "{{baseUrl}}/list/subscriptions",
          "host": [
            "{{baseUrl}}"
          ],
          "path": [
            "list",
            "subscriptions"
          ]
        },
        "description": "Return one page of company subscriptions with optional status, trial, product, plan, and ordering filters.",
        "body": {
          "mode": "raw",
          "raw": "{\n  \"order_by\": \"\",\n  \"is_active\": false,\n  \"page_size\": 0,\n  \"plan_name\": \"\",\n  \"next_cursor\": \"\",\n  \"product_name\": \"\",\n  \"is_in_free_trial\": false,\n  \"order_descending\": false\n}",
          "options": {
            "raw": {
              "language": "json"
            }
          }
        }
      }
    },
    {
      "name": "billsby_update_customer",
      "request": {
        "method": "POST",
        "header": [
          {
            "key": "Content-Type",
            "value": "application/json"
          }
        ],
        "url": {
          "raw": "{{baseUrl}}/update/customer",
          "host": [
            "{{baseUrl}}"
          ],
          "path": [
            "update",
            "customer"
          ]
        },
        "description": "Replace the editable contact and billing-address details for an existing Billsby customer. Supply the complete desired values, not a partial patch.",
        "body": {
          "mode": "raw",
          "raw": "{\n  \"email\": \"\",\n  \"last_name\": \"\",\n  \"first_name\": \"\",\n  \"phone_number\": \"\",\n  \"billing_address\": {},\n  \"customer_unique_id\": \"\",\n  \"phone_number_dial_code\": \"\",\n  \"phone_number_dial_country\": \"\"\n}",
          "options": {
            "raw": {
              "language": "json"
            }
          }
        }
      }
    }
  ]
}