get_data_availability
Check if data exists for a dataflow or specific dimension combinations before building data URLs, preventing empty query results.
Instructions
Get actual data availability for a dataflow or specific dimension combinations.
This tool is critical for avoiding empty query results. Use it to check
if data exists before building the final data URL.
Args:
dataflow_id: The dataflow to check
filters: Optional dict of dimension=value pairs to check
agency_id: The agency ID
endpoint: Optional endpoint key (e.g. "FBOS", "ECB") to target a
specific provider for this call only. Defaults to the session's
current endpoint.
Returns:
Information about what data exists, including time ranges and suggestions
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| filters | No | ||
| endpoint | No | ||
| agency_id | No | ||
| dataflow_id | Yes |
Output Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| note | No | Why the answer is empty, when it is | |
| time_range | No | Available time period range | |
| data_exists | No | Whether data exists for checked combination | |
| dataflow_id | Yes | Dataflow identifier | |
| cube_regions | No | Specific data regions available | |
| constraint_id | No | Constraint identifier if available | |
| has_constraint | Yes | Whether availability constraints exist | |
| interpretation | No | Human-readable interpretation | |
| recommendation | No | Recommendation based on availability | |
| constraint_type | No | Actual (confirmed data) or Allowed (schema-permitted) | |
| discovery_level | No | Discovery workflow level | availability |
| observation_count | No | Observation count if the provider exposes it | |
| dimension_values_checked | No | Dimension values that were checked |