# CDISC Dataset-JSON API (standard specification)

**Canonical:** https://apis.io/apis/cdisc/cdisc-dataset-json-api/  
**Provider:** Cdisc — https://apis.io/providers/cdisc/  
**Documentation:** https://www.cdisc.org/standards/data-exchange/dataset-json

CDISC Dataset-JSON API (standard specification) is one of 10 APIs that [Cdisc](https://apis.io/providers/cdisc/) publishes on the [APIs.io](https://apis.io/) network, described by a machine-readable OpenAPI specification. Tagged areas include Dataset-JSON, Data Exchange, and Standards. The published artifact set on APIs.io includes an OpenAPI specification and API documentation.

CDISC-authored OpenAPI 3.1 specification for the Dataset-JSON API — studies, snapshots, datasets (including an NDJSON streaming representation and an $export operation) and Define-XML documents. This is a SPECIFICATION CDISC publishes for implementers to host, not a service CDISC operates: the contract declares no servers and CDISC runs no endpoint for it, which is why no baseURL is recorded.

## Operations (24)

| Method | Path | Summary |
|---|---|---|
| GET | `/about` | Get About the API |
| GET | `/studies` | Get the list of studies |
| POST | `/studies` | Create a new study |
| GET | `/studies/{studyOID}` | Get a study |
| PUT | `/studies/{studyOID}` | Update a study |
| DELETE | `/studies/{studyOID}` | Delete a study |
| POST | `/studies/{studyOID}/snapshots` | Create a new study snapshot |
| GET | `/studies/{studyOID}/snapshots` | Get the list of snapshots for a study |
| GET | `/studies/{studyOID}/snapshots/{snapshotID}` | Get a snapshot |
| DELETE | `/studies/{studyOID}/snapshots/{snapshotID}` | Delete a snapshot |
| GET | `/studies/{studyOID}/snapshots/{snapshotID}/datasets/{datasetOID}` | Get a snapshot dataset |
| GET | `/studies/{studyOID}/datasets` | Get the list of datasets for a study |
| POST | `/studies/{studyOID}/datasets` | Create a new dataset |
| GET | `/studies/{studyOID}/datasets/{datasetOID}` | Get a dataset |
| PUT | `/studies/{studyOID}/datasets/{datasetOID}` | Update a dataset |
| PATCH | `/studies/{studyOID}/datasets/{datasetOID}` | Append records to a dataset |
| DELETE | `/studies/{studyOID}/datasets/{datasetOID}` | Delete a dataset |
| GET | `/studies/{studyOID}/datasets/{datasetOID}/$export` | Export a dataset to NDJSON (async) |
| GET | `/studies/{studyOID}/datasets/{datasetOID}/ndjson` | Download NDJSON dataset as a stream |
| POST | `/studies/{studyOID}/defines` | Create a new Define-XML file |
| GET | `/studies/{studyOID}/defines` | Get the list of Define-XML files for a study |
| GET | `/studies/{studyOID}/defines/{label}` | Get a Define-XML |
| PUT | `/studies/{studyOID}/defines/{label}` | Update a Define-XML |
| DELETE | `/studies/{studyOID}/defines/{label}` | Delete a Define-XML |

## Machine-readable artifacts (5)

- **OpenAPI** — https://raw.githubusercontent.com/api-evangelist/cdisc/refs/heads/main/openapi/cdisc-dataset-json-api-openapi.json
- **Overlay** — https://raw.githubusercontent.com/api-evangelist/cdisc/refs/heads/main/overlays/cdisc-dataset-json-api-overlay.yaml
- **OpenAPI** — https://raw.githubusercontent.com/cdisc-org/DataExchange-DatasetJson-API/main/openapi/dataset-json-api-1-0.json
- **Documentation** — https://www.cdisc.org/standards/data-exchange/dataset-json
- **SourceCode** — https://github.com/cdisc-org/DataExchange-DatasetJson-API

## Other Cdisc APIs (9)

- [CDISC CORE (Checks and Rules Engine) API](https://apis.io/apis/cdisc/cdisc-core-api/)
- [cdisc ADaM API](https://apis.io/apis/cdisc/cdisc-adam-api/)
- [cdisc Biomedical Concepts API](https://apis.io/apis/cdisc/cdisc-biomedical-concepts-api/)
- [cdisc CDASH API](https://apis.io/apis/cdisc/cdisc-cdash-api/)
- [cdisc Products API](https://apis.io/apis/cdisc/cdisc-products-api/)
- [cdisc SDTM API](https://apis.io/apis/cdisc/cdisc-sdtm-api/)
- [cdisc Terminology API](https://apis.io/apis/cdisc/cdisc-terminology-api/)
- [CDISC Analysis Results Standard (ARS) API](https://apis.io/apis/cdisc/cdisc-analysis-results-api/)
- [CDISC USDM (DDF) Study Definitions API](https://apis.io/apis/cdisc/cdisc-usdm-api/)

## Tags

Dataset-JSON, Data Exchange, Standards

---

Profiled by [API Evangelist](https://apievangelist.com) and published on [APIs.io](https://apis.io/apis/cdisc/cdisc-dataset-json-api/). The API's provider profile, Kin Score and agent-readiness rating are at https://apis.io/providers/cdisc/.