Json Query
Extract one bounded value from caller-supplied JSON using a deterministic simple path such as items[2].name or $.data.id. Forest performs no network request or model inference, returns an explicit found flag, and supports only dot object keys plus numeric array indexes so lookup behavior stays predictable.
Forest exposes this capability as a deterministic machine-readable API for software agents. Discovery is free; execution uses the canonical paid endpoint below. The live x402 challenge is the source of truth for payment terms.
Typical agent tasks
This capability is intended for bounded machine decisions such as:
- extract one nested field from this JSON response by a simple path
- look up items array index and object key without using an LLM
- check whether this JSON document contains a value at a known path
- read a deterministic field from an API response before the next agent step
What Forest guarantees
- lookup reads only caller-supplied JSON and never fetches a URL or invokes another capability
- paths are bounded to 512 characters and at most 64 simple key/index tokens
- object traversal reads own properties only and blocks prototype-related keys
- input JSON is bounded to 100 KiB when serialized as UTF-8
Boundaries
- full JSONPath, JMESPath, filtering, wildcard, expression or recursive-descent semantics
- keys containing dots/brackets or other characters outside the simple identifier grammar
- schema validation, type conversion or semantic interpretation of the returned value
Machine contract
The request and response schemas are published in the canonical OpenAPI document. This page shows a representative input from the same production manifest.
Input example
Canonical paid endpoint
Related capabilities
- Json Diff — Deep-compare two caller-supplied JSON values with deterministic object-key ordering and explicit index-based array semantics. Returns bounded added, removed and changed paths with primitive before/after values when safe; performs no network request, model inference, persistence or mutation.
- Json Validate — Validate caller-supplied JSON against Forest bounded JSON Schema subset v1 before an agent trusts or forwards structured output. Returns deterministic machine-readable violations with stable paths; performs no network request, remote $ref resolution, regex evaluation, model inference or mutation.
- Openapi Operation-resolve — Look up one exact HTTP method and path in a public OpenAPI or Swagger contract and report whether that documented API endpoint exists. This is a contract/endpoint existence check only; Forest reads the specification and never invokes the API operation.
- Openapi Payload-validate — Validate one caller-supplied JSON request or response payload against the documented JSON schema for one exact OpenAPI or Swagger operation. Forest fetches only the supplied public specification, never invokes the described API operation, resolves only bounded local references, and reuses the same deterministic schema subset as json.validate.