Skip to main content
Soonest availability measures how far out the earliest appointment slot returned to the Avoca agent was. Use it to compare booking outcomes across different waits and calculate average availability for a reporting period. These values come from recorded availability lookups. They describe what the agent could offer, not necessarily the slot spoken aloud or the appointment ultimately booked. They are different from Time to Availability (seconds), which measures seconds from call start to the first successful availability result.

​
Review availability in the dashboard

When enabled for your team, open Channels → Calls in the Avoca Calls workspace and find Soonest availability offered below the call analytics.
  1. Set the page’s date range.
  2. Review booking outcomes grouped by how many days out availability was, including calls with No availability.
  3. Choose Service types, Appointment types, or Job types. The table includes median and 90th-percentile days out, same-or-next-day availability, and booking rate.
  4. Select a breakdown row to see its individual calls, earliest slots, days out, and outcomes. Select View call to inspect a call.
The card uses the page’s date range; other Calls filters do not filter this card. Use its breakdown rows to inspect a subset. If the card is not available, contact your Avoca team about access.

​
Retrieve the fields from the Coach API

Use an API key with read:coach permission and call GET /api/coach. Both availability fields are included automatically; no Data Configuration selection is required for this endpoint.
An availability lookup can return an immediate window without a dated appointment slot, such as By Request Only. For that result, Avoca uses the lookup’s timestamp as the availability timestamp and counts it as 0 days out. If that is the earliest result for the call, the API and CSV contain this fallback. Treat it as an immediate-availability indicator, not a confirmed appointment start time. These fields alone do not distinguish this fallback from a dated same-day slot.
A multi-team key must identify the team with x-team-id. A single-team key is already scoped to its team. See Authentication and permissions. Replace the placeholders below with your API key and an accessible team ID, and set your reporting dates. The example dates are in UTC.
The response includes the following fields alongside the other Coach data. This example shows only the availability fields:
If pagination.has_more is true, increase offset by limit and request the next page with the same dates. Continue until has_more is false before calculating a reporting-period average. The endpoint returns evaluated, unarchived Coach calls in the requested call-date range. Changing the API’s timezone display parameter does not change soonest_slot_days_out, which uses the linked call’s team time zone.

​
Download a Coach CSV

  1. Select your team and open Products → Coach → Overview.
  2. Set the date range and any filters for the calls you want to export.
  3. Select the download icon labeled Export Data beside the date controls. Confirm the date range, then select Start Export.
  4. When the export is ready, use the email notification or reopen Export Data → Recent Exports and select Download CSV.
The CSV includes Soonest Slot Offered (UTC) and Soonest Slot Days Out automatically. You do not need to select Include transcripts or Include rubric details to receive them.

​
Calculate average availability in days

Average the non-null soonest_slot_days_out values from the API, or the numeric values in the CSV’s Soonest Slot Days Out column. Include zeros and exclude nulls or blank cells. For example, values of 0, 2, 4, and null have an average of 2 days: (0 + 2 + 4) / 3. Combine all calls across API pages before averaging. If no calls have a numeric value, report the average as unavailable.

​
Interpret missing values and differences

  • null in the API or a blank CSV cell means availability is unavailable for that Coach record. This can happen when there is no linked Avoca call, no recorded supported availability lookup, or no slot was returned. It does not mean zero days or prove that no appointments were available.
  • No availability in the dashboard counts calls whose recorded lookups never returned a slot. A blank Coach export cell alone cannot identify that group.
  • Dashboard and Coach totals can differ. The dashboard examines availability lookups for AI calls in its selected call-date range, while the Coach API and export select evaluated Coach records. Match the population and dates before comparing results. The dashboard’s median and 90th percentile are also different statistics from an arithmetic average.
For more on exporting and reviewing Coach records, see Coach overview.