Developers

The BinBros API.

A clean REST + JSON API over your customers, jobs, routes, messages, and payments. Keyset-paginated, idempotent, webhook-driven. Currently in private beta — public v1 lands later this year.

Request beta access

Quickstart

Authenticate with a per-org bearer token. Everything is JSON, everything is keyset-paginated.

curl https://api.binbros.app/v1/customers \
  -H "Authorization: Bearer $BINBROS_TOKEN" \
  -H "Accept: application/json"

# Paginated response
{
  "data": [ ... ],
  "page": {
    "next": "eyJpZCI6IjAxSC4uLiJ9",
    "prev": null
  }
}

Endpoints (preview)

GET /v1/customers List customers (keyset paginated).
POST /v1/customers Create a customer with addresses and service plan.
GET /v1/jobs List scheduled or completed jobs in a date range.
POST /v1/jobs Create a one-off job and place it on a route.
GET /v1/routes/:date Get the optimized route for a date / region.
POST /v1/messages Send a templated SMS to a customer (respects quiet hours).
POST /v1/webhooks Subscribe to job, payment, and message events.

Full reference and OpenAPI spec ship with the public v1. Beta partners get them today.