Developer Preview — Active Development

Graieva API

Powered by RIQ-Core™

License RIQ-Core™ v1.3 as a metered HTTP API. Embed mechanistic ruminant simulation, weight estimation, and herd analytics in your own products — without re-hosting the solver or managing tenant infrastructure.

Graieva API sandbox is live. Create keys in the developer console; production-tier endpoints require upgrade.

Mechanistic, not tabular

Embed RIQ-Core™ v1.3 in your product — hour-by-hour rumen dynamics, steady-state MCP, and mass-balance outputs without rebuilding a CNCPS-style factor engine.

Licensed access

API subscriptions are separate from Herd and Studio SaaS on Graieva. Metered tiers scale with your integration footprint.

Isolation by design

Each API organization receives isolated simulation cache boundaries. Proprietary feed payloads are not logged at rest or used to enrich global reference data without explicit opt-in.

Planned endpoint surface

Versioned under /v1/. OpenAPI documentation will ship with sandbox access. Exact request schemas mirror the Graieva web application responses — proprietary equation coefficients and internal solver steps are not exposed.

POST
/v1/simulate
Mechanistic simulation

Run the full mouth-to-rectum integrator for a diet schedule and kinetic profile. Returns steady-state pools, economics summary, optional trace windows, and mass-balance audit fields.

developer
production
enterprise
POST
/v1/wev
Weight estimation (WEV)

Batch inverse energy-balance solve across pens. Returns inferred body weight, confidence scores, and maintenance vs production energy partition.

developer
production
enterprise
GET
/v1/benchmarks
Regional benchmarks

Anonymized regional reference distributions (MCP, N digestibility) for comparing simulation outputs against aggregated herd performance.

developer
production
enterprise
GET
/v1/health
Health & version

Liveness probe and engine version metadata for uptime monitors and deployment pipelines.

developer
production
enterprise
POST
/v1/twin
Feed intelligence (Twin)

Cold-start kinetics inference from feed chemistry fingerprints using similarity search over anonymized reference embeddings.

production
enterprise
POST
/v1/audit
Portfolio audit

Rank pens by economic leakage and tag findings (drift, starch loss, N excretion) for consultant-style prioritization workflows.

production
enterprise
POST
/v1/compare
Model comparison

Side-by-side steady-state comparison between legacy CNCPS-class outputs and the current mechanistic release for validation studies.

production
enterprise
GET
/v1/equations
Equation registry

Metadata catalog of model pools and equation labels for audit documentation — not the proprietary coefficient registry.

production
enterprise
POST
/v1/simulate/batch
Async batch jobs

Enterprise async simulation and WEV batches with job IDs, progress polling, and webhook callbacks for large integrator pipelines.

enterprise

Authentication

API access uses long-lived bearer keys — no Supabase user session required. Keys are scoped to an API organization with its own billing and usage meters.

Authorization: Bearer <api_key>

Key format: gie_{environment}_{secret} · Environments: test (sandbox), live (production)

  • 401Invalid or revoked key
  • 402Billing inactive or Developer quota exhausted
  • 403Endpoint not included in your tier or environment
  • 429Rate limit exceeded — Retry-After header provided

Rate limits (planned)

Developer
30 req/min · 2 concurrent simulations
Sandbox keys; hard monthly call cap
Production
300 req/min · 20 concurrent simulations
Production keys; metered overage beyond included calls
Enterprise API
Custom throughput
Dedicated capacity and custom concurrency contracts

Responses will include X-RateLimit-Remaining and X-RateLimit-Reset headers.

API licensing tiers

Priced separately from Herd and Studio on Graieva. Studio customers may receive a bundle discount when linking an API organization — details at launch.

Developer

$199/mo

10,000 calls/mo included

Overage: $15/1k calls

Sandbox keys, /simulate and /wev, rate-limited, non-production SLA

Production

$990/mo

100,000 calls/mo included

Overage: $8/1k calls

Production API keys, full RIQ-Core endpoint suite, 99.5% SLA

Enterprise API

Contact sales

Custom volume

Dedicated capacity, custom regions, Biological Twin RPC, white-label options

Who it's for

  • Feed & ration software

    Embed mechanistic validation beside formulation UIs so nutritionists see dynamic consequences, not static factor tables alone.

  • Herd management platforms

    Push pen-average DMI and milk into WEV batch endpoints and surface confidence-weighted body weight back to the farm record.

  • Genetics & advisory networks

    Run portfolio-scale audit ranking across client sites without exporting sensitive chemistry into spreadsheets.

  • Research & validation

    Compare mechanistic outputs against legacy CNCPS baselines using the comparison endpoint for peer-reviewable studies.

Security & data handling

  • API keys stored as one-way hashes; plaintext shown once at issuance
  • Revocable keys with rotation support (grace period on replacement)
  • Request metadata logged (latency, endpoint family) — not proprietary feed payloads
  • Customer simulation inputs never written to Global Commons without contractual opt-in
  • TLS 1.2+ in transit; organization-scoped cache isolation

Rollout roadmap

Now
  • ·Sandbox + Production endpoints
  • ·Developer console
  • ·Stripe checkout for Production tier
Next
  • ·Metered overage billing
  • ·Enterprise batch jobs
  • ·Webhook callbacks
Later
  • ·Redis rate limiting
  • ·SDKs (Python/TypeScript)
  • ·Dedicated regions
Developer Preview

Building an integration?

Join the design-partner waitlist for sandbox keys and early OpenAPI access. We're prioritizing feed software, herd platforms, and genetics integrators.

support@graieva.com