REST API

curl https://justagoodguy.us/api/v1/services \
  -H "Authorization: Bearer sk_your_secret_key"

{ "error": "Sorry, that time was just taken or isn’t available. Please pick another time." }

{
  "id": "bkg_8f3k2m9q1x7w4r6t",
  "status": "confirmed",
  "source": "api",
  "start": "2026-11-03T19:00:00.000Z",
  "end": "2026-11-03T19:45:00.000Z",
  "timezone": "America/New_York",
  "service": { "id": "svc_2n4p6r8t0v1x3z5b", "name": "Haircut" },
  "staff": { "id": "stf_9h7f5d3b1z0x8v6t", "name": "Dana" },
  "customer": { "id": "cus_4k6m8p0r2t4v6x8z", "name": "Sam Lee", "phone": "+15555550123", "email": null },
  "priceCents": 4500,
  "notes": null
}

curl https://justagoodguy.us/api/v1/services -H "Authorization: Bearer $JAGG_KEY"

{
  "data": [
    { "id": "svc_2n4p6r8t0v1x3z5b", "name": "Haircut", "kind": "appointment", "durationMin": 45, "priceCents": 4500, "description": null }
  ]
}

curl https://justagoodguy.us/api/v1/staff -H "Authorization: Bearer $JAGG_KEY"

{ "data": [{ "id": "stf_9h7f5d3b1z0x8v6t", "name": "Dana", "color": "#2563eb" }] }

curl "https://justagoodguy.us/api/v1/availability?service_id=svc_2n4p6r8t0v1x3z5b&days=3" \
  -H "Authorization: Bearer $JAGG_KEY"

{
  "timezone": "America/New_York",
  "data": [
    {
      "date": "2026-11-03",
      "label": "Tuesday, Nov 3",
      "slots": [
        { "start": "2026-11-03T19:00:00.000Z", "label": "2:00 PM", "staffIds": ["stf_9h7f5d3b1z0x8v6t"] }
      ]
    }
  ]
}

curl "https://justagoodguy.us/api/v1/bookings?from=2026-11-01T00:00:00Z&to=2026-11-08T00:00:00Z&status=confirmed" \
  -H "Authorization: Bearer $JAGG_KEY"

{ "data": [ { "id": "bkg_8f3k2m9q1x7w4r6t", "status": "confirmed", "...": "a Booking object" } ] }

curl https://justagoodguy.us/api/v1/bookings \
  -H "Authorization: Bearer $JAGG_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "service_id": "svc_2n4p6r8t0v1x3z5b",
    "start": "2026-11-03T19:00:00.000Z",
    "customer": { "name": "Sam Lee", "phone": "+15555550123" },
    "notes": "Booked through our members portal"
  }'

curl https://justagoodguy.us/api/v1/bookings/bkg_8f3k2m9q1x7w4r6t -H "Authorization: Bearer $JAGG_KEY"

curl https://justagoodguy.us/api/v1/bookings/bkg_8f3k2m9q1x7w4r6t/reschedule \
  -H "Authorization: Bearer $JAGG_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "start": "2026-11-04T15:30:00.000Z" }'

curl https://justagoodguy.us/api/v1/bookings/bkg_8f3k2m9q1x7w4r6t/cancel \
  -H "Authorization: Bearer $JAGG_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "reason": "Customer called to cancel" }'

{ "id": "cus_4k6m8p0r2t4v6x8z", "name": "Sam Lee", "phone": "+15555550123", "email": null, "visitCount": 3, "tags": ["regular"] }

curl "https://justagoodguy.us/api/v1/customers?q=sam&limit=20" -H "Authorization: Bearer $JAGG_KEY"

curl https://justagoodguy.us/api/v1/customers \
  -H "Authorization: Bearer $JAGG_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "name": "Sam Lee", "phone": "+15555550123", "email": "[email protected]" }'

curl https://justagoodguy.us/api/v1/customers/cus_4k6m8p0r2t4v6x8z -H "Authorization: Bearer $JAGG_KEY"

curl https://justagoodguy.us/api/v1/callbacks -H "Authorization: Bearer $JAGG_KEY"

{
  "data": [
    { "id": "cbk_3j5l7n9q1s3u5w7y", "customerId": "cus_4k6m8p0r2t4v6x8z", "windowStart": "2026-11-03T21:00:00.000Z", "windowEnd": "2026-11-03T23:00:00.000Z", "reason": "Quote for a new water heater", "status": "open" }
  ]
}

curl https://justagoodguy.us/api/v1/leads -H "Authorization: Bearer $JAGG_KEY"

{
  "data": [
    { "id": "led_6c8e0g2j4l6n8q0s", "customerId": "cus_4k6m8p0r2t4v6x8z", "kind": "quote", "details": "Leaking tap in the kitchen", "status": "new", "createdAt": "2026-11-02T14:12:00.000Z" }
  ]
}

const API = 'https://justagoodguy.us/api/v1';
const headers = { Authorization: `Bearer ${process.env.JAGG_KEY}`, 'Content-Type': 'application/json' };

async function call(path, init) {
  const res = await fetch(API + path, { headers, ...init });
  const body = await res.json();
  if (!res.ok) throw new Error(`${res.status}: ${body.error}`);
  return body;
}

const { data: services } = await call('/services');
const haircut = services.find((s) => s.name === 'Haircut');

const { data: days } = await call(`/availability?service_id=${haircut.id}&days=7`);
const first = days[0]?.slots[0];
if (!first) throw new Error('Nothing open this week');

const booking = await call('/bookings', {
  method: 'POST',
  body: JSON.stringify({ service_id: haircut.id, start: first.start, customer: { name: 'Sam Lee', phone: '+15555550123' } }),
});
console.log(booking.status, booking.start);