Full API reference →
Migration guide

Burq → Getcho, endpoint by endpoint.

Moving a Burq delivery integration onto Getcho's Business Orders API is a base-URL swap, a header swap, and a thin body/status rename layer. This page maps every Burq call you make today to its Getcho counterpart and calls out what's new and what isn't there yet.

Same no change on your side Getcho-only new on Getcho Burq-only no Getcho counterpart yet
  1. In one paragraph
  2. Base URL & auth
  3. Endpoint map
  4. A · Quote
  5. B · Book
  6. C · Track & status mapping
  7. D · Cancel & reschedule
  8. Webhooks
  9. Sandbox
  10. Not on Getcho yet
  11. Discovery questions

In one paragraph

Burq and Getcho are the same shape: quote → book → poll → cancel/reschedule, one API key per business, prices returned per carrier. Getcho adds a real sandbox (simulated couriers, no charges), a stable tracking URL from the first response, and a first-class reschedule call. Getcho does not yet expose Burq's multi-stop routes, stores, or a list endpoint. Budget roughly a day of integration work against the sandbox.

Base URL & auth

BurqGetcho
Productionhttps://api.burqup.com/v1https://api.getcho.app/api/v1/business-orders
Sandboxsame URL, Sandbox Key (dashboard "Test Environment" toggle)https://staging.getcho.app/api/v1/business-orders, gcho_test_… key
Auth headerx-api-key: <key>Authorization: Bearer <key>
Env mix-upsilently hits the other environment401 with an explicit reason (Test api key used on production …)

The business is inferred from the key — there is no business id in any body. You receive a gcho_test_ key first; the live key is minted at go-live and the only change on your side is the base URL and token.

Endpoint map

You call on Burq todayCall on GetchoNotes
POST /quote · POST /delivery_information (initiate:false)POST /quotesMulti-carrier, cheapest first, prices final & all-in
POST /initiate_delivery · POST /delivery_information (initiate:true, quote_id)POST /orders — or POST /orders/dispatch for ASAPBooks with the carrier in the call; 502 if it declines
GET /delivery/{id}GET /orders/{orderId}Status, courier, ETAs, tracking URL, proof of delivery
POST /delivery/{id}/cancelPOST /orders/{orderId}/cancelIdempotent; 409 with a reason if the carrier refuses
PUT /orders/{id} (time only)POST /orders/{orderId}/rescheduleGetcho-only as a first-class call
GET /deliveries (list)—Burq-only keep your own order → orderId map
/stores CRUD—Burq-only send the pickup address on every quote
Routes / multi-stop, Incidents, Connect—Burq-only see Not on Getcho yet
Webhooksdelivery.* eventssee Webhooks

A · Quote

POST /quotes

Burq's quote is one price for the provider Burq picked. Getcho returns every bookable carrier as its own quote, cheapest first, each with a single-use quoteId that expires in ~15 minutes.

Request — Burq's flat fields become nested objects. Items need weight and dimensions (Burq only asked for name / quantity / size).

Burq · POST /delivery_information (initiate:false)
{
  "pickup_address": "8340 W 3rd St, Los Angeles, CA 90048",
  "pickup_name": "French Florist",
  "pickup_phone_number": "+13235550100",
  "dropoff_address": "1043 S Point View St, Los Angeles, CA 90035",
  "dropoff_name": "Gilit R.",
  "dropoff_phone_number": "+13105550123",
  "dropoff_notes": "Leave with doorman",
  "items": [{ "name": "Arrangement", "quantity": 1, "size": "medium" }],
  "external_order_ref": "FF-221927",
  "initiate": false
}
Getcho · POST /quotes
{
  "pickup":  { "address": "8340 W 3rd St, Los Angeles, CA 90048",
               "name": "French Florist", "phone": "+13235550100" },
  "dropoff": { "address": "1043 S Point View St, Los Angeles, CA 90035",
               "name": "Gilit R.", "phone": "+13105550123",
               "instructions": "Leave with doorman" },
  "items": [{ "description": "Arrangement", "quantity": 1,
              "weight": 5, "length": 12, "width": 12, "height": 18 }],
  "overallSize": "medium",      // optional, default medium
  "pickupWindow": { "start": 1756660800000, "end": 1756668000000 },
                                // optional; omit for ASAP
  "requestProof": true,         // photo proof of delivery
  "externalRef": "FF-221927"    // echoed on every Order
}

Response

{
  "quotes": [
    { "quoteId": "q_3b1c", "carrier": "uber",     "displayName": "Uber",
      "priceCents": 930,  "etaMinutes": 41, "currency": "USD" },
    { "quoteId": "q_8f2a", "carrier": "doordash", "displayName": "DoorDash",
      "priceCents": 975,  "etaMinutes": 34, "currency": "USD" },
    { "quoteId": "q_c41d", "carrier": "grubhub",  "displayName": "Grubhub",
      "priceCents": 999,  "etaMinutes": 47, "currency": "USD" }
  ],
  "expiresAt": "2026-08-31T18:15:00Z"
}

priceCents is the carrier's price — no percentage markup is added. An empty quotes: [] means no carrier serves the lane (typically distance); treat it as Burq's "no provider available".

B · Book

POST /orders (scheduled) · POST /orders/dispatch (ASAP)

Burq books by re-sending the manifest with quote_id (or via /initiate_delivery). Getcho books the quoteId alone — addresses and items from the quote are reused. POST /orders anchors dispatch to the quote's pickupWindow; POST /orders/dispatch sends a courier now.

