---
title: "All-inclusive hourly rate range for a role in a city"
method: GET
path: "/api/v1/pricing"
tags: ["Planning"]
---

# All-inclusive hourly rate range for a role in a city

`GET /api/v1/pricing`

## Request

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

Use this when an agent needs to quote a price range for a specific role in a specific city, for example, 'what do brand ambassadors cost in Boston?' Returns a `hourly_range_low` / `hourly_range_high` range reflecting event-type and shift variability within that market tier. **All rates are all-inclusive W-2 bill rates** covering worker pay, payroll taxes, workers' comp, liability, and TempGuru coordination. Rate ranges are planning estimates, a real quote requires event specifics.

## Query parameters

- `role` string, required
- `city` string, required

## Response `200`

Hourly rate range for the role in the resolved city tier.

- PricingResponse
  - `input` object, required
  - `role` string, required
  - `role_slug` string, required
  - `city` string, required
  - `state` string, required
  - `city_tier` 'hub' | 'mid' | 'small', required
  - `hourly_range_low` number, required
  - `hourly_range_high` number, required
  - `currency` 'USD' | 'CAD', required
  - `all_inclusive` string, required
  - `tier_definition` string
  - `all_tiers_for_context` object
    - `small` PriceBand
      - `low` number, required: Lower end of the hourly rate range (USD).
      - `high` number, required: Upper end of the hourly rate range (USD).
    - `mid` PriceBand
      - `low` number, required: Lower end of the hourly rate range (USD).
      - `high` number, required: Upper end of the hourly rate range (USD).
    - `hub` PriceBand
      - `low` number, required: Lower end of the hourly rate range (USD).
      - `high` number, required: Upper end of the hourly rate range (USD).
  - `pricing_notes` string
  - `role_note` string: Caveat emitted when the requested phrasing maps to a constrained service, for example security mapping to unarmed Crowd Control rather than licensed guards.

## Other responses

- `400`: Missing required parameter.
- `404`: Unknown role or city.

---

[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)