Directory details

Where can I find the next pharmacy?

How late is “Dr. Schmerzfrei” open?

Which insurances are known in Germany?

In which practice can I book appointments online?

Which pharmacy has a delivery service?

Directories can be understood as “Yellow Pages” or “Register”.


Neue Bitmap (3)

They represent medical & healthcare organizations, composed of addresses, contact data, opening times and further information. For example practices, hospitals and pharmacies, but also insurances, rehab facilities or midwives could become directories.

Every directory consists of the common data set holding information about the organization (e.g. name & address) and a directory specific data set. For every directory different methods to get data access are available. Some directories offer additional features such as search methods with full-text search and several filter criteria.

Currently, CGM LIFE offers directories for:

– Pharmacies
– Practices
– Insurances


Directories are designed to work in every country of the world. The table below shows what data they currently contain (10/2014).

Directories DE IT FR CZ NL AT other
Pharmacies all examples
Practice eSERVICE practices eSERVICE practices eSERVICE practices Set up Set up eSERVICE practices
Insurance all

It is easily possible to add new records to the directories e.g. pharmacies in Italy or practices in the Netherlands. Some parts of the directory data are implemented as a catalog (e.g. specialization of a practice). This data is available for Germany by default and can be localized for any country in the world. For more information regarding catalogs


Every directory is implemented as a separate interface in the API (e.g. PharmacyService) to handle the specifics of its data model. However, the use of the directories is based on the same principles for finding records and searching in directories. For further information please have a look at the API documentation.

Find entries

Directories offer the possibility to find entries by Id. Therefore two different kinds of Ids can be used:

– findById()& getById() uses the internal reference Id which is available for every entry of the directories.
– findByOrganizationIdentification() uses a type and an official or other reference Ids (but not the internal reference Id) which can vary for every directory and are not always available for every entry. The different types of OrganizationIdentification can be seen in the different directory descriptions. See OrganizationIdentification for further information about this kind of Id.
Directory getById() findById() findByOrganizationIdentification()
Pharmacy X X X
Practice X X X
Insurance X

The methods return a whole directory entry with the general Organization data and the specific directory data. In case the requested Id is not available the find methods return “NULL”, the get methods return an exception. Therefore it is recommended to use the find methods in case an ID might not exist.

Search for entries

The full-text search function allows finding pharmacies and practices by different search attributes.

Basically, it is possible to use the searchByName() to search for pharmacies and practices by

– Name “Example”
– Parts of the Name “Exam”.

Additionally, it is possible to use the generic search() for finding pharmacies and practices by

– Name “Example”
– Parts of the Name “Exam”.
– City “New York”
– Zip-Code “00000”
– Coordinate “”latitude”: 49.4679386,”longitude”: 11.0117069”
– Flags “ANY_FLAG”
– Country “DE”
– Any combination of the listed attributes

By using coordinates in combination with other search attributes the result is sorted by the distance to these coordinate.

All results are sorted by a special algorithm so the first part is the area of exact matches, followed by the result with search attributes included in the entry. Please note: The search methods return search result objects. Please use the findById() method to get the practice/ pharmacy objects.

For deeper information please have a look at the API description for PharmacyService or PracticeService.

Extending directories

Basically, any kind of data can be saved as directories. In contrast to the catalog service, directory data is not under version control. In result always the latest data is available and no historical data.

It is also possible to create new directories. Therefore two ways are differentiated.

Extend existing directories

There are two ways to extend existing directories:

  1. Adding single entries (for all directories)

For all directories, it is possible to create new entries and change or delete existing entries. The right to create, update and delete entries can be requested. For every case of data changes, it is necessary to implement a web interface or any similar GUI to easily change data. Every change is based on exactly one entry. To change more entries, the functionality has to be used more often. Please use the contact data, in case of need.

  1. Import a list of entries (for pharmacies & insurances)

In case of a new country or another big data package, it is possible to import a list of new entries.

Therefore a special data format has to be used. That means you can get a document with all data fields which can be filled with the new content. Afterwards, the data can be imported with the help of the CGM LIFE Partner Management.

Add a new type of directory

New directory types can only be implemented in collaboration with CGM LIFE. Please register and share your need.