---
title: "Lead-time guidance for an event"
method: GET
path: "/api/v1/availability"
tags: ["Planning"]
---

# Lead-time guidance for an event

`GET /api/v1/availability`

## Request

- Base URL: `https://mcp.tempguru.co`
- URL: `https://mcp.tempguru.co/api/v1/availability`
- Auth: none declared

Use this when an agent wants to know whether TempGuru can typically staff an event at a given city and date, for example, 'is two weeks enough notice for Dallas?' Returns a recommendation in the set {yes, tight, rush, very-rush} based on the city's market tier and how far out the event is. **This is planning guidance, not a real-time reservation.** A confirmed booking requires a quote request at https://tempguru.co/get-staffing.

## Query parameters

- `city` string, required
- `date` string, date, required
- `role` string
- `headcount` integer

## Response `200`

Availability guidance for the requested event.

- AvailabilityResponse
  - `input` object, required
  - `city_found` true, required
  - `catalog_match` true, required: The city resolved to a configured catalog entry; this does not confirm order coverage.
  - `coverage_confirmation_required` true, required
  - `city` string, required
  - `state` string, required
  - `city_tier` 'hub' | 'mid' | 'small', required
  - `event_date` string, date, required
  - `days_until_event` integer, required
  - `in_past` boolean, required: True when the requested event date has already passed. Confirm the intended date before planning or quoting.
  - `typical_lead_time_hours` integer, required
  - `recommendation` 'yes' | 'tight' | 'rush' | 'very-rush', required: yes = comfortable window; tight = at or near typical lead time; rush = inside lead time; very-rush = <24h.
  - `role_found` boolean, nullable, required: null when no role was requested; true when the requested role resolved; false when it did not match the catalog.
  - `role_suggestion` object: Present only when role_found is false and there is one unambiguous nearby catalog match. Confirm before using it.
    - `kind` 'role', required
    - `slug` string, required
    - `name` string, required
  - `role` object, nullable
    - `name` string
    - `rate_range_usd` PriceBand
      - `low` number, required: Lower end of the hourly rate range (USD).
      - `high` number, required: Upper end of the hourly rate range (USD).
    - `all_inclusive` string
  - `count` integer, nullable
  - `notes` string[], required

## Other responses

- `400`: Missing required parameter or invalid date.
- `404`: Requested city is not in TempGuru's published footprint.

---

[API](https://skmtc.dev/tempguru/apis/tempguru-public-data-api.md) · [All operations](https://skmtc.dev/tempguru/apis/tempguru-public-data-api/llms.txt) · [OpenAPI document](https://skmtc.dev/tempguru/apis/tempguru-public-data-api/revisions/5969f4556a32?raw)