How AI is applied across API Evangelist and APIs.io. Read my AI disclosure →
API Evangelist API Evangelist
Discovery
Learnings
Guidance
Toolbox
Alignment
API Evangelist LLC
Discovery
Learnings
Guidance
Toolbox
Alignment
API Evangelist LLC

Need help?

Contact us
Cms

Centers for Medicare and Medicaid Services Metadata API

The metadata API from Centers for Medicare and Medicaid Services — 3 operation(s) for metadata.

Documentation Provider Profile APIs.io OpenAPI GitHub

This API exposes 3 operations across 3 paths, and defines 83 schemas. It is described by OpenAPI 3.2.0, at version 1.0.0.

Requests are made against the base URL https://bcda.cms.gov.

3 operations 3 paths 83 schemas 3 GET

Metadata

The identity and technical contract details declared by the specification.

Specification
OpenAPI 3.2.0
API Version
1.0.0
Base URL
https://bcda.cms.gov
Authentication
HTTP Basic, API Key
Contact
bcapi@cms.hhs.gov
License
Public Domain
Resource Areas
1

Authentication & Security 2

Centers for Medicare and Medicaid Services Metadata API declares 2 security schemes for authenticating requests. It accepts HTTP basic authentication (basic_auth). An API key is passed in the header as Authorization (bearer_token).

  • bearer_token — The Group and Patient endpoints require a Bearer Token. 1) Put your credentials in Basic Authentication, 2) Request a bearer token from /auth/token, 3) Put "Be…

Paths & Operations 3

Across 3 paths, the API surfaces 3 operations — 3 GET. Each is listed below with its method, path, parameters, and response codes.

Metadata 3
GET
/_version
Get API version
getVersion → 200
GET
/api/v1/metadata
Get metadata
metadata → 200
GET
/api/v2/metadata
Get metadata
metadatav2 → 200

Schemas 83

The contract defines 83 schemas that model the data the API accepts and returns. The most detailed are CapabilityStatement (35 properties), CapabilityStatement_Rest_Resource (18 properties), CapabilityStatement_Rest (11 properties), CapabilityStatement_Messaging_Event (10 properties). Each schema is shown below with its type and property counts.

