Get all locations
pinmeto_get_locationsRead-only
Retrieve all PinMeTo locations with pagination and filters like city, country, or status. Uses 5-minute caching for fast queries on large datasets.
Instructions
Get ALL locations with pagination and filtering. Uses in-memory cache (5-min TTL) for fast queries on large datasets.
Examples:
Get first 50 locations: {}
Get next page: { offset: 50 }
Filter by city: { city: "Stockholm", limit: 20 }
Only open locations: { permanentlyClosed: false }
Force cache refresh: { forceRefresh: true }
Error Handling:
Partial results may be returned on API errors (check incomplete field)
Stale cache data returned with warning if fresh fetch fails
Check errorCode (string) and retryable (boolean) in structuredContent
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| city | No | Filter by city name (case-insensitive) | |
| type | No | Filter by location type | |
| limit | No | Maximum results to return (default: 50, max: 1000) | |
| fields | No | Fields to include in the response (optional, defaults to all) | |
| offset | No | Number of results to skip (default: 0) | |
| country | No | Filter by country name (case-insensitive) | |
| forceRefresh | No | Force cache refresh (bypasses 5-minute TTL) | |
| response_format | No | Response format: "json" (default, token-efficient) or "markdown" (human-readable with tables) | json |
| permanentlyClosed | No | Filter by permanently closed status |
Output Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| data | No | Array of location objects (absent on error) | |
| error | No | Error message if the request failed | |
| limit | No | Requested limit | |
| offset | No | Current offset position | |
| hasMore | No | Whether more results exist beyond offset+limit | |
| warning | No | Warning message if data may be incomplete | |
| cacheInfo | No | Cache status information | |
| errorCode | No | Error code for programmatic handling | |
| retryable | No | Whether the operation can be retried | |
| incomplete | No | Whether data may be incomplete due to pagination errors | |
| totalCount | No | Total locations matching filters |