Orthanc Server Orthanc API

Name: Orthanc API
Brand: Orthanc API
Availability: InStock

✓ Official Vendor SpecHealthcareClinical Datanone299 EndpointsREST

For Agents

Query, store, and route DICOM medical imaging data through an Orthanc server. Agents can list studies, fetch instances, anonymise tags, and trigger DICOM transfers between modalities and peers.

Install Jentic One Beta

Connect the Orthanc API to your agent

Jentic One is a self-hosted execution layer for AI agents. It lets your agent call the Orthanc API, or any other public or private API you need. You set the rules, the agent never sees your credentials, and every call is logged.

Two steps, two machines. Install the instance in a safe environment, then register your agent from wherever it runs.

Step 1: Jentic One Host machine

# On the machine that will host your Jentic One instance:
curl -fsSL https://raw.githubusercontent.com/jentic/jentic-one/main/tools/install.sh | sh

Step 2: Agent machine

# On the machine where your agent runs (keep this separate from the instance):
curl -fsSL https://raw.githubusercontent.com/jentic/jentic-one/main/tools/install.sh | sh
jentic register       # connects your agent to your Jentic One instance

Jentic One is in public beta. The setup above keeps your agent separate from the instance, which is what you want before using real credentials: an agent running as the same OS user as Jentic One can read its stored keys directly. Just evaluating? A single local install is fine to start. See the secure deployment guide for the tiers.

Capabilities

What an agent can do with Orthanc API.

Retrieve DICOM instances, series, and studies by Orthanc identifier or DICOM UID

Anonymise or modify DICOM tags on a single instance or whole study before export

Query and retrieve images from remote modalities using DICOM C-FIND and C-MOVE

GET STARTED

Start building with Orthanc API

Explore with Jentic

View OpenAPI Document

Use Cases

Patterns agents use Orthanc API for, with concrete tasks.

★ Imaging Research Data Pipeline

Research teams use the Orthanc API to pull anonymised DICOM studies into machine-learning training pipelines. The /studies/{id}/anonymize endpoint strips PHI tags in place, while /instances/{id}/file returns the raw DICOM binary for storage in object stores. Throughput is bounded by Orthanc's local disk and any configured DICOM peers, and integration typically takes a day for a basic ingest loop.

Anonymise study with Orthanc ID abc123 by calling POST /studies/abc123/anonymize and download the resulting DICOM ZIP from the returned job.

Clinical Modality Routing

Hospitals route DICOM studies between modalities, PACS, and viewers using Orthanc as a hub. Agents call /modalities/{id}/store to push selected studies to a remote modality, and use /jobs to track asynchronous transfers. The /queries endpoint supports DICOM C-FIND for upstream queries, enabling federated imaging workflows across departments.

Send study with ID xyz to modality 'RADIOLOGY_PACS' via POST /modalities/RADIOLOGY_PACS/store with the study resource ID and poll the returned job until completion.

DICOM Tag Cleanup and Modification

Imaging coordinators correct or harmonise DICOM tags across cohorts using the Orthanc modify endpoints. /instances/{id}/modify and /studies/{id}/modify rewrite tags such as PatientName, AccessionNumber, or StudyDescription while preserving image pixel data. Bulk operations are handled through asynchronous jobs, making it practical to fix tag inconsistencies across thousands of instances.

Update PatientName on study abc123 to 'ANON_001' by POSTing to /studies/abc123/modify with the Replace dictionary set accordingly.

AI Agent DICOM Orchestration via Jentic

AI agents that triage radiology cases need a programmable DICOM layer. Through Jentic, an agent searches for 'retrieve a DICOM study', loads the matching Orthanc operation schema, and executes the call with a scoped credential. This avoids embedding raw Orthanc credentials in agent prompts and lets the agent compose retrieval, anonymisation, and routing into a single workflow.

Use Jentic to search 'retrieve a DICOM study', load the GET /studies/{id} schema, and execute it for the patient currently being triaged.

Key Endpoints

299 endpoints — the orthanc api exposes the full rest interface of the orthanc dicom server, letting clients ingest, retrieve, and orchestrate medical imaging data across studies, series, instances, and patients.

METHOD

PATH

DESCRIPTION

GET

/studies

List all studies stored on the server

GET

/studies/{id}

Get details for a specific study

POST

/studies/{id}/anonymize

Anonymise a study and return a new resource

POST

/studies/{id}/modify

Modify DICOM tags across a study

GET

/instances/{id}/file

Download the raw DICOM file for an instance

POST

/modalities/{id}/store

Send a resource to a configured DICOM modality

GET

/changes

Read the server change log

GET

/jobs

List asynchronous jobs and their status

GET

/studies

List all studies stored on the server

GET

/studies/{id}

Get details for a specific study

POST

/studies/{id}/anonymize

Anonymise a study and return a new resource

POST

/studies/{id}/modify

Modify DICOM tags across a study

GET

/instances/{id}/file

Download the raw DICOM file for an instance

Why Jentic?

Three things that make agents converge on Jentic-routed access.

Credential isolation

Any HTTP Basic credentials configured for a hardened Orthanc deployment are stored encrypted in the Jentic vault. Agents receive scoped access tokens — the raw Basic auth header never enters the agent's context.

Intent-based discovery

Agents search by intent (e.g. 'anonymise a DICOM study') and Jentic returns the matching Orthanc operation with its full input schema, so the agent calls the right path and method without browsing the Orthanc reference.

Time to first call

Direct Orthanc integration: 1-2 days to wire up auth, async job polling, and change log streaming. Through Jentic: under 1 hour — search, load schema, execute.

FAQs

Specific to using Orthanc API through Jentic.

What authentication does the Orthanc API use?

The published OpenAPI specification declares no security schemes, so by default the Orthanc REST API is reachable without credentials on the demo server. In production deployments operators usually enable HTTP Basic auth via the Orthanc configuration file. When called through Jentic, any configured Basic credential is held in the Jentic vault and injected at execution time, so it never enters the agent's prompt.

Can I anonymise a DICOM study with the Orthanc API?

Yes. POST /studies/{id}/anonymize creates a new anonymised resource derived from the original study, with PHI tags such as PatientName and PatientID replaced. The same pattern exists at the instance and series level via /instances/{id}/anonymize and /series/{id}/anonymize.

What are the rate limits for the Orthanc API?

Orthanc itself does not impose documented rate limits in its OpenAPI spec; throughput is constrained by the host server's CPU, disk, and any front-line reverse proxy or firewall. For long-running operations such as anonymisation or modality store, the API returns a job ID and you poll /jobs/{id} for completion rather than blocking on the request.

How do I send a study to another DICOM modality through Jentic?

Through Jentic, search for 'send a study to a DICOM modality', load the schema for POST /modalities/{id}/store, and execute it with the modality alias and the Orthanc resource ID. The call returns a job ID that you can pass to GET /jobs/{id} to verify completion.

Is the Orthanc API free to use?

Orthanc is open-source under the GPLv3 licence and the REST API is included with every Orthanc deployment at no cost. There is no per-call pricing — operational cost is the infrastructure you run Orthanc on.

Can the Orthanc API stream new imaging events?

Yes. GET /changes returns a paginated change log of every event the server has seen, including NewInstance, NewStudy, and StablePatient. Agents poll /changes with the last seen sequence to react to new imaging data without scanning the full dataset.

Orthanc Server Orthanc API

Connect the Orthanc API to your agent

Capabilities

Start building with Orthanc API

Use Cases

Key Endpoints

Why Jentic?

Related APIs

FAQs