oig.hhs.gov APIoig.hhs.gov ↗
Access HHS OIG corporate integrity agreements via API. Browse CIAs by status, state, or company name. Retrieve settlement amounts, effective dates, and agreement details.
curl -X GET 'https://api.parse.bot/scraper/7de2cc57-d6a8-42c0-a9e8-74c68847f19d/browse_agreements?page=1&status=Active' \ -H 'X-API-Key: $PARSE_API_KEY'
Browse and list corporate integrity agreements with optional filtering by status, search term, and pagination. Returns company name, location, state, agreement type, status, and effective date for each agreement. When page is specified, returns that page only (20 items per page). When page is 0 or omitted, fetches all pages sequentially.
| Param | Type | Description |
|---|---|---|
| page | integer | Page number to fetch (20 items per page). 0 or omitted fetches all pages. |
| limit | integer | Maximum number of agreements to return when fetching all pages. 0 means no limit. |
| search | string | Search term to filter agreements by company name or keywords. |
| status | string | Filter by agreement status. Accepted values: Active, Closed, Suspended, Refused by Entity. |
{
"type": "object",
"fields": {
"count": "integer - number of agreements returned in this response",
"agreements": "array of agreement objects with company_name, detail_url, location, state, report_type, status, and effective_date fields",
"total_agreements": "integer - total number of matching agreements across all pages"
},
"sample": {
"data": {
"page": 1,
"count": 20,
"agreements": [
{
"state": "GA",
"location": "Lawrenceville, GA",
"detail_url": "https://oig.hhs.gov/compliance/corporate-integrity-agreements/browse-cias/recovery-center-of-usa-llc/",
"report_type": "Corporate Integrity Agreement",
"company_name": "Recovery Center of USA LLC"
}
],
"total_agreements": 332
},
"status": "success"
}
}About the oig.hhs.gov API
This API exposes corporate integrity agreements (CIAs) published by the HHS Office of Inspector General across two endpoints: browse_agreements and get_agreement_detail. browse_agreements returns a paginated list of agreements with 7 fields per record — including company name, state, status, and effective date — while get_agreement_detail surfaces full agreement metadata including settlement amount, duration, category, and associated tags for a single entity.
Browsing and Filtering Agreements
The browse_agreements endpoint returns a list of CIA records with fields including company_name, location, state, report_type, status, and effective_date. You can filter by status (accepted values: Active, Closed, Suspended, Refused by Entity) and by a search term to narrow results to a specific company or keyword. Pagination is handled via the page parameter (20 records per page); omitting it or passing 0 fetches all pages. A limit parameter caps results when fetching across multiple pages. Each record includes a detail_url you can pass directly to get_agreement_detail.
Agreement Detail Records
The get_agreement_detail endpoint accepts either a slug (e.g., neurosurgical-associates-ltd) or a full url and returns a single agreement's complete metadata. Returned fields include effective_to (ISO date), status, report_type, category, tags, location, state, and company_name. Settlement amount and press release info are also returned where available, providing context on the compliance action tied to each agreement.
Data Coverage
The HHS OIG CIA database covers healthcare entities — hospitals, physician groups, pharmaceutical companies, and others — that have entered into compliance agreements with the federal government. The state field allows geographic filtering across all U.S. states. Agreement statuses reflect current standing in the OIG's published records, and the total_agreements field in browse_agreements responses lets you track the full scope of matching results before paginating.
- Screen healthcare vendors or partners against active OIG corporate integrity agreements before contracting
- Monitor newly effective CIAs by filtering
browse_agreementsby statusActiveand sorting byeffective_date - Build a compliance dashboard showing open CIAs by state using the
statefield frombrowse_agreements - Retrieve settlement amounts for specific entities via
get_agreement_detailto assess financial exposure in M&A due diligence - Track agreement closures over time by querying
status: Closedand aggregatingeffective_todates - Cross-reference a company name from a provider directory against OIG CIA records using the
searchparameter
| Tier | Price | Credits/month | Rate limit |
|---|---|---|---|
| Free | $0/mo | 100 | 5 req/min |
| Hobby | $30/mo | 1,000 | 20 req/min |
| Developer | $100/mo | 5,000 | 250 req/min |
One credit = one API call regardless of which marketplace API you call. Exceeding the rate limit returns a 429 response. Authenticate with the X-API-Key header.
Does HHS OIG provide an official developer API for corporate integrity agreements?+
What does `get_agreement_detail` return beyond what `browse_agreements` provides?+
browse_agreements returns summary fields: company_name, location, state, report_type, status, and effective_date. get_agreement_detail adds effective_to, category, tags, settlement amount, press release info, and the full title. Use get_agreement_detail when you need the complete record for a specific agreement.Can I retrieve the actual CIA document text or attached PDF through this API?+
How does pagination work in `browse_agreements`, and what is the default page size?+
page integer to retrieve a specific page. Set page to 0 or omit it to fetch all pages at once. Use the limit parameter to cap the total number of records returned when fetching across pages; setting limit to 0 returns all matching records without a cap. The response always includes total_agreements so you can calculate the full page count.Does the API cover CIAs for entities outside the United States?+
state field. Non-U.S. entities are not represented in the source data. You can fork this API on Parse and revise it if you need to supplement records with additional compliance databases.