ResourceVersionPolicyCode
object
See http://hl7.org/fhir/ValueSet/versioning-policy
3 properties
UsageContext
object
Auto-generated from StructureDefinition for UsageContext, last updated 2017-04-19T07:44:43.294+10:00. Describes the context of use for a conformance or knowled…
4 properties
CapabilityStatement
object
Auto-generated from StructureDefinition for CapabilityStatement, last updated 2017-04-19T07:44:43.294+10:00. A statement of system capabilities. See http://hl7…
35 properties
DocumentModeCode
object
See http://hl7.org/fhir/ValueSet/document-mode
3 properties
SystemRestfulInteractionCode
object
http://hl7.org/fhir/ValueSet/system-restful-interaction
3 properties
DateTime
object
Auto-generated from StructureDefinition for dateTime, last updated 2017-04-19T07:44:43.294+10:00. Primitive Type dateTime. See http://hl7.org/fhir/StructureDef…
5 properties
ReferenceHandlingPolicyCode_Value
integer
isUsageContext_Value_Value
object
UnknownContentCodeCode_Value
integer
LanguageCode
object
This value set includes common codes from BCP-47 (http://tools.ietf.org/html/bcp47) See http://hl7.org/fhir/ValueSet/languages Note: For historical reasons, th…
3 properties
Extension_ValueX
object
Value of extension
1 property
CapabilityStatement_Rest
object
If the endpoint is a RESTful one
11 properties
IdentifierUseCode_Value
integer
Primitive value for code
SystemRestfulInteractionCode_Value
integer
DocumentModeCode_Value
integer
RestfulCapabilityModeCode_Value
integer
Instant
object
Auto-generated from StructureDefinition for instant, last updated 2017-04-19T07:44:43.294+10:00. Primitive Type instant. See http://hl7.org/fhir/StructureDefin…
5 properties
CapabilityStatement_Rest_Resource_ResourceInteraction
object
5 properties
UnknownContentCodeCode
object
A code that indicates whether an application accepts unknown elements or extensions when reading resources. See http://hl7.org/fhir/ValueSet/unknown-content-co…
3 properties
Coding
object
Auto-generated from StructureDefinition for Coding, last updated 2017-04-19T07:44:43.294+10:00. A reference to a code defined by a terminology system. See http…
7 properties
EventCapabilityModeCode
object
See http://hl7.org/fhir/ValueSet/event-capability-mode
3 properties
ConditionalDeleteStatusCode
object
See http://hl7.org/fhir/ValueSet/conditional-delete-status
3 properties
isContainedResource_OneofResource
object
String
object
Auto-generated from StructureDefinition for string, last updated 2017-04-19T07:44:43.294+10:00. Primitive Type string. See http://hl7.org/fhir/StructureDefinit…
3 properties
Reference
object
A reference from one resource to another See https://www.hl7.org/fhir/datatypes.htmlReference
5 properties
ContactPointSystemCode_Value
integer
Primitive value for code
SearchParamTypeCode_Value
integer
Period
object
Auto-generated from StructureDefinition for Period, last updated 2017-04-19T07:44:43.294+10:00. Time range defined by start and end date/time. See http://hl7.o…
4 properties
Instant_Precision
integer
CodeableConcept
object
Auto-generated from StructureDefinition for CodeableConcept, last updated 2017-04-19T07:44:43.294+10:00. Concept - reference to a terminology or just text. See…
4 properties
ContactDetail
object
Auto-generated from StructureDefinition for ContactDetail, last updated 2017-04-19T07:44:43.294+10:00. Contact information. See http://hl7.org/fhir/StructureDe…
4 properties
ContainedResource
object
1 property
ConditionalReadStatusCode
object
See http://hl7.org/fhir/ValueSet/conditional-read-status
3 properties
NarrativeStatusCode
object
The status of a resource narrative See http://hl7.org/fhir/ValueSet/narrative-status
3 properties
NarrativeStatusCode_Value
integer
Code
object
Auto-generated from StructureDefinition for code, last updated 2017-04-19T07:44:43.294+10:00. Primitive Type code. See http://hl7.org/fhir/StructureDefinition/…
3 properties
ContactPoint
object
Auto-generated from StructureDefinition for ContactPoint, last updated 2017-04-19T07:44:43.294+10:00. Details of a Technology mediated contact point (phone, fa…
7 properties
CapabilityStatement_Rest_Security
object
Information about security of implementation
7 properties
Xhtml
object
Auto-generated from StructureDefinition for xhtml, last updated 2017-04-19T07:44:43.294+10:00. Primitive Type xhtml. See http://hl7.org/fhir/StructureDefinitio…
2 properties
ConditionalReadStatusCode_Value
integer
SearchParamTypeCode
object
See http://hl7.org/fhir/ValueSet/search-param-type
3 properties
CapabilityStatement_Messaging_Endpoint
object
Where messages should be sent
5 properties
MessageSignificanceCategoryCode_Value
integer
PositiveInt
object
Auto-generated from StructureDefinition for positiveInt, last updated 2017-04-19T07:44:43.294+10:00. Primitive Type positiveInt. See http://hl7.org/fhir/Struct…
3 properties
RestfulCapabilityModeCode
object
See http://hl7.org/fhir/ValueSet/restful-capability-mode
3 properties
CapabilityStatement_Messaging
object
If messaging is supported
8 properties
ReferenceHandlingPolicyCode
object
See http://hl7.org/fhir/ValueSet/reference-handling-policy
3 properties
CapabilityStatement_Rest_Resource
object
Resource served on the REST interface
18 properties
Uri
object
Auto-generated from StructureDefinition for uri, last updated 2017-04-19T07:44:43.294+10:00. Primitive Type uri. See http://hl7.org/fhir/StructureDefinition/uri
3 properties
CapabilityStatement_Document
object
Document definition
6 properties
ConditionalDeleteStatusCode_Value
integer
CapabilityStatement_Messaging_Event
object
Declare support for this event
10 properties
Extension
object
Optional Extensions Element See https://www.hl7.org/fhir/datatypes.htmlExtension
4 properties
EventCapabilityModeCode_Value
integer
isReference_Reference
object
IdentifierUseCode
object
See http://hl7.org/fhir/ValueSet/identifier-use
3 properties
CapabilityStatement_Implementation
object
If this describes a specific instance
5 properties
isExtension_ValueX_Choice
object
UnsignedInt
object
Auto-generated from StructureDefinition for unsignedInt, last updated 2017-04-19T07:44:43.294+10:00. Primitive Type unsignedInt. See http://hl7.org/fhir/Struct…
3 properties
UsageContext_Value
object
Value that defines the context
1 property
ContactPointSystemCode
object
Telecommunications form for contact point See http://hl7.org/fhir/ValueSet/contact-point-system
3 properties
CapabilityStatement_Rest_SystemInteraction
object
5 properties
Id
object
Auto-generated from StructureDefinition for id, last updated 2017-04-19T07:44:43.294+10:00. Primitive Type id. See http://hl7.org/fhir/StructureDefinition/id
3 properties
Meta
object
Auto-generated from StructureDefinition for Meta, last updated 2017-04-19T07:44:43.294+10:00. Metadata about a resource. See http://hl7.org/fhir/StructureDefin…
7 properties
ContactPointUseCode
object
Use of contact point See http://hl7.org/fhir/ValueSet/contact-point-use
3 properties
Identifier
object
Auto-generated from StructureDefinition for Identifier, last updated 2017-04-19T07:44:43.294+10:00. An identifier intended for computation. See http://hl7.org/…
8 properties
MessageSignificanceCategoryCode
object
See http://hl7.org/fhir/ValueSet/message-significance-category
3 properties
MimeTypeCode
object
See http://www.rfc-editor.org/bcp/bcp13.txt
3 properties
ResourceTypeCode_Value
integer
CapabilityStatement_Rest_Resource_SearchParam
object
Search parameters supported by implementation
7 properties
Markdown
object
Auto-generated from StructureDefinition for markdown, last updated 2017-04-19T07:44:43.294+10:00. Primitive Type markdown. See http://hl7.org/fhir/StructureDef…
3 properties
TypeRestfulInteractionCode_Value
integer
Base64Binary
object
Auto-generated from StructureDefinition for base64Binary, last updated 2017-04-19T07:44:43.294+10:00. Primitive Type base64Binary. See http://hl7.org/fhir/Stru…
3 properties
DateTime_Precision
integer
CapabilityStatement_Software
object
Software that is covered by this capability statement
6 properties
ContactPointUseCode_Value
integer
Primitive value for code
ResourceTypeCode
object
See http://hl7.org/fhir/ValueSet/resource-types
3 properties
ResourceVersionPolicyCode_Value
integer
Narrative
object
Auto-generated from StructureDefinition for Narrative, last updated 2017-04-19T07:44:43.294+10:00. A human-readable formatted text, including images. See http:…
4 properties
CapabilityStatement_Rest_Security_Certificate
object
Certificates associated with security profiles
5 properties
CapabilityStatement_Rest_Operation
object
Definition of an operation or a custom query
5 properties
TypeRestfulInteractionCode
object
See http://hl7.org/fhir/ValueSet/type-restful-interaction
3 properties
CapabilityStatement_Messaging_SupportedMessage
object
Messages supported by this system
5 properties

Specification

The full machine-readable OpenAPI contract behind this narrative.

Source

cms-metadata-api-openapi.yml Raw ↑
#Metadata
← Back to C APIs
API Details
ID
cms:cms-metadata-api
Base URL
https://bcda.cms.gov
Docs
https://bcda.cms.gov/
Provider
Cms
APIs.io →  GitHub →
Explore more
All APIs Providers APIs.io Network
Work with this as data

Every API here is available over the API and to AI agents over MCP. APIs is not yet its own endpoint on the v1 API. Reach this content through network search and the tag graph, or the MCP server below.

Installs https://mcp.apievangelist.com/mcp in Claude, Cursor, VS Code and the rest — one button, every client.

MCP tools for apis
4 tools reach this content
  • search_api_evangelistSearch every content type across the network at once.
  • find_relatedThe shared-tag relevance graph — what else covers this.
  • get_tagEverything one tag labels, across all content types.
  • guide_topicPRO — a curated bundle for a topic: area, guidance, rules, papers, stories, services.
All tools & prompts
Call it yourself
curl for this page
Search the network for this 
curl "https://api.apievangelist.com/v1/search?q=cms-metadata-api&limit=10"
Everything under a tag 
curl "https://api.apievangelist.com/v1/tags/cms-metadata-api"

Discovery needs no key. Full bodies and the synthesis endpoints are Pro.

Get an API key

Free tier, no email required. Sign in with whichever identity you already have.

GitHub Google LinkedIn

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

Where this information came from

This is an independent, third-party profile of Centers for Medicare and Medicaid Services Metadata API, published by API Evangelist. We do not operate, host, resell, or support these APIs, and we are not affiliated with or endorsed by the company unless stated above. Everything here is built from publicly available information — the company's own site, developer portal, documentation, public repositories, and the specifications it publishes for public use. Nothing is obtained by breaching a system, defeating an access control, or using credentials.

The Kin Score and Agent Readiness rating are independently calculated assessments of a company's public API artifacts, scored against a published rubric. They are not certifications, endorsements, security assessments, or audits.

Corrections, re-scores, and removal are free — no partnership or purchase required, and you do not need to justify the request. A removed company is recorded as unrated, never scored zero for having asked. Acknowledgement within one business day; removal within two.

info@apievangelist.com · Read the full data-sourcing policy →
On a security or compliance team? Put security in the subject line and you will get a person, not a form — we will tell you exactly which public URLs this profile was built from.