Request (both routes)
{
  "quoteId": "q_3b1c",
  "dropoff": { "notes": "Call on arrival" },  // optional overrides
  "isSignatureRequired": false,
  "minAgeRequirement": 21   // ID check at handoff (alcohol)
}
Response — Order
{
  "orderId": 68901,
  "status": "DISPATCHED",     // the carrier accepted
  "carrier": "uber",
  "priceCents": 930, "currency": "USD",
  "trackingUrl": "https://withgetcho.com/t/68901",
                              // stable from the first response
  "pickup":  { "address": "…", "name": "…", "phone": "…" },
  "dropoff": { "address": "…", "name": "…", "phone": "…",
               "instructions": "…" },
  "externalRef": "FF-221927",
  "createdAt": "2026-08-31T17:02:11Z"
}

The call books with the carrier and returns once it has accepted (DISPATCHED). If the carrier declines you get 502 with a reason and no order is left open; get a new quote. 409 = quote already booked, 410 = quote expired.

C · Track

GET /orders/{orderId}

Same call as Burq's GET /delivery/{id}; the object is flatter.

Burq fieldGetcho field
idorderId
status (see mapping below)status
provider.namecarrier
payment_amount + feepriceCents (one number, all-in)
tracking_urltrackingUrl
courier_name · courier_phone_numbercourierName · courierPhoneNumber
pickup_eta · dropoff_etapickupEta · dropoffEta
dropoffs[0].* + flat dropoff_*dropoff.{address,name,phone,instructions,lat,lng}
proof_of_deliveryproofOfDelivery[] ({type:"photo_proof_of_delivery", url})
external_order_refexternalRef
—providerDeliveryId Getcho-only
test_mode · reroute · status_history · courier_location_* · signatureBurq-only — courier location is available via the delivery.location_updated webhook

Status mapping

Getcho collapses Burq's 19 statuses into 6. Map on your side:

BurqGetcho
request, scheduled, delivery_created, driver_not_assignedPENDING
driver_assigned, enroute_pickup, arrived_at_pickupDISPATCHED
pickup_complete, enroute_dropoff, arrived_at_dropoffPICKED_UP
dropoff_complete, deliveredDELIVERED
provider_canceled, customer_canceled, burq_canceledCANCELED
failedFAILED
enroute_to_return, returned, disputednot a status on Getcho — returns arrive as the delivery.returned webhook; disputes go through support

D · Cancel & reschedule

POST /orders/{orderId}/cancel

One route for Burq's cancel/delete variants. Body { "reason": "…" } is optional. We ask the carrier first and cancel the order only once it accepts. If the carrier refuses (e.g. DoorDash once a Dasher is assigned), the order stays active and you get 409 with a reason. 409 too while the carrier booking is still in progress (retry shortly), and once delivered. Idempotent.

Cancellation terms: uber free before a courier is assigned, $5 after; roadie free before a driver is assigned, $10 after; doordash free before a Dasher is assigned, not cancellable after; frayt usually free well ahead of pickup, otherwise up to 50% of the delivery price; grubhub a fee may apply. Fees are charged to the business.

POST /orders/{orderId}/reschedule

Burq: PUT the order with a new time. Getcho: { "pickupWindow": { "start", "end" } } in epoch milliseconds. Rejected (409) once picked up. DoorDash can't move once a courier is assigned (409). Uber and Roadie can, by re-booking, with a $5 / $10 cancellation fee: the first call returns 409 with feeCents, and sending "confirmFee": true goes ahead. 501 on Grubhub and other carriers. Address, item or contact changes are cancel + rebook — same as Burq.

Webhooks

Burq: dashboard-registered per environment, delivery.updated and friends, signed with Burq-Signature. Getcho: delivery.* events to an HTTPS endpoint, HMAC-signed —

delivery.created · delivery.driver_assigned · delivery.pickup_complete · delivery.delivered · delivery.canceled · delivery.failed · delivery.returned · delivery.location_updated (opt-in heartbeat, ~10 min)

Events fire identically on staging, so your listener can be tested end-to-end against simulated couriers. Registration is on request during onboarding — send us the endpoint URL and events for each environment. A self-serve subscription endpoint for Business Orders keys is not exposed yet. Polling GET /orders/{orderId} is always sufficient.

Sandbox

https://staging.getcho.app runs production code and database with Uber's test-mode account behind it. Every booking gets a simulated Robo Courier: DISPATCHED immediately, PICKED_UP at about 1:30, DELIVERED at about 2:30 — real tracking URL, real webhooks, no charge. Staging quotes are Uber-only. A gcho_test_ key works only there, a gcho_live_ key only on production, and each environment can only see its own orders.

Not on Getcho yet

Discovery questions

Each lists Getcho's default assumption — if it holds, there's nothing extra to do.

  1. One-shot or two-step? POST /delivery_information with initiate:true, or quote then initiate_delivery. (Default: two-step.)
  2. Burq v1 or v2? /delivery_information (v1) or /v2/orders → routes → quotes → dispatch (v2). The map above is v1; v2 flattens to the same three Getcho calls.
  3. Webhooks or polling? (Default: polling.)
  4. Scheduled windows or ASAP? A window's start maps to pickupWindow.start. (Default: ASAP.)
  5. Any Routes / multi-stop use? (Default: none.)
Getcho Business Orders API · full reference · openapi.yaml Updated 2026-08-31