Version 0.4

Entity Endpoint

/api/0.4/entity/{id}

Endpoint provide information about one entity in the OpenAtlas instance. The requested information is provided in Linked Places format (LPF). Alternatively, Linked Open Art (LOUD), GeoJSON or RDFs, derived from the LPF data, can be accessed.

Optional Parameters

download

export

format

show

Example

https://demo.openatlas.eu/api/0.4/entity/4840?format=loud

Query

Endpoint provide information about one entity in the OpenAtlas instance. The requested information is provided in Linked Places format (LPF). Alternatively, Linked Open Art (LOUD), GeoJSON or RDFs, derived from the LPF data, can be accessed. Combine several or all entities endpoints in one query.

/api/0.4/query?

Combine several or all entity endpoints in one query.

Retrieves a list with entity ID, CIDOC CRM code, system class, or menu item. Combine up to four of the aforementioned endpoints in a single query; each request has to be a new parameter.

Required Parameters - At least one is required for a successful request

cidoc_classes

entities

system_classes

view_classes

Optional Parameters

column

count

download

export

first

format

last

limit

page

relation_type

search

show

sort

type_id

Example

https://demo.openatlas.eu/api/0.4/query?cidoc_classes=E18&cidoc_classes=E31&system_classes=person&limit=120

Multiple Entities

Endpoints provide information about entities in the OpenAtlas instance. The requested information is provided in Linked Places format (LPF). Alternatively, Linked Open Art (LOUD), GeoJSON or RDFs, derived from the LPF data, can be accessed.

CIDOC Class

/api/0.4/cidoc_class/{cidoc_class}

Retrieves a JSON list of entities based on their CIDOC CRM class 1 2

Optional Parameters

column

count

download

export

first

format

last

limit

page

relation_type

search

show

sort

type_id

Example

https://demo.openatlas.eu/api/0.4/cidoc_class/E18

Entities Linked to Entity

/api/0.4/entities_linked_to_entity/{id}

Used to retrieve a JSON list of entities linked to the entity with the stated ID 2

Optional Parameters

column

count

download

export

first

format

last

limit

page

relation_type

search

show

sort

type_id

Example

https://demo.openatlas.eu/api/0.4/entities_linked_to_entity/4840

Latest

/api/0.4/latest/{n}

Used to retrieve the last entry/entries made. The number {n} represents the amount of entities retrieved. {n} can be between 1 and 100. The pagination information is always null

Optional Parameters

column

download

export

format

relation_type

search

show

sort

type_id

Example

https://demo.openatlas.eu/api/0.4/latest/25

System Class

/api/0.4/system_class/{system_class}

Retrieves a list of entities, based on their OpenAtlas system class name as JSON 1 2

Optional Parameters

column

count

download

export

first

format

last

limit

page

relation_type

search

show

sort

type_id

Example

https://demo.openatlas.eu/api/0.4/system_class/person

Type Entities

/api/0.4/type_entities/{id}

Used to retrieve a JSON list of entities, based on their OpenAtlas type 2 3

Optional Parameters

column

count

download

export

first

format

last

limit

page

relation_type

search

show

sort

type_id

Example

https://demo.openatlas.eu/api/0.4/type_entities/47

Type Entities All

/api/0.4/type_entities_all/{id}

Used to retrieve a JSON list of entities, based on their OpenAtlas type and includes all connected entities 2 3

Optional Parameters

column

count

download

export

first

format

last

limit

page

relation_type

search

show

sort

type_id

Example

https://demo.openatlas.eu/api/0.4/type_entities_all/47

View Class

/api/0.4/view_class/{view_class}

Used to retrieve a JSON list of entities based on their OpenAtlas class view

Optional Parameters

column

count

download

export

first

format

last

limit

page

relation_type

search

show

sort

type_id

Example

https://demo.openatlas.eu/api/0.4/view_class/actor

1(1,2)

All codes available in OpenAtlas can be found under OpenAtlas and CIDOC CRM class mapping

2(1,2,3,4,5)

The result can be filtered, sorted, and manipulated through different parameters. By default 20 entities in alphabetical order are shown.

3(1,2)

Available IDs can be obtained by using the type-tree or node-overview endpoint.

Type Endpoints

Provide information about Types of an OpenAtlas instance. The results are in JSON and in a custom format.

Type by View Class

/api/0.4/type_by_view_class/

Retrieves a list of all types sorted by view class

Optional Parameters

download

Example

https://demo.openatlas.eu/api/0.4/type_by_view_class/

Type Overview

/api/0.4/type_overview/

Retrieves a list of all type

Optional Parameters

download

Example

https://demo.openatlas.eu/api/0.4/type_overview/

Type Tree

/api/0.4/type_tree/

Shows every type in an OpenAtlas instance in hierarchical order.

Optional Parameters

download

Example

https://demo.openatlas.eu/api/0.4/type_tree/

Administrative Endpoints

Provide metadata of the OpenAtlas instance for presentation sites.

Backend Details

/api/0.4/backend_details/

Retrieves a detailed list of the OpenAtlas version, the available API versions, site name, image and IIIF details.

Example

https://demo.openatlas.eu/api/0.4/backend_details/

Classes

/api/0.4/classes/

Retrieves a detailed list of all available system classes, their CIDOC CRM mapping, which view they belong to, which icon is used, and their english name.

Example

https://demo.openatlas.eu/api/0.4/classes/

Licensed File Overview

/api/0.4/licensed_file_overview/

Retrieves a list of display URL, thumbnail URL, extension and license of all files which exists and have a licence. With the parameter “file_id”, only the given IDs where retrieved.

Example

https://demo.openatlas.eu/api/0.4/licensed_file_overview/

Optional Parameters

download

file_id

System Class Count

/api/0.4/system_class_count/

Retrieves a list of the numbers of entries connected to a system class

Example

https://demo.openatlas.eu/api/0.4/system_class_count/

Special Endpoints

Provides project-specific formats.

Export Database

/api/0.4/export_database/{format}

Downloads all information in an OpenAtlas instance as CSV, XML, or JSON

Example

https://demo.openatlas.eu/api/0.4/export_database/json

Geometric Entities

/api/0.4/geometric_entities/

Retrieves a detailed GeoJSON list of all chosen geometries in an OpenAtlas instance; this was implemented for map usage

Optional Parameters

count

download

geometry

Example

https://demo.openatlas.eu/api/0.4/geometric_entities/

Subunits

/api/0.4/subunits/{id}

Displays all subunits of a place in a special format used by the THANADOS project

Optional Parameters

count

download

Image Endpoints

Display

/api/0.4/display/{id}

Provides the image connected to the requested ID. Be aware, the image will only be displayed if the request comes from a logged-in user or API public setting is set to on and the image has a license.

Optional Parameters

image_size