> ## Documentation Index > Fetch the complete documentation index at: https://docs.verdant-ai.com/llms.txt > Use this file to discover all available pages before exploring further. # Validate query structure > Validate shape, calendar dates and ordered bounds only. A valid request is not a coverage guarantee, quote or purchase. Bounds must be west < east and south < north; period start must not follow end. These cross-field constraints are enforced at runtime. ## OpenAPI ````yaml /openapi.json post /api/v1/data/validate openapi: 3.1.0 info: title: Verdant Climate Data API version: 1.0.0 description: >- Versioned climate data with preserved meaning. Discover → inspect → resolve → query. Small published-data queries return values directly, with explicit units, spatial support, missingness and provenance. Public demo endpoints require no credentials. Paid acquisition is not enabled; consult capabilities before planning a workflow. servers: - url: https://api.verdant-ai.com description: Production (public demo data; payment test mode) security: [] tags: - name: Discovery - name: Queries - name: Observations - name: Raster - name: Service paths: /api/v1/data/validate: post: tags: - Queries summary: Validate query structure description: >- Validate shape, calendar dates and ordered bounds only. A valid request is not a coverage guarantee, quote or purchase. Bounds must be west < east and south < north; period start must not follow end. These cross-field constraints are enforced at runtime. operationId: validateDataRequest requestBody: required: true description: >- A bounded climate query. JSON is the default representation. The response contains data directly; no download or acquisition job is required. content: application/json: schema: $ref: '#/components/schemas/DataRequest' example: variables: - air_temperature_max region: bbox: - 142.3 - -34.45 - 142.4 - -34.35 crs: EPSG:4326 period: start: '2003-01-01' end: '2003-01-01' temporal_resolution: daily spatial_resolution: native units: air_temperature_max: degC data_class: interpolated_observation format: json missing_policy: preserve source_preference: silo responses: '200': description: Valid request structure, with defaults applied. content: application/json: schema: $ref: '#/components/schemas/Validation' '400': description: Empty, malformed JSON, or unreadable body. content: application/json: schema: $ref: '#/components/schemas/Error' '413': description: Request or response exceeds bounds. content: application/json: schema: $ref: '#/components/schemas/Error' '415': description: Content-Type must be application/json. content: application/json: schema: $ref: '#/components/schemas/Error' '422': description: Invalid contract, incompatible coverage, or unsupported query. content: application/json: schema: $ref: '#/components/schemas/Error' '503': description: Data service unavailable. content: application/json: schema: $ref: '#/components/schemas/Error' components: schemas: DataRequest: type: object properties: variables: minItems: 1 maxItems: 1 type: array items: type: string enum: - air_temperature_max region: type: object properties: bbox: type: array prefixItems: - type: number minimum: -180 maximum: 180 - type: number minimum: -90 maximum: 90 - type: number minimum: -180 maximum: 180 - type: number minimum: -90 maximum: 90 items: false minItems: 4 maxItems: 4 crs: type: string const: EPSG:4326 required: - bbox - crs additionalProperties: false period: type: object properties: start: type: string format: date pattern: >- ^(?:(?:\d\d[2468][048]|\d\d[13579][26]|\d\d0[48]|[02468][048]00|[13579][26]00)-02-29|\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\d|30)|(?:02)-(?:0[1-9]|1\d|2[0-8])))$ end: type: string format: date pattern: >- ^(?:(?:\d\d[2468][048]|\d\d[13579][26]|\d\d0[48]|[02468][048]00|[13579][26]00)-02-29|\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\d|30)|(?:02)-(?:0[1-9]|1\d|2[0-8])))$ required: - start - end additionalProperties: false temporal_resolution: type: string const: daily spatial_resolution: type: string const: native units: type: object properties: air_temperature_max: type: string const: degC required: - air_temperature_max additionalProperties: false data_class: type: string const: interpolated_observation format: default: json type: string enum: - json - csv missing_policy: type: string const: preserve source_preference: type: string const: silo dataset_version: description: >- Pin an immutable published dataset version. Omit to choose a compatible public demo version. type: string pattern: ^[a-zA-Z0-9_-]{1,128}$ required: - variables - region - period - temporal_resolution - spatial_resolution - units - data_class - missing_policy - source_preference additionalProperties: false description: >- Data meaning is independent of representation and delivery. JSON (default) and CSV are returned inline. Bbox order: west,south,east,north; no antimeridian crossing. Date bounds inclusive; at most 31 days and 10,000 cells; actual coverage must pass resolve. dataset_version pins reproducibility. Validation: type: object required: - valid - request - coverageVerified - acquisitionEnabled - message properties: valid: const: true request: $ref: '#/components/schemas/DataRequest' coverageVerified: const: false acquisitionEnabled: const: false message: type: string Error: type: object properties: error: type: string message: type: string issues: type: array items: type: object properties: code: type: string path: type: array items: type: - string - number message: type: string required: - code - path - message additionalProperties: {} required: - error additionalProperties: {} ```` This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.