Page History
Include Page | ||||
---|---|---|---|---|
|
...
Section | |||||||||||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
|
Service Endpoints
Multiexcerpt |
---|
Inside the NIH Firewall (VPN required)
Outside of the NIH Firewall |
Access Requirements
Multiexcerpt |
---|
To use the service, you must have a valid NCI LDAP account and a Creating New NCI CTRP User Accounts. All service endpoints require HTTP Basic authentication with your NCI LDAP username and password. |
XML Schema
...
XML schemas are well-annotated with inline documentation that explains the purpose and meaning of various elements, types, and attributes. Specific elements required for service operations are explained in the sections below.
Persons and Organizations - Requirements and Recommendations
Multiexcerpt | |||||||
---|---|---|---|---|---|---|---|
Registering or amending Complete trials in the CTRP involves organizations and persons that have the following roles in clinical trials: lead organization, sponsor, principal investigator, and so on. CTRP does not manage information about persons and organizations; instead, this is delegated to the Person and Organization Curation Portal, also known as PO. See the Person and Organization Curation Portal User's Guide for more information.
Before registering a trial, ensure that organizations and persons acting on the trial exist already in PO. Use person identifiers (PO IDs) and organization identifiers (CTEP IDs) when you register a trial whenever possible. If they do not already exist, request that they be created prior to trial registration, by submitting a request to the CTRO at ncictro@mail.nih.gov.
|
API Specification
Register an Abbreviated Trial
Register an Abbreviated trial in CTRP by pulling trial data from ClinicalTrials.gov using a ClinicalTrials.gov Trial Identifier.
...
/trials/abbreviated/{nct}
Parameters
{nct}. ClinicalTrials.gov Trial Identifier
...
TrialRegistrationConfirmation
Â
MIME Type: application/xml
...
200. Success
400. Validation error
401. Invalid username/password or insufficient permissions to access the service.
412. A trial with the given identifier already exists
500. Internal server error
...
URL: https://trials.nci.nih.gov/services/trials/abbreviated/NCT02208700
Response:
...
language | html/xml |
---|---|
collapse | true |
Update an Abbreviated Trial
Request to update an Abbreviated trial in CTRP.
...
/trials/abbreviated/{idType}/{trialID}
Parameters
{idType}. Type of identifier you want to use to identify a trial in CTRP. Possible values: pa, nci, ctep.
{trialID}. Trial identifier value itself.
...
AbbreviatedTrialUpdate
MIME Type: application/xml
...
TrialRegistrationConfirmation
MIME Type: application/xml
...
200. Success
400. Validation error (including the condition when you are not allowed to update a particular trial)
401. Invalid username/password or insufficient permissions to access the service.
404. One of the Persons/Organizations acting on the trial was not found in PO
500. Internal server error
...
URL: https://trials.nci.nih.gov/services/trials/abbreviated/nci/NCI-2014-00496
Request:
...
language | html/xml |
---|---|
collapse | true |
Response:
...
language | html/xml |
---|---|
collapse | true |
Register a Complete Trial
Request to register a Complete trial in CTRP.
...
CompleteTrialRegistration
MIME Type: application/xml
...
TrialRegistrationConfirmation
...
200. Success
400. Validation error
401. Invalid username/password or insufficient permissions to access the service.
404. One of the Persons/Organizations acting on the trial was not found in PO
500. Internal server error
...
URL: https://trials.nci.nih.gov/services/trials/complete
Request (referring to existing Organizations and Persons by ID):
...
language | html/xml |
---|---|
collapse | true |
Request (non-interventional trial):
...
language | html/xml |
---|---|
collapse | true |
Request (trial where submission to ClinicalTrials.gov is not required):
...
language | html/xml |
---|---|
collapse | true |
Request (trial with minimum data):
...
language | html/xml |
---|---|
collapse | true |
Request (trial where responsible party is Sponsor-Investigator):
...
language | html/xml |
---|---|
collapse | true |
Response:
...
language | html/xml |
---|---|
collapse | true |
Update a Complete Trial
Request to update a Complete trial in CTRP.
...
/trials/complete/{idType}/{trialID}
Parameters
{idType}. Type of identifier you want to use to identify a trial in CTRP. Possible values: pa, nci, ctep, dcp.
{trialID}. Trial identifier value itself.
...
CompleteTrialUpdate
MIME Type: application/xml
...
TrialRegistrationConfirmation
...
200. Success
400. Validation error (including the condition when you are not allowed to update a particular trial)
401. Invalid username/password or insufficient permissions to access the service.
500. Internal server error
...
URL: https://trials.nci.nih.gov/services/trials/complete/nci/NCI-2014-00496
Request:
...
language | html/xml |
---|---|
collapse | true |
Response:
...
language | html/xml |
---|---|
collapse | true |
Amend a Complete Trial
Request to amend a Complete trial in CTRP.
...
/trials/complete/{idType}/{trialID}
Parameters
{idType}. Type of identifier you want to use to identify a trial in CTRP. Possible values: pa, nci, ctep, dcp.
{trialID}. Trial identifier value itself.
...
CompleteTrialAmendment
...
TrialRegistrationConfirmation
MIME Type: application/xml
...
200. Success
400. Validation error (including the condition when you are not allowed to amend a particular trial)
401. Invalid username/password or insufficient permissions to access the service.
404. One of the Persons/Organizations acting on the trial was not found in PO
500. Internal server error
...
URL: https://trials.nci.nih.gov/services/trials/complete/nci/NCI-2014-00496
Request:
...
language | html/xml |
---|---|
collapse | true |
Response:
...