# insights.map.drilldown

Inspect up to 100 map records with the same filters, an optional returned clusterKey and an opaque nextCursor. Logical records and stable cursor paging preserve source access and missing-location coverage.

`GET | POST /api/v1/accounting/insights.map.drilldown`

Permissions: `accounting:read` · Roles: admin, finance

MCP tool: `accounting_insights_map_drilldown`

## Fields

| Field | Type | Required | Notes |
| --- | --- | --- | --- |
| `layers` | array of enum values |  | One of: `transactions`, `trips`, `stays`, `events`, `other`. 1–5 items. |
| `query` | string |  | Text to search for. 1–120 characters. |
| `from` | string |  | The first date to include, as YYYY-MM-DD. Date as YYYY-MM-DD. |
| `to` | string |  | The last date to include, as YYYY-MM-DD. Date as YYYY-MM-DD. |
| `currency` | string |  | Three-letter currency code, such as CAD or USD. |
| `entryTypes` | array of enum values |  | One of: `expense`, `income`, `income_refund`, `refund`, `transfer`, `fee`, `suspense`. 1–7 items. |
| `country` | string |  | 1–120 characters. |
| `region` | string |  | 1–120 characters. |
| `city` | string |  | 1–120 characters. |
| `bounds` | object |  | No other fields. |
| `bounds.south` | number | Yes | -90 to 90. |
| `bounds.north` | number | Yes | -90 to 90. |
| `bounds.west` | number | Yes | -180 to 180. |
| `bounds.east` | number | Yes | -180 to 180. |
| `zoom` | number |  | 0 to 22. |
| `groupBy` | enum |  | One of: `auto`, `region`, `city`, `grid`. |
| `clusterKey` | string |  | at most 100 characters; Matches ^(?:grid:\d+(?:\.\d+)?:\d+:\d+\|(?:city\|region):[a-f0-9]{64})$. |
| `cursor` | string |  | Where the next page starts: the nextCursor value from the previous response. Matches ^[A-Za-z0-9_-]{1,300}$. |
| `limit` | integer |  | How many results to return at most. 1 to 100. |

## Example request

```bash
curl https://app.getoatmilk.com/api/v1/accounting/insights.map.drilldown \
  -H "Authorization: Bearer $OATMILK_API_KEY"
```

Reference page: https://app.getoatmilk.com/docs/api/insights.map.drilldown