Tolk2Go Interpreter Booking

Cancel an owned interpreter booking.

Create an owner-scoped interpreter request for one start and end time. First get the IDs with the discovery tools and run tolk2go_interpreting_search_availability immediately before this call. preferred_interpreter_ids are the interpreters (one or more, from that search) who are asked first; offer several, or one when the customer wants a specific interpreter, for example one they booked before. If they are not available or do not answer in time, Tolk2Go automatically asks the next matching interpreters, up to 64 at a time. Interpreters usually respond within an hour (FAQ), so tell the customer the request is out and check tolk2go_interpreting_get_responses later.

Read the authoritative owner-scoped booking, payment, change and next-action state.

Poll which interpreters responded as available for an owned booking request, with their interpreter_id. An empty list means wait (see polling.recommended_after_seconds on the booking) and poll again. Next: tolk2go_interpreting_preview_selection.

List this account’s interpreter bookings, optionally returning only changes after a timestamp or cursor.

No key needed. For a situation with booking_flow catalog (such as cbr): its groups and items with code, name, duration_minutes and fixed price (excl. and incl. VAT; null for items priced per hour plus travel). Match what the customer says (a code such as VEE, or a name) to an item and ask the customer to choose when several match. Pass the item code as examCodeId to tolk2go_interpreting_search_availability and as catalog_item_code to tolk2go_interpreting_create_booking; end = start + duration_minutes.

No key needed. The fixed exam locations (name, address, city, latitude, longitude) of a catalogue group with location_mode configured_locations, such as the CBR theory exam centres. Pick the one in the city the customer named (ask when there are several); search availability with its latitude and longitude and pass its name as exam_location to tolk2go_interpreting_create_booking. Do not ask the customer for the address.

No key needed. List the bookable language pairs (for example Arabic–Dutch) with the language_pair_id that availability search and create_booking need. Filter with a language_id from tolk2go_interpreting_list_languages to keep the list short.

Step 1 of booking, no key needed. List the languages Tolk2Go interprets, with their IDs. Pass a language ID to tolk2go_interpreting_list_language_pairs.

No key needed. List the qualification types the search page filters on (such as Sworn Interpreter) and their providers (such as a national register). Pass the IDs as qualification_nodes to tolk2go_interpreting_search_availability when the customer requires a sworn or otherwise qualified interpreter.

No key needed. List the situations (such as medical, legal, business or CBR exams) with the situation_id that availability search and create_booking need. Pick the one that matches the assignment. Situations with booking_flow catalog (such as CBR) book an item from tolk2go_interpreting_list_catalog.

Read-only. The exact proposal that tolk2go_interpreting_select_interpreter would commit to for this interpreter: time, phone/video or on-site location, price incl. VAT, payment terms (deposit, deadline) and cancellation terms. Show it to the customer and get explicit approval before selecting.

Submit supported changes through the existing customer approval flow.

No key needed. Search interpreters for one assignment with the same filters and results as the tolk2go.com search page. Returns interpreter IDs, ratings and prices (excl. and incl. VAT) plus paging. Search again immediately before tolk2go_interpreting_create_booking so the IDs and prices are current.

Book an interpreter who responded as available. This commits the customer: only call it after showing tolk2go_interpreting_preview_selection for the same interpreter and getting the customer’s explicit approval. If the result contains a payment URL, give it to the customer and poll tolk2go_interpreting_get_booking until the booking is confirmed.

Search approved Tolk2Go knowledge: FAQ answers, workflows such as the booking workflow, and domain cards such as booking status meanings. Translate the user's question to English before calling this tool. Use it before answering questions about booking steps, booking statuses, services, policies, cancellation, payment, or use of Tolk2Go. Answer only from directly supporting returned passages. If the tool fails, times out, is unavailable, or returns no directly supporting passage, do not guess and offer human support when appropriate.