---
title: "Get Decisions By Id"
method: GET
path: "/decisions"
tags: ["Decisions"]
---

# Get Decisions By Id

`GET /decisions`

Returns the requested decisions by ID. Unknown IDs are silently omitted (no per-ID 404). Up to 50 IDs per request.

## Query parameters

- `id` string[], required — Filter by the decision's ID. Up to 50 IDs per request.

## Response `200`

A list of decisions matching the requested IDs.

- PaginatedDecisionsResponse — Schema for paginated decisions details response.
  - `items` DecisionsRead[], required — The list of items returned in the response following given criteria.
    - `address_id` string, nullable — The address identifier.
    - `city_id` string, nullable — The city ID for the address.
    - `county_id` string, nullable — The county ID for the address.
    - `jurisdiction_id` string, nullable — The jurisdiction ID for the address.
    - `street` string, nullable — The street of the property.
    - `city` string, nullable — The city of the property.
    - `state` string, nullable — The state of the property.
    - `latitude` number, nullable — The latitude of the property.
    - `longitude` number, nullable — The longitude of the property.
    - `id` string, required — The decision identifier.
    - `title` string, nullable — The title of the decision.
    - `decision_date` string, date, nullable — The date the decision was made.
    - `description` string, nullable — A free-form description of the decision.
    - `source_url` string, nullable — The URL of the source meeting record.
    - `asset_class` string, nullable — The asset class of the decision (e.g. Residential, Commercial, Mixed-Use).
    - `category` string, nullable — The category of the decision (e.g. Rezoning, Variance).
    - `subcategory` string, nullable — The subcategory of the decision.
    - `property_type` string, nullable — The type of property involved in the decision.
    - `why_it_matters` string, nullable — A short explanation of why the decision matters.
    - `applicant_name` string, nullable — The name of the applicant on the decision.
    - `owner_name` string, nullable — The name of the property owner.
    - `representative_name` string, nullable — The name of the representative on the decision.
    - `developer_name` string, nullable — The name of the developer on the decision.
    - `zoning_previous` string, nullable — The previous zoning designation.
    - `zoning_new` string, nullable — The new zoning designation.
    - `allowed_uses` string, nullable — The allowed uses under the decision.
    - `project_value` integer, nullable — The project value in cents (integer value representing dollars × 100).
    - `lot_size` integer, nullable — The lot size in square feet.
  - `size` integer, required — The number of items returned in the response.
  - `next_cursor` string, nullable, required — The cursor for retrieving the next page of results.
  - `total_count` TotalCount — Capped result count with Elasticsearch-style {value, relation} shape. When the exact count is known and within the cap, relation is "eq" and value is that exact count. When the count exceeds the cap, relation is "gte" and value is the cap the count was probed against, meaning "the actual count is at least value". The cap is COUNT_CAP for every wire-facing endpoint; internal guard paths probe against their own cap, so value carries whatever cap produced it.
    - `value` integer, required — The count value; capped at the probe's cap (10,000 on the wire).
    - `relation` 'eq' | 'gte', required — "eq" means value is the exact count. "gte" means the actual count is at least value (the cap).

## Other responses

- `422` — Validation Error

---

[API](https://skmtc.net/shovels/apis/the-shovels-api-v2.md) · [All operations](https://skmtc.net/shovels/apis/the-shovels-api-v2/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/shovels/the-shovels-api-v2/revisions/d3f0e1f3afa8/schema)