Get a request

Returns one of your requests. Poll it until status is live or rejected.

GET /v1/bc/onboarding-requests/{id}
Authorization: Bearer <token>

Path parameters

Name	Type	Notes
id	string	The id returned when the request was created

Response - 200 OK

Same shape as Request a restaurant.

{
  "id": "7f1c2a9e-5d1b-4c0e-9f3a-2b8d6e4c1a90",
  "reference": "A1B2C3D4",
  "status": "live",
  "rms": {"code": "ZENCHEF", "name": "Zenchef"},
  "venueRmsId": "12345",
  "venueBcId": "voice-restaurant-77",
  "venueName": "Trattoria da Mario",
  "venueAddress": "12 Rue de la Paix, 75002 Paris",
  "notes": "Caller asked for the Paris branch",
  "referenceMatched": true,
  "venue": {"id": "60e5a3ed409541da3650bd90", "name": "Trattoria da Mario"},
  "rejectReason": null,
  "requestedAt": "2026-10-29T10:12:00+00:00",
  "liveAt": "2026-10-30T09:00:00+00:00",
  "rejectedAt": null,
  "updatedAt": "2026-10-30T09:00:00+00:00"
}

Once status is live, venue.id is returned by GET /v1/bc/venues and accepted by the availability and booking endpoints of the Booking Channel API.

Errors

Code	When
404	No request with this id belongs to your channel