Skip to main content
U.S. flag

An official website of the United States government

Return to Search

Overview of Steps for Accessing Claims Data

Guidance for the Overview of Steps for Accessing Claims Data

Final

Issued by: Centers for Medicare & Medicaid Services (CMS)

Issue Date: January 01, 2020

Accessing Claims Data of document at the highest possible point.--> var utag_data = { } of document below DataLayer snippet . The utag.sync.js script should run as early as possible --> (function(a,b,c,d) { a='https://tags.tiqcdn.com/utag/cmsgov/cms-ab2d/prod/utag.js'; b=document;c='script';d=b.createElement(c);d.src=a;d.type='text/java'+c;d.async=true; a=b.getElementsByTagName(c)[0];a.parentNode.insertBefore(d,a); } )(); /** window.ga=window.ga||function(){(ga.q=ga.q||[]).push(arguments)};ga.l=+new Date; ga('create', 'UA-133491498-1', 'auto'); // Implementing the following trackers via auto track // https://github.com/googleanalytics/autotrack ga('require', 'eventTracker'); ga('require', 'impressionTracker'); ga('require', 'mediaQueryTracker'); ga('require', 'maxScrollTracker'); ga('require', 'outboundLinkTracker'); ga('require', 'urlChangeTracker'); ga('require', 'pageVisibilityTracker'); // send the pageview ga('send', 'pageview'); **/ function isIE() { return (/MSIE (\d+\.\d+);/.test(navigator.userAgent) || navigator.userAgent.indexOf("Trident/") > -1 ); }

Image

Accessing Claims Data

let scrollLock = false; const stepMappings = { 'step-1-icon': 'step-1-content', 'step-2-icon': 'step-2-content', 'step-3-icon': 'step-3-content', 'step-4-icon': 'step-4-content' }; $(document).ready(function() { const offset = 100; $('.step-accessing-claims').on('click', function(event) { scrollLock = true; highlightNav($(this), true); }); $(window).scroll(function() { if(scrollLock) { return; } if($(this).scrollTop() < $('#step-2-content').offset().top - offset) { highlightNav($('#step-1-icon'), false); } else if($(this).scrollTop() >= $('#step-2-content').offset().top - offset && $(this).scrollTop() < $('#step-3-content').offset().top - offset) { highlightNav($('#step-2-icon'), false); } else if($(this).scrollTop() >= $('#step-3-content').offset().top - offset && $(this).scrollTop() < $('#step-4-content').offset().top - offset) { highlightNav($('#step-3-icon'), false); } else if($(this).scrollTop() >= $('#step-4-content').offset().top - offset) { highlightNav($('#step-4-icon'), false); } }); function highlightNav(id, doScroll) { const stepId = id.attr('id'); const idToShow = stepMappings[stepId]; $('.step-accessing-claims').each(function() { $(this).removeClass('step-accessing-claims-active').addClass('step-accessing-claims-nonactive'); $(this).find('.step-claims-dash').hide(); }); id.removeClass('step-accessing-claims-nonactive').addClass('step-accessing-claims-active'); id.find('.step-claims-dash').show(); if(doScroll) { $('html, body').animate({ scrollTop: $('#' + idToShow).offset().top - offset + 2 }, 1000, function() { scrollLock = false; }); } } $('.card-header').on('click', function(event) { $(this).parent().find('.card-expand').toggleClass('icon-flipped'); }); if (isIE()) { const elements = $('.step-claims-menu'); Stickyfill.add(elements); } });
Step 1
Step 2
Step 3
Step 4
Step 1
Attestation
Overview

In order to access Medicare Parts A and B claims data, a Prescription Drug Plan (PDP) Sponsor must first complete the attestation process for each of their participating Prescription Drug Plan (PDP) Sponsor contracts. During this process, a Prescription Drug Plan (PDP) Sponsor formally reviews and agrees to comply with the Claims Data Usage Protocols . These protocols regulate how their organization may or may not use the Medicare claims data provided by the AB2D API, including limitations associated with the reuse and disclosure of the data.

attestation
What type of organizations can attest?
expand_more
Stand-alone Medicare Part D Plan (PDP) sponsors (PACE and MAPD are not eligible).
Who can attest?
expand_more
  • Attestation must be performed by a Medicare Part D Plan (PDP) Sponsor CEO, CFO, or COO.
  • An Attestor must hold an active CEO, CFO, or COO role within their organization.
  • Part D Plan (PDP) sponsors can have multiple executives attest to each of their participating contracts. This is considered best practice and is strongly encouraged.
