API unavailableAPI v1JSON over HTTPS

Sinuosity developer platform

Physical intelligence, ready to query.

Build with GhanaAgData, GhanaAgBench and bounded MaizeGuard model metadata through a provenance-forward API designed for research and real products.

Try the live API Open API reference

Access: API-keyed
Formats: JSON + file links
Images: Not stored by default

export SINUOSITY_API_KEY="your_key"

curl "https://www.sinuosity.ai/api/v1/datasets?limit=10" \
  -H "Authorization: Bearer $SINUOSITY_API_KEY"

One interface, explicit evidence

From published artifact to usable building block.

The API adds a stable query layer without hiding source rights, release status or evidence boundaries.

Datasets

Query Ghana agricultural observations

Filter normalized observations by crop, metric, source, year, region, district and quality flag.

Rows + provenance

Benchmarks

Run reproducible GhanaAgBench experiments

Retrieve task metadata and fixed split rows without manually unpacking release repositories.

Tasks + split rows

Models

Integrate bounded maize screening

Read model manifests and call a safety-limited image endpoint when the reviewed runtime is available.

Screening + warnings

Live API workbench

Make a real request.

Start with the public health endpoint, or enter an API key for catalog, dataset and model routes. Keys stay in this page's memory and are never persisted.

GEThttp://127.0.0.1:54258/api/v1/health

{
  "error": "workbench_network_error",
  "message": "The request could not reach the API."
}

Quickstarts

First response in under a minute.

Use bearer authentication for scoped routes. Every authenticated response includes request and rate-limit headers for operational debugging.

catalog:readReleases, datasets, models and task metadata
datasets:readFiles, schemas, provenance and query rows
models:inferBounded MaizeGuard screening

curl "https://www.sinuosity.ai/api/v1/crop-observations?crop=maize&metric=yield&limit=5" \
  -H "Authorization: Bearer $SINUOSITY_API_KEY"

Endpoint directory

A small, coherent v1 surface.

Live base URLhttps://www.sinuosity.ai/api/v1Canonical after DNS verificationhttps://api.sinuosity.ai/v1

GET/health

Service readiness, index state and model-runtime availability.

System

public

GET/

Versioned API discovery, resources, scopes and safety boundary.

System

public

GET/releases

Paginated public release records and evidence boundaries.

Catalog

catalog:read

GET/datasets

Paginated dataset summaries with licenses, citations and repository links.

Datasets

catalog:read

GET/datasets/{dataset_id}

Dataset detail, access notes and related resource links.

Datasets

catalog:read

GET/datasets/{dataset_id}/files

Hugging Face download URLs, file roles, sizes and checksums.

Datasets

datasets:read

GET/datasets/{dataset_id}/schema

Repository, registry, observation and benchmark schemas.

Datasets

datasets:read

GET/datasets/{dataset_id}/provenance

Source records, license status and redistribution gates.

Datasets

datasets:read

GET/crop-observations

Filtered GhanaAgData crop observations with pagination.

Datasets

datasets:read

GET/ghana-ag-bench/tasks

GhanaAgBench task metadata and fixed split definitions.

Benchmarks

catalog:read

GET/ghana-ag-bench/rows

Filtered benchmark rows for reproducible experiments.

Benchmarks

datasets:read

GET/models

Paginated published model records and runtime status.

Models

catalog:read

GET/models/{model_id}

Model manifest, warnings, license status and safety boundary.

Models

catalog:read

POST/models/okuafo-maizeguard-edge-v1-4/screen

One-image, bounded maize-leaf screening for human review.

Models

models:infer

Dataset recipes

Useful paths through the commons.

Query rows when you need structured subsets. Use Hugging Face file links for full published payloads and preserve the citation returned by the API.

Find maize yield observations

Use filters for a compact JSON page, then follow each provenance URI back to its source record.

/crop-observations?crop=maize&metric=yield

Verify source permissions

Inspect redistribution status, source URLs, sensitivity class and license notes before reuse.

/datasets/ghana-crop-statistics/provenance

Download complete releases

List versioned Hugging Face links and SHA-256 checksums instead of streaming large files through the API.

/datasets/ghana-ag-bench/files

Load a benchmark split

Filter fixed GhanaAgBench rows by split, crop, region, district or year range.

/ghana-ag-bench/rows?split=test&crop=maize

Responsible use

Boundaries are part of the interface.

Dataset responses carry license, citation, provenance and redistribution notes. Public API access does not imply complete national coverage or a blanket rights grant over third-party sources.

Okuafo MaizeGuard Edge v1.4 is a research-preview screening artifact. It does not return treatment, pesticide product, dosage or autonomous agronomy advice. When inference is unavailable, the API returns maizeguard_runtime_not_configured instead of fabricating a result.

Read the data-governance policy

Operational contract

Errors you can build around.

All errors use the same JSON shape and include an X-Request-ID for troubleshooting.

401missing_api_key

No bearer token or X-API-Key was supplied.

403insufficient_scope

The key is valid but lacks the route scope.

404dataset_not_found

The requested public artifact does not exist.

429rate_limit_exceeded

Retry after the returned reset interval.

503index_unavailable

The read-only public index is not ready.

503maizeguard_runtime_not_configured

Screening is intentionally unavailable on this deployment.

Build with Sinuosity

Start with the data. Keep the evidence attached.

Request API access Download OpenAPI JSON