---
title: "Claim Bonus County"
method: POST
path: "/api/v1/workspace/bonus-county"
tags: ["workspace"]
---

# Claim Bonus County

`POST /api/v1/workspace/bonus-county`

Spend a free self-serve workspace's one bonus county.

## Request body

- BonusCountyClaimRequest
  - `county_fips` string, required — 5-digit GEOID

## Response `200`

Successful Response

- BonusCountyResponse — The workspace's bonus county, claimed or still to claim. ``claimable_county_fips`` is empty once a county is claimed, and for every workspace that has no bonus to spend.
  - `claimed_county_fips` string, nullable, required
  - `claimable_county_fips` string[], required

## Other responses

- `403` — This workspace has no bonus county
- `409` — Bonus already used, or county already held
- `422` — The shared data does not hold the county
- `503` — The shared data cannot be read here

## Changes

- **2026-09-25** `bb508e935174` — 1 info
  - endpoint added

[Change history](https://skmtc.dev/maia-analytics/apis/maia-api/changes/api/v1/workspace/bonus-county/post.md)

---

[API](https://skmtc.dev/maia-analytics/apis/maia-api.md) · [All operations](https://skmtc.dev/maia-analytics/apis/maia-api/llms.txt) · [OpenAPI document](https://skmtc.dev/maia-analytics/apis/maia-api/revisions/bb508e935174?raw)