Endpoint
A variable used to assess an objective, with its level and purpose. Endpoints are nested inside the objective they belong to.
- Kind
- Concrete class
- Attributes
- 11, 6 required
- NCI code
- C25212
Official definition
A defined variable intended to reflect an outcome of interest that is statistically analyzed to address a particular research question. NOTE: A precise definition of an endpoint typically specifies the type of assessments made, the timing of those assessments, the assessment tools used, and possibly other details, as applicable, such as how multiple assessments within an individual are to be combined. [After BEST Resource] (CDISC Glossary)
In practice
In a protocol document: The endpoints column of the objectives and endpoints table.
Inheritance
Endpoint is a kind of SyntaxTemplate and inherits its attributes. Wherever the model asks for a SyntaxTemplate, a Endpoint can be used.
Attributes
11 attributes, 6 of them required by the USDM API schema and 1 holding the id of another object instead of the object itself (marked by id).
| Attribute | Type | Card. | Definition |
|---|---|---|---|
| idrequired | string | cardinality 1 | The identifier of this object, unique within the file.Inherited from SyntaxTemplate |
| namerequired | string | cardinality 1 | The literal identifier (i.e., distinctive designation) of the study endpoint.Inherited from SyntaxTemplate |
| label | string | cardinality 0..1 | The short descriptive designation for the study endpoint.Inherited from SyntaxTemplate |
| description | string | cardinality 0..1 | A narrative representation of the study endpoint.Inherited from SyntaxTemplate |
| textrequired | string | cardinality 1 | An instance of structured text that represents the study endpoint.Inherited from SyntaxTemplate |
| notes | CommentAnnotation | cardinality 0..* | A brief written record relevant to the study endpoint.Inherited from SyntaxTemplate |
| dictionaryId | SyntaxTemplateDictionaryby id | cardinality 0..1 | A USDM relationship between the Endpoint and SyntaxTemplateDictionary classes which provides the set of dictionary entries related to study endpoints.Inherited from SyntaxTemplate |
| levelrequired | Code | cardinality 1 | A characterization or classification of the study endpoint that determines its category of importance relative to other study endpoints.USDM codelist C188726, 3 values |
| purposerequired | string | cardinality 1 | The textual representation of the study endpoint purpose. |
| extensionAttributes | ExtensionAttribute | cardinality 0..* | Extension attributes attached to this object, for information the standard does not define. Added by the API; not part of the logical model. |
| instanceTyperequired | string | cardinality 1 | The name of the class, carried by every object in a USDM JSON file. Added by the API; not part of the logical model. |
Allowed values
The coded attributes of Endpoint that use a codelist defined by USDM, with every value in it. A file carries the code; the term is its decode.
levelcodelist C188726, not extensible
| Code | Term | Definition |
|---|---|---|
| C170559 | Exploratory Endpoint | Endpoint(s) that may include clinically important events that are expected to occur too infrequently to show a treatment effect or endpoints that for other reasons are thought to be less likely to show an effect but are included to explore new hypotheses. (After FDA-NIH Protocol Template) |
| C94496 | Primary Endpoint | Endpoint(s) of greatest importance that is the basis for concluding whether the study met its objective(s) and provides a clinically relevant, valid, and reliable measure of the primary objective(s). (After FDA-NIH Protocol Template) |
| C139173 | Secondary Endpoint | Endpoint(s) that may provide supportive information about the effect of the study intervention(s) on the primary endpoint or demonstrate additional effects on the disease or condition. (After FDA-NIH Protocol Template) |
Smallest valid Endpoint
The attributes a JSON file must carry for a Endpoint, and the kind of value each takes. This is the shape, with types named in place of values. Everything else in the table above is optional.
{
"id": "Endpoint_1",
"name": string,
"text": string,
"level": Code,
"purpose": string,
"instanceType": "Endpoint"
}
Where Endpoint is used
These classes hold or point to a Endpoint.
Example
A Endpoint from the example study. Coded values are shortened to one line.
{
"id": "Endpoint_1",
"name": "PRIMARY_ENDPOINT",
"label": "Primary endpoint",
"text": "Change from baseline in mean seated systolic blood pressure at Week 12.",
"purpose": "Efficacy",
"level": { "code": "C94496", "decode": "Primary Endpoint", … },
"instanceType": "Endpoint"
}
Related classes
Other classes in objectives, endpoints and estimands: