Vital

Vital Aggregate API

The Aggregate API from Vital — 3 operation(s) for aggregate.

GitHub OpenAPI

Operations 3

Each operation below carries the questions people ask an LLM about it and the instructions they give an agent to run it. Generated by API Evangelist overlay

POST /aggregate/v1/user/{user_id}/query Run an aggregate query over a user's data · Query One #
Ask an LLM
“Can I run a custom aggregation over one user's health data for a set timeframe?”
“What kinds of queries can I bundle into a single aggregate request for a user?”
Tell an agent
Run aggregate queries {queries} for user {user} over timeframe {timeframe}.
Aggregate {user}'s data across {timeframe} with the queries I describe.
GET /aggregate/v1/user/{user_id}/continuous_query/{query_id_or_slug}/result_table Get a continuous query's result table · Get Result Table For Query #
Ask an LLM
“Where can I read the latest output table of a continuous query set up for a user?”
“Is the output of a continuous aggregate query available as a table?”
Tell an agent
Fetch the result table for continuous query {query} on user {user}.
Show what continuous query {query} has produced for {user} so far.
GET /aggregate/v1/user/{user_id}/continuous_query/{query_id_or_slug}/task_history List a continuous query's past runs · Get Task History For Query #
Ask an LLM
“Can I see when a user's continuous query last ran and whether it succeeded?”
“Which past executions exist for a continuous query, and can I page through them?”
Tell an agent
List the task history for continuous query {query} on user {user}.
Show the last {limit} runs of continuous query {query} for {user}, starting at cursor {cursor}.

Documentation

📖
Documentation
https://docs.junction.com/api-details/junction-api
📖
Documentation
https://docs.junction.com/wearables/providers/introduction
📖
Documentation
https://docs.junction.com/api-details/junction-management-api

Specifications

⚙
OpenAPI
https://raw.githubusercontent.com/api-evangelist/vital-io/refs/heads/main/openapi/vital-io-aggregate-api-openapi.yml

Schemas & Data

📊
JSONSchema
https://raw.githubusercontent.com/api-evangelist/vital-io/refs/heads/main/json-schema/vital-user-schema.json
📊
JSONSchema
https://raw.githubusercontent.com/api-evangelist/vital-io/refs/heads/main/json-schema/vital-provider-schema.json
📊
JSONSchema
https://raw.githubusercontent.com/api-evangelist/vital-io/refs/heads/main/json-schema/vital-sleep-summary-schema.json
📊
JSONSchema
https://raw.githubusercontent.com/api-evangelist/vital-io/refs/heads/main/json-schema/vital-activity-summary-schema.json
📊
JSONSchema
https://raw.githubusercontent.com/api-evangelist/vital-io/refs/heads/main/json-schema/vital-heart-rate-timeseries-schema.json
📊
JSONSchema
https://raw.githubusercontent.com/api-evangelist/vital-io/refs/heads/main/json-schema/vital-lab-order-schema.json
📊
JSONSchema
https://raw.githubusercontent.com/api-evangelist/vital-io/refs/heads/main/json-schema/vital-lab-result-schema.json

Other Resources

🔗
Examples
https://raw.githubusercontent.com/api-evangelist/vital-io/refs/heads/main/examples/vital-create-user-example.json
🔗
Examples
https://raw.githubusercontent.com/api-evangelist/vital-io/refs/heads/main/examples/vital-link-token-example.json
🔗
Examples
https://raw.githubusercontent.com/api-evangelist/vital-io/refs/heads/main/examples/vital-sleep-summary-example.json
🔗
Examples
https://raw.githubusercontent.com/api-evangelist/vital-io/refs/heads/main/examples/vital-heart-rate-timeseries-example.json
🔗
Examples
https://raw.githubusercontent.com/api-evangelist/vital-io/refs/heads/main/examples/vital-create-order-example.json
🔗
Examples
https://raw.githubusercontent.com/api-evangelist/vital-io/refs/heads/main/examples/vital-lab-result-example.json

Work with this as data

Every API here is available over the APIs.io API and to AI agents over MCP.

MCP server

One button, every client — Claude, Cursor, VS Code and the rest.

https://apis.io/mcp

Tools for apis

7 MCP tools reach this
  • find_apisBrowse and filter every API in the catalog.
  • get_api_artifactsOne API's artifacts, grouped by type.
  • get_openapiThe primary OpenAPI for this API.
  • find_similar_apisAPIs that look like this one.
  • apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.
  • resolveTurn a domain, URL or GitHub org into the provider it belongs to.
  • find_cohortsEvery scored population of providers in the catalog.
All 92 tools →

Call it yourself

curl for this page
This API 
curl "https://apis.io/api/v1/apis/vital-io:vital-io-aggregate-api"
All apis 
curl "https://apis.io/api/v1/apis?limit=25"

Discovery needs no key. Ratings and market analysis are Pro.

Get an API key

Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.

GitHub Google LinkedIn

A second provider on the same verified email joins the account you already have.

OpenAPI Specification

vital-io-aggregate-api-openapi.yml Raw ↑ 
openapi: 3.2.0
info:
  title: Vital Io Aggregate API
  version: '1.0'
  description: 'Operations tagged Aggregate across 2 of this provider''s published API definitions: junction-openapi-live-2026-10-12.json, vital-openapi-original.json. Each path carries the servers of the definition it was published in.'
servers:
- url: https://api.us.junction.com
  x-fern-server-name: Production
- url: https://api.eu.junction.com
  x-fern-server-name: ProductionEU
- url: https://api.sandbox.us.junction.com
  x-fern-server-name: Sandbox
- url: https://api.sandbox.eu.junction.com
  x-fern-server-name: SandboxEU
security:
- apiKeyAuth: []
tags:


# --- truncated at 32 KB (58 KB total) ---
# Full source: https://raw.githubusercontent.com/api-evangelist/vital-io/refs/heads/main/openapi/vital-io-aggregate-api-openapi.yml