PARTNER API

One external API contract.

Every partner endpoint lives under https://www.vetios.tech/api/v1 and authenticates with a Bearer vios_k1_ partner key. The OpenAPI document, this page, the docs, and the SDK are all generated from the same contract definition.

OverviewCIRE StandardModel CardsDevelopersPassive SignalsNetwork LearningPopulation IntelligencePetPassEdge Box
OpenAPI YAMLJSON contractOpen console
Contract version
1.0.0
Endpoints
10
Base URL
https://www.vetios.tech/api/v1

Authentication models

partner_apiexternal contract

https://www.vetios.tech/api/v1/**

Authorization: Bearer vios_k1_...

  • SHA-256 hashed at rest
  • scoped
  • expiry and revocation
  • bound to one partner and plan
  • per-minute rate limit and monthly quota
  • usage audit trail
browser_applicationnot for integrations

VetIOS web console pages and their same-origin API calls

Supabase session cookie

  • interactive user sessions only
  • not supported for integrations
internal_servicenot for integrations

Internal routes under /api/* outside /api/v1 (console, scheduled jobs, internal agents)

Internal credentials issued and operated by VetIOS; not available to partners

  • service accounts and connector installations operated by VetIOS
  • not a partner contract; external use is deprecated

Endpoints

POST/api/v1/inference/differentialscope: inference

Run a structured veterinary differential diagnosis request.

curl -X POST https://www.vetios.tech/api/v1/inference/differential \
  -H "Authorization: Bearer $VETIOS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"species":"canine","breed":"mixed breed","age_years":0.42,"weight_kg":6.2,"sex":"male_intact","region":"Nairobi","presenting_signs":["lethargy","anorexia","vomiting","bloody diarrhea","dehydration"],"history":{"duration_days":2,"progression":"acute","owner_observations":["Lethargy and anorexia began first","Repeated vomiting and hemorrhagic diarrhea followed within a day"]},"preventive_history":{"vaccination_status":"incomplete","deworming_history":"unknown"},"diagnostic_tests":{"cbc":{"leukopenia":"present","neutropenia":"present"}}}'
POST/api/v1/inference/drug-checkscope: inference

Check species-aware medication safety and interaction risk.

curl -X POST https://www.vetios.tech/api/v1/inference/drug-check \
  -H "Authorization: Bearer $VETIOS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"inference_event_id":"11111111-1111-4111-8111-111111111111","context":{"resource_profile":"advanced","regulatory_region":"KE","comorbidities":["chronic kidney disease"],"lab_flags":["elevated creatinine"]}}'
POST/api/v1/inference/adversarialscope: simulation

Run adversarial or boundary-condition inference simulation.

curl -X POST https://www.vetios.tech/api/v1/inference/adversarial \
  -H "Authorization: Bearer $VETIOS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"request_id":"22222222-2222-4222-8222-222222222222","steps":8,"mode":"adaptive","base_case":{"species":"feline","symptoms":["dyspnea","open mouth breathing"],"metadata":{"scenario":"conflicting_temperature"}}}'
POST/api/v1/outcomes/contributescope: outcomes

Attach an outcome report with explicit evidence and reviewer provenance to a prior inference.

curl -X POST https://www.vetios.tech/api/v1/outcomes/contribute \
  -H "Authorization: Bearer $VETIOS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"request_id":"33333333-3333-4333-8333-333333333333","inference_event_id":"11111111-1111-4111-8111-111111111111","outcome":{"type":"diagnosis_confirmed","payload":{"label":"Canine parvoviral enteritis","confidence":0.99,"label_type":"lab_confirmed","reviewer_exposure":"unknown","verification_context":{"schema_version":"outcome-verification-context-v1","testing":{"decision":"performed","reason":"Diagnostic verification requested at presentation."},"reference_standard":{"name":"Laboratory report","evidence_refs":["44444444-4444-4444-8444-444444444444"]},"specimen_timing":"unknown"},"lab_result_id":"44444444-4444-4444-8444-444444444444"},"timestamp":"2026-06-06T12:00:00.000Z"}}'
GET/api/v1/dataset/prevalencescope: dataset

Read de-identified regional prevalence aggregates.

curl -X GET https://www.vetios.tech/api/v1/dataset/prevalence \
  -H "Authorization: Bearer $VETIOS_API_KEY"
GET/api/v1/models/cardscope: inference

Read the active model card and trust posture for partner review.

curl -X GET https://www.vetios.tech/api/v1/models/card \
  -H "Authorization: Bearer $VETIOS_API_KEY"
POST/api/v1/petpass/syncscope: petpass

Push a de-identified visit summary into a PetPass timeline.

curl -X POST https://www.vetios.tech/api/v1/petpass/sync \
  -H "Authorization: Bearer $VETIOS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"owner_account_id":"55555555-5555-4555-8555-555555555555","pet_id":"66666666-6666-4666-8666-666666666666","visit_date":"2026-06-06T09:30:00.000Z","summary":"Annual wellness exam completed.","diagnoses":["healthy adult examination"],"next_appointment":"2027-06-06T09:30:00.000Z"}'
GET/api/v1/petpass/history/{pet_id}scope: petpass

Retrieve a PetPass health timeline for a linked pet.

curl -X GET https://www.vetios.tech/api/v1/petpass/history/{pet_id} \
  -H "Authorization: Bearer $VETIOS_API_KEY"
GET/api/v1/usage/quotascope: usage

Read current API quota use and projected monthly consumption.

curl -X GET https://www.vetios.tech/api/v1/usage/quota \
  -H "Authorization: Bearer $VETIOS_API_KEY"
GET/api/v1/usage/analyticsscope: usage

Read endpoint, error, latency, and billable usage analytics.

curl -X GET https://www.vetios.tech/api/v1/usage/analytics \
  -H "Authorization: Bearer $VETIOS_API_KEY"
Self-serve onboarding

Request partner access

Submit a partner use case and requested products. The admin control plane can approve it and mint a scoped machine credential.