How does attestation affect claims data?
expand_more
  • Attested Part D Plan (PDP) sponsors are able to retrieve claims data for active plan enrollees from the date of attestation onwards. Claims data prior to the attestation date will not be provided.
  • Participating Part D Plan (PDP) sponsors must have an active Attestor at all times and will not receive data during periods where the (PDP) sponsor does not have an active Attestor. Data access will be restored once another active CEO, CFO, or COO attests. We highly recommend that Part D Plan (PDP) sponsors have multiple executives attest to contracts to reduce the risk of lapses in access to data based on attestation status.
How to initially attest
expand_more
  1. Log into HPMS
  2. Click on “Claims Data Attestation” (under Contract Management)
  3. Select the checkbox(es) next to one, multiple, or all contracts within the 'Contracts Without Attestation' window
  4. Click on the "Attest" button
  5. Review the Claims Data Usage Protocols
  6. Select the checkbox next to: "I hereby certify that I understand the attestation above"
  7. Click "Confirm"
How to add additional attesters
expand_more
  1. Log into HPMS
  2. Click on "Claims Data Attestation" (under Contract Management)
  3. Select the checkbox(es) next to one, multiple, or all contracts within the 'Attested Contract' window
  4. Click on the "Re-Attest" button
  5. Review the Claims Data Usage Protocols
  6. Select the checkbox next to: "I hereby certify that I understand the attestation above"
  7. Click "Confirm"
Step 2
Appoint an "AB2D Operations Specialist"
Overview
After attesting, Part D Plan (PDP) Sponsors will need to assign an "AB2D Data Operations Specialist" to act as their organization’s primary technical point of contact.
The "AB2D Data Operations Specialist"
check
Is a technical employee at the Part D Plan (PDP) sponsor that has the authority to access and view the data provided by the API.


check
Will be technically savvy enough to connect to the AB2D API and retrieve claims data from our Sandbox and Production environments.


check
Will need to provide static IP address(es) and or CIDR ranges for the network/system that is going to be accessing the AB2D API.
data-specialist
Step 3
Retrieve Synthetic Claims Data
Overview
The Sandbox is a test environment that enables anyone to interact with the AB2D API and retrieve synthetic Medicare Parts A and B claims data. A Part D Plan (PDP) sponsor “AB2D Data Operations Specialist” will need to verify they have retrieved synthetic claims data successfully in order to gain access to production data.
Connecting to the Sandbox
We are providing three different ways to retrieve synthetic claims data:
  1. Postman and Swagger User Guide
  2. Curl User Guide
  3. Advanced User Guide
Verifying Synthetic Data Retrieval
  • The "AB2D Data Operations Specialist" will need to record the Log ID from jobs that were executed successfully; retrieving synthetic claims data in our Sandbox environment.
  • The "AB2D Data Operations Specialist" will provide the Log ID from one of these jobs to the AB2D Team.
programmer
Step 4
Accessing Claims Data in Production
Overview
Once a connection to the sandbox environment has been verified, the AB2D team will work directly with the Part D Plan (PDP) sponsors to deliver production credentials. The Part D Plan (PDP) sponsor will use the production credentials to retrieve actual Medicare Parts A and B Claims Data from our production environment.
Delivering Production Credentials
  • After the "AB2D Data Operations Specialist" has provided their IP addresses and verified synthetic data retrieval, the AB2D team will work directly with the Attestor(s) to provide their organization’s production credentials.
production
Retrieving Actual Claims Data
  • Using the production credentials, the Part D Plan (PDP) sponsors will connect to the AB2D API in our production environment to download actual Medicare Parts A and B claims data.
  • The AB2D team will work closely with the organization and its "AB2D Data Operations Specialist" to answer any questions or troubleshoot any issues they have connecting to the AB2D API.
<?xml version="1.0" encoding="UTF-8"?> HHS-logo

HHS is committed to making its websites and documents accessible to the widest possible audience, including individuals with disabilities. We are in the process of retroactively making some documents accessible. If you need assistance accessing an accessible version of this document, please reach out to the guidance@hhs.gov.

DISCLAIMER: The contents of this database lack the force and effect of law, except as authorized by law (including Medicare Advantage Rate Announcements and Advance Notices) or as specifically incorporated into a contract. The Department may not cite, use, or rely on any guidance that is not posted on the guidance repository, except to establish historical facts.