# CDC DIBBs eCR Refiner API

**Canonical:** https://apis.io/apis/centers-for-disease-control-and-prevention/dibbs-ecr-refiner/  
**Provider:** Centers for Disease Control and Prevention — https://apis.io/providers/centers-for-disease-control-and-prevention/  
**Documentation:** https://github.com/CDCgov/dibbs-ecr-refiner

CDC DIBBs eCR Refiner API is one of 10 APIs that [Centers for Disease Control and Prevention](https://apis.io/providers/centers-for-disease-control-and-prevention/) publishes on the [APIs.io](https://apis.io/) network, described by a machine-readable OpenAPI specification. Tagged areas include eCR, eICR, HL7 CDA, Public Health Surveillance, and Reportable Conditions. The published artifact set on APIs.io includes an OpenAPI specification and a changelog.

The DIBBs eCR Refiner reduces electronic initial case report (eICR) and Reportability Response (RR) documents down to the data a given reportable condition actually needs, easing storage and performance pressure on eCR pipelines and disease surveillance systems. CDC publishes a 44-operation OpenAPI 3.1.0 contract covering conditions, configurations, custom code sets, section processing, an audit event log and an eCR simulator. The product is self-hosted: public health jurisdictions run the Apache-2.0 container from ghcr.io/cdcgov/dibbs-ecr-refiner, so the spec declares no servers[] block and the base URL is whatever the jurisdiction deploys.

## Operations (44)

| Method | Path | Summary |
|---|---|---|
| GET | `/api/user` | Get User |
| GET | `/api/v1/conditions/` | Get Conditions |
| GET | `/api/v1/conditions/{condition_id}` | Get Condition |
| GET | `/api/v1/configurations/` | Get Configurations |
| POST | `/api/v1/configurations/` | Create Configuration |
| GET | `/api/v1/configurations/{configuration_id}/serialized` | Get Serialized Configuration |
| GET | `/api/v1/configurations/{configuration_id}` | Get Configuration |
| PUT | `/api/v1/configurations/{configuration_id}/code-sets` | Associate Condition Codeset With Configuration |
| DELETE | `/api/v1/configurations/{configuration_id}/code-sets/{condition_id}` | Remove Condition Codeset From Configuration |
| GET | `/api/v1/configurations/{configuration_id}/custom-codes/{id}` | Get Custom Code |
| DELETE | `/api/v1/configurations/{configuration_id}/custom-codes/{id}` | Delete Custom Code |
| POST | `/api/v1/configurations/{configuration_id}/custom-codes` | Add Custom Code |
| PUT | `/api/v1/configurations/{configuration_id}/custom-codes` | Edit Custom Code |
| POST | `/api/v1/configurations/{configuration_id}/custom-codes/upload` | Upload Custom Codes Csv |
| POST | `/api/v1/configurations/{configuration_id}/custom-codes/confirm` | Confirm Upload Custom Codes Csv |
| POST | `/api/v1/configurations/{configuration_id}/custom-codes/bulk-delete` | Bulk Delete Custom Codes |
| POST | `/api/v1/configurations/{configuration_id}/custom-codes/validate` | Validate Custom Code |
| GET | `/api/v1/configurations/{configuration_id}/export` | Get Configuration Export |
| POST | `/api/v1/configurations/test` | Run Configuration Test |
| POST | `/api/v1/configurations/{configuration_id}/sections` | Insert Custom Section |
| DELETE | `/api/v1/configurations/{configuration_id}/sections` | Delete Custom Section |
| PATCH | `/api/v1/configurations/{configuration_id}/sections` | Update Section |
| PATCH | `/api/v1/configurations/{configuration_id}/activate` | Activate Configuration |
| PATCH | `/api/v1/configurations/{configuration_id}/deactivate` | Deactivate Configuration |
| POST | `/api/v1/configurations/{configuration_id}/acquire-lock` | Acquire Configuration Lock |
| POST | `/api/v1/configurations/{configuration_id}/release-lock` | Release Configuration Lock |
| POST | `/api/v1/configurations/{configuration_id}/set-status` | Set Codes Status |
| GET | `/api/v1/configurations/{configuration_id}/codes` | Get Codes |
| GET | `/api/v1/configurations/{configuration_id}/code-counts` | Get Code Counts |
| GET | `/api/v1/configurations/{configuration_id}/filters` | Get Code Filters |
| POST | `/api/v1/simulator/discover-configurations` | Discover Configurations |
| POST | `/api/v1/simulator/upload` | Simulator Upload |
| GET | `/api/v1/simulator/download/{filename}` | Download Refined Ecr |
| GET | `/api/v1/events/` | Get Events |
| GET | `/api/v1/events/{event_id}/custom-code-uploads` | Get Custom Code Upload Events |
| GET | `/api/v1/events/export` | Get Events Export |
| GET | `/api/v1/events/{event_id}/codes/export` | Get Event Codes Export |
| GET | `/api/v1/releases/` | Get Releases Data |
| GET | `/api/v1/code-systems/` | Get Code Systems |
| PATCH | `/api/v1/notifications` | Update User Notifications |
| GET | `/api/v1/tes/diff-details` | Get Tes Updates |
| GET | `/api/v1/tes/` | Get Tes Diff Details |
| GET | `/api/v1/tes/export` | Export Tes Condition Diff |
| GET | `/api/v1/tes/configurations-to-update` | Get Configurations To Update |

## Machine-readable artifacts (4)

- **OpenAPI** — https://raw.githubusercontent.com/api-evangelist/centers-for-disease-control-and-prevention/refs/heads/main/openapi/centers-for-disease-control-and-prevention-dibbs-ecr-refiner-openapi.json
- **SourceCode** — https://github.com/CDCgov/dibbs-ecr-refiner
- **ChangeLog** — https://github.com/CDCgov/dibbs-ecr-refiner/releases
- **Overlay** — https://raw.githubusercontent.com/api-evangelist/centers-for-disease-control-and-prevention/refs/heads/main/overlays/centers-for-disease-control-and-prevention-dibbs-ecr-refiner-overlay.yaml

## Other Centers for Disease Control and Prevention APIs (9)

- [CDC Socrata Open Data API (data.cdc.gov)](https://apis.io/apis/centers-for-disease-control-and-prevention/cdc-socrata-open-data-api/)
- [CDC WONDER API](https://apis.io/apis/centers-for-disease-control-and-prevention/cdc-wonder-api/)
- [CDC PLACES / 500 Cities API](https://apis.io/apis/centers-for-disease-control-and-prevention/cdc-places-api/)
- [CDC Environmental Public Health Tracking Network API](https://apis.io/apis/centers-for-disease-control-and-prevention/cdc-ephtn-api/)
- [CDC Public Health Media Library (Content Syndication)](https://apis.io/apis/centers-for-disease-control-and-prevention/cdc-content-syndication/)
- [CDC NNDSS / MMWR Socrata Data](https://apis.io/apis/centers-for-disease-control-and-prevention/cdc-tb-nndss-socrata/)
- [Centers for Disease Control and Prevention SODA v2.1 API](https://apis.io/apis/centers-for-disease-control-and-prevention/centers-for-disease-control-and-prevention-soda-v2-1-api/)
- [Centers for Disease Control and Prevention SODA v3 API](https://apis.io/apis/centers-for-disease-control-and-prevention/centers-for-disease-control-and-prevention-soda-v3-api/)
- [CDC DIBBs Query Connector API](https://apis.io/apis/centers-for-disease-control-and-prevention/dibbs-query-connector/)

## Tags

eCR, eICR, HL7 CDA, Public Health Surveillance, Reportable Conditions

---

Profiled by [API Evangelist](https://apievangelist.com) and published on [APIs.io](https://apis.io/apis/centers-for-disease-control-and-prevention/dibbs-ecr-refiner/). The API's provider profile, Kin Score and agent-readiness rating are at https://apis.io/providers/centers-for-disease-control-and-prevention/.