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/advancedmd-observation-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.
A second provider on the same verified email joins the account you already have.
openapi: 3.2.0
info:
version: 6.1.0
title: FHIR Single API - US Core 6.1.0 Observation API
description: Fast Healthcare Interoperability Resources (HL7® FHIR®, pronounced "Fire") defines a set of "Resources" that represent granular clinical concepts.
x-fhir-version: 4.0.1
x-us-core-version: 6.1.0
servers:
- url: https://providerapi.advancedmd.com/v1/r4
security:
- bearerAuth: []
tags:
- name: Observation
paths:
/Observation:
get:
tags:
- Observation
description: 'This interaction searches a set of Observations based on some filter criteria. Search interactions take a series of query parameters for a GET.
📘 FHIR documentation for Observation.
🛡️ **Authorization behavior:**
- **Patients** (using `patient/*.read` scope) can access only their own resources.
- **Practitioners** (using `patient/*.read` scope) can access to only one assigned patient.
- **Practitioners** (using `user/*.read` scope) must provide the `patient` query parameter to access another patient''s data.'
parameters:
- name: patient
in: query
description: The subject that the observation is about (if patient)
schema:
type: string
examples:
patient_id:
summary: Logical patient id
value: '6077169'
patient_reference:
summary: Relative Patient reference
value: Patient/6077169
- name: category
in: query
description: 'The classification of the observation. Common US Core Observation profile categories include:
- `laboratory` — US Core Laboratory Result Observation Profile
- `vital-signs` — US Core Vital Signs Profile (Blood Pressure, BMI, Body Height/Weight/Temperature, Head Circumference, Heart Rate, Pulse Oximetry, Respiratory Rate, and pediatric profiles)
- `social-history` — US Core Observation Occupation, Sexual Orientation, Smoking Status profiles
- `survey` — US Core Observation Screening Assessment, Pregnancy Intent/Status profiles
For screening and assessment use cases, US Core supports additional category values in addition to `survey`, including:
- `sdoh` - SDOH Assessment
- `functional-status` - Functional Status
- `disability-status` - Disability Status
- `cognitive-status` - Mental/Cognitive Status
'
schema:
type: string
example: laboratory
- name: code
in: query
description: 'The LOINC or SNOMED code of the observation type. Use token syntax `{system}|{code}` to specify a code system, or just the code value alone.
Common US Core Observation LOINC codes organized by profile:
**Vital Signs:**
- `8867-4` — Heart rate
- `8310-5` — Body temperature
- `8302-2` — Body height
- `29463-7` — Body weight
- `39156-5` — BMI
- `2708-6` — Oxygen saturation
- `9279-1` — Respiratory rate
- `85354-9` — Systolic and Diastolic BP
**Laboratory Results:**
- `2345-7` — Glucose (serum/plasma)
- `2951-2` — Sodium
**Social History:**
- `72166-2` — Smoking status
- `11341-5` — Occupation
**Sexual Orientation (US Core 6.1.0):**
- `76690-7` — Sexual orientation
**Pregnancy (US Core 6.1.0):**
- `82810-3` — Pregnancy status
- `76438-3` — Pregnancy intent
'
schema:
type: string
examples:
loinc_code_only:
value: 8867-4
description: Heart rate only
loinc_with_system:
value: http://loinc.org|8867-4
description: Heart rate with LOINC system
sexual_orientation:
value: http://loinc.org|76690-7
description: Sexual orientation (6.1.0)
pregnancy_status:
value: http://loinc.org|82810-3
description: Pregnancy status (6.1.0)
- name: date
in: query
description: Clinically relevant date/time of the observation. Supports prefixes `eq`, `lt`, `gt`, `ge`, `le` (e.g. `ge2024-01-01`). If the obtained element is a period, matches any date that falls within the period.
schema:
type: string
format: date
example: '2024-06-01'
- name: status
in: query
description: 'The status of the observation. Required for the `patient + category + status` SHALL search combination. Allowed values: `registered`, `preliminary`, `final`, `amended`, `corrected`, `cancelled`, `entered-in-error`, `unknown`.
'
schema:
type: string
enum:
- registered
- preliminary
- final
- amended
- corrected
- cancelled
- entered-in-error
- unknown
example: final
responses:
'200':
description: Success
content:
application/fhir+json;charset=utf-8:
schema:
type: array
items:
$ref: '#/components/schemas/Observation'
'401':
description: Unauthorized
content:
application/json:
schema:
$ref: '#/components/schemas/Error'
summary: Get observation
x-summary-source: derived
operationId: getObservation
x-operation-id-source: derived
/Observation/{id}:
get:
tags:
- Observation
description: 'This interaction searches Observation based on observation id.Search interactions take observation id in path for a GET.
📘 FHIR documentation for Observation.
🛡️ **Authorization behavior:**
- **Patients** (using `patient/*.read` scope) can access only their own resources.
- **Practitioners** (using `patient/*.read` scope) can access to only one assigned patient.
- **Practitioners** (using `user/*.read` scope) must provide the `patient` query parameter to access another patient''s data.'
parameters:
- name: id
in: path
description: The logical resource id associated with the Resource.
required: true
schema:
type: integer
example: 153649902
- name: patient
in: query
description: Patient ID to filter the search.
schema:
type: integer
example: 6077169
responses:
'200':
description: Success
content:
application/fhir+json;charset=utf-8:
schema:
$ref: '#/components/schemas/Observation'
'401':
description: Unauthorized
content:
application/json:
schema:
$ref: '#/components/schemas/Error'
'403':
description: Forbidden
content:
application/json:
schema:
$ref: '#/components/schemas/Error'
summary: Get observation by id
x-summary-source: derived
operationId: getObservationById
x-operation-id-source: derived
/Observation/_search:
post:
tags:
- Observation
description: 'This interaction searches a set of Observations based on some filter criteria. Search interactions take a series of parameters of name''''=''''value pairs encoded as an application/x-www-form-urlencoded submission for a POST.
📘 FHIR documentation for Observation.
🛡️ **Authorization behavior:**
- **Patients** (using `patient/*.read` scope) can access only their own resources.
- **Practitioners** (using `patient/*.read` scope) can access to only one assigned patient.
- **Practitioners** (using `user/*.read` scope) must provide the `patient` parameter (in the request body) to access another patient''s data.'
operationId: Observations Search using POST
requestBody:
content:
application/x-www-form-urlencoded:
schema:
type: object
properties:
patient:
type: integer
description: The subject that the observation is about (if patient)
example: 6077169
category:
type: string
description: 'The classification of the observation. Common US Core profiles use `laboratory`, `vital-signs`, `social-history`, `survey`, `exam`, `procedure`.
Additional category values include `sdoh`, `functional-status`, `disability-status`, and `cognitive-status`.
'
example: laboratory
code:
type: string
description: 'The LOINC or SNOMED code of the observation type. Use token syntax `{system}|{code}` to specify a code system.
Common US Core codes: vital signs (8867-4 heart rate, 8310-5 temperature, 8302-2 height, 29463-7 weight, 39156-5 BMI, 85354-9 BP), labs (2345-7 glucose, 2951-2 sodium), social history (72166-2 smoking status, 11341-5 occupation), sexual orientation (76690-7), pregnancy (82810-3 status, 76438-3 intent).
'
example: http://loinc.org|8867-4
date:
type: string
format: date
description: Clinically relevant date/time of the observation. Supports prefixes `eq`, `lt`, `gt`, `ge`, `le`. If the obtained element is a period, matches any date that falls within the period.
example: '2024-06-01'
status:
type: string
description: 'The status of the observation. Required for the `patient + category + status` SHALL search combination. Allowed values: `registered`, `preliminary`, `final`, `amended`, `corrected`, `cancelled`, `entered-in-error`, `unknown`.'
enum:
- registered
- preliminary
- final
- amended
- corrected
- cancelled
- entered-in-error
- unknown
example: final
required:
- patient
responses:
'200':
description: Observation bundle
content:
application/fhir+json;charset=utf-8:
schema:
type: array
items:
$ref: '#/components/schemas/Observation'
'401':
description: Unauthorized
content:
application/json:
schema:
$ref: '#/components/schemas/Error'
summary: Observations search using POST
x-summary-source: derived
components:
schemas:
Error:
required:
- text
- issue
type: object
properties:
resourceType:
minLength: 1
type: string
text:
required:
- div
- status
type: object
properties:
status:
minLength: 1
type: string
div:
minLength: 1
type: string
issue:
type: array
items:
required:
- severity
- code
- diagnostics
type: object
properties:
severity:
minLength: 1
type: string
code:
minLength: 1
type: string
diagnostics:
minLength: 1
type: string
Observation:
x-us-core-profiles:
- http://hl7.org/fhir/us/core/StructureDefinition/us-core-observation-lab
- http://hl7.org/fhir/us/core/StructureDefinition/us-core-observation-clinical-result
- http://hl7.org/fhir/us/core/StructureDefinition/pediatric-bmi-for-age
- http://hl7.org/fhir/us/core/StructureDefinition/pediatric-weight-for-height
- http://hl7.org/fhir/us/core/StructureDefinition/head-occipital-frontal-circumference-percentile
- http://hl7.org/fhir/us/core/StructureDefinition/us-core-body-height
- http://hl7.org/fhir/us/core/StructureDefinition/us-core-body-temperature
- http://hl7.org/fhir/us/core/StructureDefinition/us-core-body-weight
- http://hl7.org/fhir/us/core/StructureDefinition/us-core-bmi
- http://hl7.org/fhir/us/core/StructureDefinition/us-core-heart-rate
- http://hl7.org/fhir/us/core/StructureDefinition/us-core-pulse-oximetry
- http://hl7.org/fhir/us/core/StructureDefinition/us-core-respiratory-rate
- http://hl7.org/fhir/us/core/StructureDefinition/us-core-blood-pressure
- http://hl7.org/fhir/us/core/StructureDefinition/us-core-smokingstatus
required:
- category
- code
- effectiveDateTime
- encounter
- id
- meta
- resourceType
- status
- subject
- text
- valueQuantity
type: object
properties:
resourceType:
minLength: 1
type: string
id:
minLength: 1
type: string
text:
required:
- div
- status
type: object
properties:
status:
minLength: 1
type: string
div:
minLength: 1
type: string
status:
minLength: 1
type: string
category:
minItems: 1
uniqueItems: true
type: array
items:
type: object
properties:
coding:
minItems: 1
uniqueItems: true
type: array
items:
required:
- code
- display
- system
type: object
properties:
system:
minLength: 1
type: string
code:
minLength: 1
type: string
display:
minLength: 1
type: string
code:
required:
- coding
type: object
properties:
coding:
minItems: 1
uniqueItems: true
type: array
items:
required:
- code
- display
- system
type: object
properties:
system:
minLength: 1
type: string
code:
minLength: 1
type: string
display:
minLength: 1
type: string
subject:
required:
- reference
type: object
properties:
reference:
minLength: 1
type: string
encounter:
required:
- reference
type: object
properties:
reference:
minLength: 1
type: string
effectiveDateTime:
minLength: 1
type: string
valueQuantity:
required:
- code
- system
- unit
- value
type: object
properties:
value:
type: number
unit:
minLength: 1
type: string
system:
minLength: 1
type: string
code:
minLength: 1
type: string
meta:
required:
- tag
type: object
properties:
tag:
minItems: 1
uniqueItems: true
type: array
items:
required:
- code
- display
- system
type: object
properties:
system:
minLength: 1
type: string
code:
minLength: 1
type: string
display:
minLength: 1
type: string
description: ''
securitySchemes:
bearerAuth:
type: http
scheme: bearer
bearerFormat: JWT
externalDocs:
description: HL7 FHIR US Core IG STU 6.1.0
url: https://hl7.org/fhir/us/core/STU6.1/