DiagnosticReport Resource

The FHIR DiagnosticReport resource represents a completed diagnostic report in AdvaPACS. DiagnosticReport resources are typically associated with a ServiceRequest and contain the report content, reporting status, issuing time, and reporting practitioners.

For full information on the DiagnosticReport resource, please refer to the FHIR standard.

Supported Formats

AdvaPACS supports report content through presentedForm. A report can be provided in any of the following formats:

• application/pdf
• text/plain
• text/html
• text/hl7+ft

When text/hl7+ft is provided, AdvaPACS automatically converts the content to HTML. More than one presentedForm can be provided, but each item should contain the same report content in a different format.

Supported Transactions

AdvaPACS supports the following transactions for the DiagnosticReport resource:

Function	Method	Endpoint	Description
Get DiagnosticReport	GET	/DiagnosticReport/{id}	Retrieves a specific DiagnosticReport resource by its logical ID.
Search DiagnosticReports	GET	/DiagnosticReport	Searches for DiagnosticReport resources using supported search parameters.
Create DiagnosticReport	POST	/DiagnosticReport	Creates a new DiagnosticReport resource.
Update DiagnosticReport	PUT	/DiagnosticReport/{id}	Updates an existing DiagnosticReport resource.
Delete DiagnosticReport	DELETE	/DiagnosticReport/{id}	Deletes an existing DiagnosticReport resource.

Examples

The following examples demonstrate how to use the AdvaPACS FHIR API to create, retrieve, search, update, and delete DiagnosticReport resources.

Get a DiagnosticReport

A specific DiagnosticReport can be retrieved using the logical ID assigned to the resource. The response contains the report details stored in AdvaPACS, including its status, associated patient and study, report content, and other relevant clinical information.

GET /fhir/R5/DiagnosticReport/[DiagnosticReport_ID]
Authorization: ID=<ApiId>,Secret=<ApiSecret>
Accept: application/fhir+json
Host: <FhirEndpoint>

For example, to retrieve a DiagnosticReport with logical ID 3b4d33d2-ef52-4f9c-a7fc-3d4b6f7f7d45:

GET /fhir/R5/DiagnosticReport/3b4d33d2-ef52-4f9c-a7fc-3d4b6f7f7d45
Authorization: ID=<ApiId>,Secret=<ApiSecret>
Accept: application/fhir+json
Host: <FhirEndpoint>

If the DiagnosticReport is found, AdvaPACS returns a 200 OK response containing the requested FHIR resource.

{
  "resourceType": "DiagnosticReport",
  "id": "3b4d33d2-ef52-4f9c-a7fc-3d4b6f7f7d45",
  "status": "final",
  "code": {
    "text": "CT Chest"
  },
  "subject": {
    "reference": "Patient/4c3b6c56-2df0-49d5-b79d-cdb5a9d3d0b8"
  },
  "basedOn": [
    {
      "reference": "ServiceRequest/82b89d3d-59b1-44cb-a2e4-5d9a7e51cbd3"
    }
  ],
  "effectiveDateTime": "2026-07-09T09:15:00Z",
  "issued": "2026-07-09T10:02:18Z",
  "presentedForm": [
    {
      "contentType": "text/html"
    }
  ]
}

Create a DiagnosticReport

A new DiagnosticReport can be created by submitting a complete FHIR DiagnosticReport resource. The report is typically linked to an existing Patient and ServiceRequest and contains the diagnostic report content along with its status and associated metadata.

The DiagnosticReport may include one or more report representations using presentedForm. Supported content types include application/pdf, text/plain, text/html, and text/hl7+ft.

POST /fhir/R5/DiagnosticReport
Authorization: ID=<ApiId>,Secret=<ApiSecret>
Content-Type: application/fhir+json
Accept: application/fhir+json
Host: <FhirEndpoint>

For example, the following request creates a final DiagnosticReport containing an HTML report and links it to an existing Patient and ServiceRequest:

POST /fhir/R5/DiagnosticReport
Authorization: ID=<ApiId>,Secret=<ApiSecret>
Content-Type: application/fhir+json
Accept: application/fhir+json
Host: <FhirEndpoint>

A complete FHIR DiagnosticReport resource must be provided in the JSON request body:

{
  "resourceType": "DiagnosticReport",
  "status": "final",
  "code": {
    "text": "CT Chest"
  },
  "subject": {
    "reference": "Patient/4c3b6c56-2df0-49d5-b79d-cdb5a9d3d0b8"
  },
  "basedOn": [
    {
      "reference": "ServiceRequest/82b89d3d-59b1-44cb-a2e4-5d9a7e51cbd3"
    }
  ],
  "effectiveDateTime": "2026-07-09T09:15:00Z",
  "presentedForm": [
    {
      "contentType": "text/html",
      "data": "PHA+Tm8gYWJub3JtYWxpdHkgZGV0ZWN0ZWQuPC9wPg=="
    }
  ]
}

If the DiagnosticReport is successfully created, AdvaPACS returns a 201 Created response containing the newly created resource.

{
  "resourceType": "DiagnosticReport",
  "id": "3b4d33d2-ef52-4f9c-a7fc-3d4b6f7f7d45",
  "status": "final",
  "code": {
    "text": "CT Chest"
  },
  "subject": {
    "reference": "Patient/4c3b6c56-2df0-49d5-b79d-cdb5a9d3d0b8"
  },
  "basedOn": [
    {
      "reference": "ServiceRequest/82b89d3d-59b1-44cb-a2e4-5d9a7e51cbd3"
    }
  ],
  "effectiveDateTime": "2026-07-09T09:15:00Z",
  "issued": "2026-07-09T10:02:18Z",
  "presentedForm": [
    {
      "contentType": "text/html"
    }
  ]
}