Properties
| Name | Type | Description |
|---|---|---|
| object | string | The object's type. Always `list`. |
| data | array | The results on this page. |
| has_more | boolean | Whether there are more results after this page. |
| next_cursor | object | The cursor for the next page. Send it as `cursor`. Null on the last page. |
| suppressed | integer | The number of matching results withheld because the plan does not include them. |
| total | object | The number of matching results. Only on the first page, when `total=true` is sent. Null otherwise. |
JSON Schema
{
"$schema": "https://json-schema.org/draft/2020-12/schema",
"$id": "https://artifacts.apis.io/placestack-com/json-schema/placestack-com-collection-suggestion-schema.json",
"title": "Collection[Suggestion]",
"x-generated": "2026-11-10",
"x-method": "derived",
"x-generator": "derive-json-schema.py",
"x-source": "openapi/placestack-com-suggestion-api-openapi.yml#/components/schemas/Collection_Suggestion_",
"properties": {
"object": {
"type": "string",
"const": "list",
"title": "Object",
"description": "The object's type. Always `list`.",
"default": "list"
},
"data": {
"items": {
"$ref": "#/$defs/Suggestion"
},
"type": "array",
"title": "Data",
"description": "The results on this page."
},
"has_more": {
"type": "boolean",
"title": "Has More",
"description": "Whether there are more results after this page."
},
"next_cursor": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Next Cursor",
"description": "The cursor for the next page. Send it as `cursor`. Null on the last page."
},
"suppressed": {
"type": "integer",
"title": "Suppressed",
"description": "The number of matching results withheld because the plan does not include them.",
"default": 0
},
"total": {
"anyOf": [
{
"$ref": "#/$defs/Total"
},
{
"type": "null"
}
],
"description": "The number of matching results. Only on the first page, when `total=true` is sent. Null otherwise."
}
},
"type": "object",
"required": [
"object",
"data",
"has_more",
"next_cursor",
"suppressed",
"total"
],
"$defs": {
"Suggestion": {
"properties": {
"object": {
"type": "string",
"const": "suggestion",
"title": "Object",
"description": "The object's type. Always `suggestion`.",
"default": "suggestion"
},
"kind": {
"type": "string",
"enum": [
"address",
"parcel",
"jurisdiction"
],
"title": "Kind",
"description": "Kind of match. One of `address`, `parcel` or `jurisdiction`."
},
"label": {
"type": "string",
"title": "Label",
"description": "Display text: the address, parcel number or jurisdiction name."
},
"detail": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Detail",
"description": "Secondary display text, such as the county for an address or the state for a county. Null when not needed."
},
"query": {
"additionalProperties": {
"type": "string"
},
"type": "object",
"title": "Query",
"description": "Query parameters for `GET /v1/parcel`, or `GET /v1/jurisdiction` for a jurisdiction. Send them unchanged."
},
"href": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Href",
"description": "The matched object's path in the API. Null for an address that matches several parcels."
}
},
"type": "object",
"required": [
"object",
"kind",
"label",
"detail",
"query",
"href"
],
"title": "Suggestion",
"description": "A suggested match for typed text."
},
"Total": {
"properties": {
"value": {
"type": "integer",
"title": "Value",
"description": "The number of matching results."
},
"relation": {
"type": "string",
"enum": [
"eq",
"gte"
],
"title": "Relation",
"description": "One of `eq` (exact) or `gte` (at least `value`). Counts above 10,000 are `gte`."
}
},
"type": "object",
"required": [
"value",
"relation"
],
"title": "Total",
"description": "The number of matching results."
}
}
}
Work with this as data
Every JSON Schema here is available over the APIs.io API and to AI agents over MCP.
MCP server
One button, every client — Claude, Cursor, VS Code and the rest.
https://apis.io/mcp
Tools for schemas
4 MCP tools reach this
find_json_schemasBrowse and filter every JSON Schema in the catalog.apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.resolveTurn a domain, URL or GitHub org into the provider it belongs to.find_cohortsEvery scored population of providers in the catalog.
Call it yourself
curl for this page
This JSON Schema
curl "https://apis.io/api/v1/json-schemas/placestack-com-collection-suggestion"
All schemas
curl "https://apis.io/api/v1/json-schemas?limit=25"
Calls without X-API-Key need no key. Calls with it need a paid plan — get a key.
Get an API key
Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.
A second provider on the same verified email joins the account you already have.