Beverk API

Launch 1 · in build

Build on the booking engine.

Services, prices, availability, bookings, reschedules, payments and customers. Every one is an API call, and Beverk's agent books through the same ones.

curl api.beverk.com/v1/services
Read the docs

POST /v1/bookings "actor": "agent" "on_behalf_of": "owner"

Template · sample request, API not live

API surface

Seven resources. One engine.

Everything an owner does in Beverk is one of these. The app, your code and the agent all call them.

The resources

Template · sample requests, API not live


  • Get/v1/services

    Your services, durations and add-ons.

    → { "id": "svc_deep_clean",
        "minutes": 180,
        "addons": ["oven"] }
  • Post/v1/prices

    Set a price once; quotes and charges both read it.

    { "service": "svc_deep_clean",
      "amount": "[—]",
      "actor": { "type": "human",
                 "on_behalf_of": "owner" } }
    → { "audit": "price set by human for owner" }
  • Get/v1/availability

    Open slots, by service and day.

    ?service=svc_deep_clean
     &date=2026-11-03
    → { "slots": ["09:00", "13:30"] }
  • Post/v1/bookings

    Book a job.

    { "service": "svc_deep_clean",
      "start": "2026-11-03T09:00",
      "customer": "cus_sample",
      "actor": { "type": "agent",
                 "on_behalf_of": "owner" } }
    → { "audit": "booked by agent for owner" }
  • Post/v1/bookings/{id}/reschedule

    Move a job; the client can do it too.

    { "start": "2026-11-04T13:30",
      "actor": { "type": "client",
                 "on_behalf_of": "cus_sample" } }
    → { "audit":
        "rescheduled by client for cus_sample" }
  • Post/v1/payments

    Take a deposit or a payment against a booking.

    { "booking": "bkg_sample",
      "amount": "[—]",
      "actor": { "type": "agent",
                 "on_behalf_of": "owner" } }
    → { "audit": "payment taken by agent for owner" }
  • Post/v1/customers

    Create or update a client record.

    { "name": "Sample Client",
      "phone": "555-0100",
      "actor": { "type": "human",
                 "on_behalf_of": "owner" } }
    → { "audit": "client saved by human for owner" }
  • Every write is audited

    The agent writes through the same commands you do. There is no agent-only path.

    who
    agent
    for whom
    owner
    when
    2026-11-02 21:40
  • Read the docs

    Seven resources today. MCP adds a door in launch 2.

Agent quickstart

An agent books in five calls.

Beverk AI uses the public API like any other caller. Here is one booking, call by call.

  1. 01Find the service
  2. 02Check availability
  3. 03Quote
  4. 04Book
  5. 05Confirm

Booking chat · sample

  1. 9:12
    Client

    Can I get a deep clean next Tuesday morning? There’s an oven too.

    9:12
    Beverk AI

    Deep clean is 3 hours, plus 45 minutes for the oven.

  2. 9:12
    Beverk AI

    Tuesday has 9:00 or 10:30 open.

  3. 9:13
    Client

    9:00 works.

    9:13
    Beverk AI

    That’s $245 with the oven. Shall I book it?

  4. 9:13
    Client

    Yes.

    9:13
    Beverk AI

    Booked for Tuesday at 9:00.

  5. 9:13
    Beverk AI

    You’re booked. A confirmation is on its way.

Same API as the owner. Same audit trail.

Public API calls

Template · sample transcript, API not live
  1. find_serviceGET /v1/services?q=deep+clean

    { "id": "svc_deep_clean","name": "Deep clean",
      "duration_min": 180,
      "addons": [{"id": "oven","duration_min": 45 }] }
  2. check_availabilityGET /v1/availability?service=svc_deep_clean&date=2026-11-03

    { "date": "2026-11-03",
      "open": ["09:00", "10:30"],
      "duration_min": 225 }
  3. quoteGET /v1/prices?service=svc_deep_clean&addons=ovenReads prc_sample

    { "price_id": "prc_sample",
      "service": "svc_deep_clean","addons": ["oven"],
      "total": "$245" }
  4. bookPOST /v1/bookingsCharges prc_sample

    { "id": "bkg_sample","price_id": "prc_sample",
      "starts_at":"2026-11-03T09:00",
      "audit":"booked by agent for owner" }
  5. confirmGET /v1/bookings/bkg_sample

    { "id": "bkg_sample",
      "status": "confirmed",
      "sent_to": "client" }
See the seven resources

Beverk MCP Launch 2

Bring your own AI. Launch 2.

An MCP server so the AI you already use can run your bookings through Beverk. It ships after the API and our own agent, and it will be free.

  • Free · bring your own AI
  • Same commands as the API
  • Same audit line on every write

Template · waitlist not live

Launch board

Now
The API and our agent. The free tier ships with it.
Next
Your own AI runs your bookings through Beverk.
MCP config · sample
{
  "mcpServers": {
    "beverk": { "url": "[launch 2]" } }
}

Start free

Hand your front desk to an agent.

A free booking website, scheduling and client records. The agent books jobs through the same API you can call.

Template · preview only. Nothing is created or sent.

curl api.beverk.com/v1/bookings
Read the API docs