This area is intended for automatised access to the histHub database by third-party software. If you are not a machine and/or programmer, please use our beautiful default interface lovingly optimised for organic lifeforms.

Usage

The API is invoked by posting a JSON query to /api/search/ or its children, specifying zero or more properties as key-value pairs. The API will return a JSON array of JSON objects.

It is strongly encouraged, but not required, to include the pair "version": 1 with your search to ensure it will not be affected by any later API modifications. It will still benefit from any changes that do not break backwards compatibility.

The API defaults to retrieving 10 results. This may be overridden by supplying a property "limit". In particular, "limit": 0 retrieves and returns all results, potentially resulting in a major workload on the server – please use responsibly or we'll have to block it.

This API supports the powerful query language Lucene, allowing e.g. regular expressions and fuzzy search. Post a Lucene query by the key of "q" (Example). With Lucene being officially still unstable (albeit unlikely to actually be modified at current), a direct search by JSON properties is preferrable wherever this is possible.

Note that ISO 8601 does not represent dates before the epoch. For negative dates, the "min_year" and max_year are to be preferred.

Examples

A single entry as JSON

GET https://data.histhub.ch/api/place/12177691 
{
  "localisations": [
    {
      "localisation": {
        "coordinates": "POINT (699500 220150)",
        "gps": "POINT (8.749978704628615 47.12485848440517)",
        "srid": 21781
      },
      "attributions": [
        {
          "institution": "ortsnamen.ch",
          "caption": "Siehe [Datengrundlage](http://www.ortsnamen.ch/index.php/datenbank-info.html) von ortsnamen.ch; f\u00fcr die [Online-Publikation](https://search.ortsnamen.ch/record/16000011) aufbereitet durch [ortsnamen.ch](https://search.ortsnamen.ch)"
        }
      ]
    }
  ],
  "license": {
    "name": "CC BY-SA",
    "version": "4.0",
    "url": "https://creativecommons.org/licenses/by-sa/4.0/deed.de"
  },
  "types": [
    {
      "type": {
        "id": 18001192,
        "labels": {
          "fra": "Village",
          "deu": "Dorf",
          "ita": "Villaggio",
          "eng": "village"
        }
      },
      "attributions": [
        {
          "institution": "ortsnamen.ch",
          "caption": "Siehe [Datengrundlage](http://www.ortsnamen.ch/index.php/datenbank-info.html) von ortsnamen.ch; f\u00fcr die [Online-Publikation](https://search.ortsnamen.ch/record/16000011) aufbereitet durch [ortsnamen.ch](https://search.ortsnamen.ch)"
        }
      ]
    },
    {
      "type": {
        "id": 18001213,
        "labels": {
          "fra": "Commune",
          "deu": "Gemeinde (politische)",
          "ita": "Comune",
          "eng": "municipality"
        }
      },
      "attributions": [
        {
          "institution": "ortsnamen.ch",
          "caption": "Siehe [Datengrundlage](http://www.ortsnamen.ch/index.php/datenbank-info.html) von ortsnamen.ch; f\u00fcr die [Online-Publikation](https://search.ortsnamen.ch/record/16000011) aufbereitet durch [ortsnamen.ch](https://search.ortsnamen.ch)"
        }
      ]
    },
    {
      "type": {
        "id": 18001221,
        "labels": {
          "fra": "District",
          "deu": "Bezirk",
          "eng": "Bezirk"
        }
      },
      "attributions": [
        {
          "institution": "ortsnamen.ch",
          "caption": "Siehe [Datengrundlage](http://www.ortsnamen.ch/index.php/datenbank-info.html) von ortsnamen.ch; f\u00fcr die [Online-Publikation](https://search.ortsnamen.ch/record/16000011) aufbereitet durch [ortsnamen.ch](https://search.ortsnamen.ch)"
        }
      ]
    }
  ],
  "names": [
    {
      "name": "Einsiedeln",
      "type": "original",
      "lang": "deu",
      "attributions": [
        {
          "institution": "ortsnamen.ch",
          "caption": "Siehe [Datengrundlage](http://www.ortsnamen.ch/index.php/datenbank-info.html) von ortsnamen.ch; f\u00fcr die [Online-Publikation](https://search.ortsnamen.ch/record/16000011) aufbereitet durch [ortsnamen.ch](https://search.ortsnamen.ch)"
        }
      ]
    }
  ],
  "hhb_id": 12177691,
  "existences": [
    {
      "start": null,
      "end": {
        "date": "2019-01-01",
        "precision": {
          "mode": "after",
          "unit": "year",
          "size": "1",
          "type": "certain"
        },
        "type": {
          "id": 18002036,
          "labels": {
            "fra": "derni\u00e8re mention",
            "deu": "Letzterw\u00e4hnung",
            "ita": "ultima menzione",
            "eng": "last mention"
          }
        }
      }
    }
  ],
  "external_ids": [
    {
      "institution": "ortsnamen.ch",
      "external_id": 16000011
    }
  ],
  "label_name": "Einsiedeln",
  "url": "https://data.histhub.ch/place/12177691"
}

Lucene query limited to entity type

POST https://data.histhub.ch/api/search/place/ 
{
  "version": 1,
  "q": "*acker types.type.label.deu:Kloster"
}
[]

JSON query limited to entity type

Go here for a comprehensive list of field names.
POST https://data.histhub.ch/api/search/person/ 
{
  "version": 1,
  "names.surname": "Hans"
}
[
  {
    "license": {
      "name": "CC BY-SA",
      "version": "4.0",
      "url": "https://creativecommons.org/licenses/by-sa/4.0/deed.de"
    },
    "forename": "Jacob",
    "names": [
      {
        "forename": "Jacob",
        "surname": "Hans",
        "fullname": "Jacob Hans",
        "lang": "deu",
        "type": "standard",
        "attributions": [
          {
            "institution": "HLS"
          }
        ]
      },
      {
        "forename": "Jacob",
        "surname": "Hans",
        "fullname": "Jacob Hans",
        "lang": "fra",
        "type": "standard",
        "attributions": [
          {
            "institution": "HLS"
          }
        ]
      },
      {
        "forename": "Jacob",
        "surname": "Hans",
        "fullname": "Jacob Hans",
        "lang": "ita",
        "type": "standard",
        "attributions": [
          {
            "institution": "HLS"
          }
        ]
      }
    ],
    "surname": "Hans",
    "hhb_id": 11489534,
    "sex": [
      {
        "term": {
          "id": 18001363,
          "labels": {
            "fra": "masculin",
            "deu": "m\u00e4nnlich",
            "ita": "maschile",
            "eng": "male"
          }
        },
        "attributions": [
          {
            "institution": "HLS"
          }
        ]
      }
    ],
    "existences": [
      {
        "start": {
          "date": "1601-01-01",
          "precision": {
            "mode": "after",
            "unit": "year",
            "size": "1",
            "type": "expected"
          },
          "type": {
            "id": 18002038,
            "labels": {
              "fra": "Naissance",
              "deu": "Geburt",
              "ita": "Nascita",
              "eng": "birth"
            }
          }
        },
        "end": {
          "date": "1604-01-01",
          "precision": {
            "mode": "after",
            "unit": "year",
            "size": "1",
            "type": "expected"
          },
          "type": {
            "id": 18002039,
            "labels": {
              "fra": "D\u00e9c\u00e8s",
              "deu": "Tod",
              "ita": "morte",
              "eng": "death"
            }
          }
        }
      }
    ],
    "external_ids": [
      {
        "institution": "HLS",
        "external_id": 22429
      }
    ],
    "label_name": "Jacob Hans",
    "url": "https://data.histhub.ch/person/11489534"
  },
  {
    "license": {
      "name": "CC BY-SA",
      "version": "4.0",
      "url": "https://creativecommons.org/licenses/by-sa/4.0/deed.de"
    },
    "forename": "Konrad",
    "relations_to_place": [
      {
        "type": {
          "id": 18001362,
          "labels": {
            "deu": "Wohnort",
            "eng": "residence"
          }
        },
        "attributions": [
          {
            "institution": "SSRQ"
          }
        ]
      }
    ],
    "names": [
      {
        "forename": "Conrat",
        "surname": "Hans",
        "fullname": "Conrat Hans",
        "lang": "deu",
        "type": "original",
        "attributions": [
          {
            "institution": "SSRQ"
          }
        ]
      },
      {
        "forename": "Konrad",
        "surname": "Hans",
        "fullname": "Konrad Hans",
        "lang": "deu",
        "type": "standard",
        "attributions": [
          {
            "institution": "SSRQ"
          }
        ]
      }
    ],
    "surname": "Hans",
    "hhb_id": 11092612,
    "sex": [
      {
        "term": {
          "id": 18001363,
          "labels": {
            "fra": "masculin",
            "deu": "m\u00e4nnlich",
            "ita": "maschile",
            "eng": "male"
          }
        },
        "attributions": [
          {
            "institution": "SSRQ"
          }
        ]
      }
    ],
    "external_ids": [
      {
        "institution": "SSRQ",
        "external_id": "per005502"
      }
    ],
    "label_name": "Konrad Hans",
    "url": "https://data.histhub.ch/person/11092612"
  },
  {
    "license": {
      "name": "CC BY-SA",
      "version": "4.0",
      "url": "https://creativecommons.org/licenses/by-sa/4.0/deed.de"
    },
    "forename": "Jos",
    "names": [
      {
        "forename": "Jos",
        "surname": "Hans",
        "fullname": "Jos Hans",
        "lang": "deu",
        "type": "standard",
        "attributions": [
          {
            "institution": "SSRQ"
          }
        ]
      }
    ],
    "surname": "Hans",
    "hhb_id": 11089672,
    "sex": [
      {
        "term": {
          "id": 18001363,
          "labels": {
            "fra": "masculin",
            "deu": "m\u00e4nnlich",
            "ita": "maschile",
            "eng": "male"
          }
        },
        "attributions": [
          {
            "institution": "SSRQ"
          }
        ]
      }
    ],
    "external_ids": [
      {
        "institution": "SSRQ",
        "external_id": "per004716"
      }
    ],
    "label_name": "Jos Hans",
    "url": "https://data.histhub.ch/person/11089672"
  },
  {
    "license": {
      "name": "CC BY-SA",
      "version": "4.0",
      "url": "https://creativecommons.org/licenses/by-sa/4.0/deed.de"
    },
    "forename": "Jos",
    "names": [
      {
        "forename": "Jos",
        "surname": "Hans",
        "fullname": "Jos Hans",
        "lang": "deu",
        "type": "standard",
        "attributions": [
          {
            "institution": "SSRQ"
          }
        ]
      }
    ],
    "surname": "Hans",
    "hhb_id": 11089676,
    "sex": [
      {
        "term": {
          "id": 18001363,
          "labels": {
            "fra": "masculin",
            "deu": "m\u00e4nnlich",
            "ita": "maschile",
            "eng": "male"
          }
        },
        "attributions": [
          {
            "institution": "SSRQ"
          }
        ]
      }
    ],
    "external_ids": [
      {
        "institution": "SSRQ",
        "external_id": "per004717"
      }
    ],
    "label_name": "Jos Hans",
    "url": "https://data.histhub.ch/person/11089676"
  },
  {
    "license": {
      "name": "CC BY-SA",
      "version": "4.0",
      "url": "https://creativecommons.org/licenses/by-sa/4.0/deed.de"
    },
    "forename": "Andreas",
    "names": [
      {
        "forename": "Andreas",
        "surname": "Hans",
        "fullname": "Andreas Hans",
        "lang": "deu",
        "type": "standard",
        "attributions": [
          {
            "institution": "SSRQ"
          }
        ]
      }
    ],
    "surname": "Hans",
    "hhb_id": 11110268,
    "sex": [
      {
        "term": {
          "id": 18001363,
          "labels": {
            "fra": "masculin",
            "deu": "m\u00e4nnlich",
            "ita": "maschile",
            "eng": "male"
          }
        },
        "attributions": [
          {
            "institution": "SSRQ"
          }
        ]
      }
    ],
    "external_ids": [
      {
        "institution": "SSRQ",
        "external_id": "per010240"
      }
    ],
    "label_name": "Andreas Hans",
    "url": "https://data.histhub.ch/person/11110268"
  },
  {
    "license": {
      "name": "CC BY-SA",
      "version": "4.0",
      "url": "https://creativecommons.org/licenses/by-sa/4.0/deed.de"
    },
    "forename": "Elsa",
    "relations_to_place": [
      {
        "type": {
          "id": 18001362,
          "labels": {
            "deu": "Wohnort",
            "eng": "residence"
          }
        },
        "attributions": [
          {
            "institution": "SSRQ"
          }
        ]
      }
    ],
    "names": [
      {
        "forename": "Elsa",
        "surname": "Henser",
        "fullname": "Elsa Henser",
        "lang": "deu",
        "type": "standard",
        "attributions": [
          {
            "institution": "SSRQ"
          }
        ]
      },
      {
        "forename": "Elsa",
        "surname": "Hans",
        "fullname": "Elsa Hans",
        "lang": "deu",
        "type": "standard",
        "attributions": [
          {
            "institution": "SSRQ"
          }
        ]
      }
    ],
    "surname": "Henser",
    "hhb_id": 11103792,
    "sex": [
      {
        "term": {
          "id": 18001364,
          "labels": {
            "fra": "f\u00e9minine",
            "deu": "weiblich",
            "ita": "femminile",
            "eng": "female"
          }
        },
        "attributions": [
          {
            "institution": "SSRQ"
          }
        ]
      }
    ],
    "relations": [
      {
        "person": {
          "name": "Rudolf Hans",
          "id": 11103796,
          "uri": "https://data.histhub.ch/person/11103796"
        },
        "attributions": [
          {
            "institution": "SSRQ"
          }
        ],
        "relation": {
          "id": 18002554,
          "labels": {
            "deu": "Ehefrau von",
            "eng": "wife of"
          }
        }
      }
    ],
    "external_ids": [
      {
        "institution": "SSRQ",
        "external_id": "per008578"
      }
    ],
    "label_name": "Elsa Henser",
    "url": "https://data.histhub.ch/person/11103792"
  },
  {
    "license": {
      "name": "CC BY-SA",
      "version": "4.0",
      "url": "https://creativecommons.org/licenses/by-sa/4.0/deed.de"
    },
    "forename": "Rudolf",
    "relations_to_place": [
      {
        "type": {
          "id": 18001362,
          "labels": {
            "deu": "Wohnort",
            "eng": "residence"
          }
        },
        "attributions": [
          {
            "institution": "SSRQ"
          }
        ]
      }
    ],
    "names": [
      {
        "forename": "Rudi",
        "surname": "Han\u00df",
        "fullname": "Rudi Han\u00df",
        "lang": "deu",
        "type": "original",
        "attributions": [
          {
            "institution": "SSRQ"
          }
        ]
      },
      {
        "forename": "Rudolf",
        "surname": "Hans",
        "fullname": "Rudolf Hans",
        "lang": "deu",
        "type": "standard",
        "attributions": [
          {
            "institution": "SSRQ"
          }
        ]
      }
    ],
    "surname": "Hans",
    "hhb_id": 11103796,
    "sex": [
      {
        "term": {
          "id": 18001363,
          "labels": {
            "fra": "masculin",
            "deu": "m\u00e4nnlich",
            "ita": "maschile",
            "eng": "male"
          }
        },
        "attributions": [
          {
            "institution": "SSRQ"
          }
        ]
      }
    ],
    "relations": [
      {
        "person": {
          "name": "Elsa Hans",
          "id": 11103792,
          "uri": "https://data.histhub.ch/person/11103792"
        },
        "attributions": [
          {
            "institution": "SSRQ"
          }
        ],
        "relation": {
          "id": 18002553,
          "labels": {
            "deu": "Ehemann von",
            "eng": "husband of"
          }
        }
      }
    ],
    "external_ids": [
      {
        "institution": "SSRQ",
        "external_id": "per008579"
      }
    ],
    "label_name": "Rudolf Hans",
    "url": "https://data.histhub.ch/person/11103796"
  },
  {
    "license": {
      "name": "CC BY-SA",
      "version": "4.0",
      "url": "https://creativecommons.org/licenses/by-sa/4.0/deed.de"
    },
    "forename": "Kueni",
    "relations_to_place": [
      {
        "type": {
          "id": 18001362,
          "labels": {
            "deu": "Wohnort",
            "eng": "residence"
          }
        },
        "attributions": [
          {
            "institution": "SSRQ"
          }
        ]
      }
    ],
    "names": [
      {
        "forename": "C\ue72dni",
        "surname": "Hanns",
        "fullname": "C\ue72dni Hanns",
        "lang": "deu",
        "type": "original",
        "attributions": [
          {
            "institution": "SSRQ"
          }
        ]
      },
      {
        "forename": "Kueni",
        "surname": "Hans",
        "fullname": "Kueni Hans",
        "lang": "deu",
        "type": "standard",
        "attributions": [
          {
            "institution": "SSRQ"
          }
        ]
      }
    ],
    "surname": "Hans",
    "hhb_id": 11084700,
    "sex": [
      {
        "term": {
          "id": 18001363,
          "labels": {
            "fra": "masculin",
            "deu": "m\u00e4nnlich",
            "ita": "maschile",
            "eng": "male"
          }
        },
        "attributions": [
          {
            "institution": "SSRQ"
          }
        ]
      }
    ],
    "relations": [
      {
        "person": {
          "name": "Greta Hans",
          "id": 11084704,
          "uri": "https://data.histhub.ch/person/11084704"
        },
        "attributions": [
          {
            "institution": "SSRQ"
          }
        ],
        "relation": {
          "id": 18002553,
          "labels": {
            "deu": "Ehemann von",
            "eng": "husband of"
          }
        }
      },
      {
        "person": {
          "name": "Greta Hans",
          "id": 11084704,
          "uri": "https://data.histhub.ch/person/11084704"
        },
        "attributions": [
          {
            "institution": "SSRQ"
          }
        ],
        "relation": {
          "id": 18002568,
          "labels": {
            "deu": "Sohn von",
            "eng": "son of"
          }
        }
      },
      {
        "person": {
          "name": "Kueni Hans",
          "id": 11084708,
          "uri": "https://data.histhub.ch/person/11084708"
        },
        "attributions": [
          {
            "institution": "SSRQ"
          }
        ],
        "relation": {
          "id": 18002542,
          "labels": {
            "fra": "p\u00e8re de",
            "deu": "Vater von",
            "ita": "padre di",
            "eng": "father of"
          }
        }
      }
    ],
    "external_ids": [
      {
        "institution": "SSRQ",
        "external_id": "per003433"
      }
    ],
    "label_name": "Kueni Hans",
    "url": "https://data.histhub.ch/person/11084700"
  },
  {
    "license": {
      "name": "CC BY-SA",
      "version": "4.0",
      "url": "https://creativecommons.org/licenses/by-sa/4.0/deed.de"
    },
    "forename": "Greta",
    "names": [
      {
        "forename": "Gretta",
        "surname": "Hanns",
        "fullname": "Gretta Hanns",
        "lang": "deu",
        "type": "original",
        "attributions": [
          {
            "institution": "SSRQ"
          }
        ]
      },
      {
        "forename": "Greta",
        "surname": "Hans",
        "fullname": "Greta Hans",
        "lang": "deu",
        "type": "standard",
        "attributions": [
          {
            "institution": "SSRQ"
          }
        ]
      }
    ],
    "surname": "Hans",
    "hhb_id": 11084704,
    "sex": [
      {
        "term": {
          "id": 18001364,
          "labels": {
            "fra": "f\u00e9minine",
            "deu": "weiblich",
            "ita": "femminile",
            "eng": "female"
          }
        },
        "attributions": [
          {
            "institution": "SSRQ"
          }
        ]
      }
    ],
    "relations": [
      {
        "person": {
          "name": "Kueni Hans",
          "id": 11084700,
          "uri": "https://data.histhub.ch/person/11084700"
        },
        "attributions": [
          {
            "institution": "SSRQ"
          }
        ],
        "relation": {
          "id": 18002554,
          "labels": {
            "deu": "Ehefrau von",
            "eng": "wife of"
          }
        }
      },
      {
        "person": {
          "name": "Kueni Hans",
          "id": 11084700,
          "uri": "https://data.histhub.ch/person/11084700"
        },
        "attributions": [
          {
            "institution": "SSRQ"
          }
        ],
        "relation": {
          "id": 18002542,
          "labels": {
            "fra": "p\u00e8re de",
            "deu": "Vater von",
            "ita": "padre di",
            "eng": "father of"
          }
        }
      }
    ],
    "external_ids": [
      {
        "institution": "SSRQ",
        "external_id": "per003434"
      }
    ],
    "label_name": "Greta Hans",
    "url": "https://data.histhub.ch/person/11084704"
  },
  {
    "license": {
      "name": "CC BY-SA",
      "version": "4.0",
      "url": "https://creativecommons.org/licenses/by-sa/4.0/deed.de"
    },
    "forename": "Kueni",
    "names": [
      {
        "forename": "C\ue72dni",
        "surname": "Hanns",
        "fullname": "C\ue72dni Hanns",
        "lang": "deu",
        "type": "original",
        "attributions": [
          {
            "institution": "SSRQ"
          }
        ]
      },
      {
        "forename": "Kueni",
        "surname": "Hans",
        "fullname": "Kueni Hans",
        "lang": "deu",
        "type": "standard",
        "attributions": [
          {
            "institution": "SSRQ"
          }
        ]
      }
    ],
    "surname": "Hans",
    "hhb_id": 11084708,
    "sex": [
      {
        "term": {
          "id": 18001363,
          "labels": {
            "fra": "masculin",
            "deu": "m\u00e4nnlich",
            "ita": "maschile",
            "eng": "male"
          }
        },
        "attributions": [
          {
            "institution": "SSRQ"
          }
        ]
      }
    ],
    "relations": [
      {
        "person": {
          "name": "Kueni Hans",
          "id": 11084700,
          "uri": "https://data.histhub.ch/person/11084700"
        },
        "attributions": [
          {
            "institution": "SSRQ"
          }
        ],
        "relation": {
          "id": 18002568,
          "labels": {
            "deu": "Sohn von",
            "eng": "son of"
          }
        }
      }
    ],
    "external_ids": [
      {
        "institution": "SSRQ",
        "external_id": "per003435"
      }
    ],
    "label_name": "Kueni Hans",
    "url": "https://data.histhub.ch/person/11084708"
  }
]

Type-insensitive search

POST https://data.histhub.ch/api/search/ 
{
  "version": 1,
  "q": "Einsiedeln"
}
[
  {
    "localisations": [
      {
        "localisation": {
          "coordinates": "POINT (699500 220150)",
          "gps": "POINT (8.749978704628615 47.12485848440517)",
          "srid": 21781
        },
        "attributions": [
          {
            "institution": "ortsnamen.ch",
            "caption": "Siehe [Datengrundlage](http://www.ortsnamen.ch/index.php/datenbank-info.html) von ortsnamen.ch; f\u00fcr die [Online-Publikation](https://search.ortsnamen.ch/record/16000011) aufbereitet durch [ortsnamen.ch](https://search.ortsnamen.ch)"
          }
        ]
      }
    ],
    "license": {
      "name": "CC BY-SA",
      "version": "4.0",
      "url": "https://creativecommons.org/licenses/by-sa/4.0/deed.de"
    },
    "types": [
      {
        "type": {
          "id": 18001192,
          "labels": {
            "fra": "Village",
            "deu": "Dorf",
            "ita": "Villaggio",
            "eng": "village"
          }
        },
        "attributions": [
          {
            "institution": "ortsnamen.ch",
            "caption": "Siehe [Datengrundlage](http://www.ortsnamen.ch/index.php/datenbank-info.html) von ortsnamen.ch; f\u00fcr die [Online-Publikation](https://search.ortsnamen.ch/record/16000011) aufbereitet durch [ortsnamen.ch](https://search.ortsnamen.ch)"
          }
        ]
      },
      {
        "type": {
          "id": 18001213,
          "labels": {
            "fra": "Commune",
            "deu": "Gemeinde (politische)",
            "ita": "Comune",
            "eng": "municipality"
          }
        },
        "attributions": [
          {
            "institution": "ortsnamen.ch",
            "caption": "Siehe [Datengrundlage](http://www.ortsnamen.ch/index.php/datenbank-info.html) von ortsnamen.ch; f\u00fcr die [Online-Publikation](https://search.ortsnamen.ch/record/16000011) aufbereitet durch [ortsnamen.ch](https://search.ortsnamen.ch)"
          }
        ]
      },
      {
        "type": {
          "id": 18001221,
          "labels": {
            "fra": "District",
            "deu": "Bezirk",
            "eng": "Bezirk"
          }
        },
        "attributions": [
          {
            "institution": "ortsnamen.ch",
            "caption": "Siehe [Datengrundlage](http://www.ortsnamen.ch/index.php/datenbank-info.html) von ortsnamen.ch; f\u00fcr die [Online-Publikation](https://search.ortsnamen.ch/record/16000011) aufbereitet durch [ortsnamen.ch](https://search.ortsnamen.ch)"
          }
        ]
      }
    ],
    "names": [
      {
        "name": "Einsiedeln",
        "type": "original",
        "lang": "deu",
        "attributions": [
          {
            "institution": "ortsnamen.ch",
            "caption": "Siehe [Datengrundlage](http://www.ortsnamen.ch/index.php/datenbank-info.html) von ortsnamen.ch; f\u00fcr die [Online-Publikation](https://search.ortsnamen.ch/record/16000011) aufbereitet durch [ortsnamen.ch](https://search.ortsnamen.ch)"
          }
        ]
      }
    ],
    "hhb_id": 12177691,
    "existences": [
      {
        "start": null,
        "end": {
          "date": "2019-01-01",
          "precision": {
            "mode": "after",
            "unit": "year",
            "size": "1",
            "type": "certain"
          },
          "type": {
            "id": 18002036,
            "labels": {
              "fra": "derni\u00e8re mention",
              "deu": "Letzterw\u00e4hnung",
              "ita": "ultima menzione",
              "eng": "last mention"
            }
          }
        }
      }
    ],
    "external_ids": [
      {
        "institution": "ortsnamen.ch",
        "external_id": 16000011
      }
    ],
    "label_name": "Einsiedeln",
    "url": "https://data.histhub.ch/place/12177691"
  },
  {
    "license": {
      "name": "CC BY-SA",
      "version": "4.0",
      "url": "https://creativecommons.org/licenses/by-sa/4.0/deed.de"
    },
    "names": [
      {
        "name": "Maria Einsiedeln",
        "type": "original",
        "lang": "deu",
        "attributions": [
          {
            "institution": "ortsnamen.ch",
            "caption": "Siehe [Datengrundlage](http://www.ortsnamen.ch/index.php/datenbank-info.html) von ortsnamen.ch; f\u00fcr die [Online-Publikation](https://search.ortsnamen.ch/record/16017808) aufbereitet durch [ortsnamen.ch](https://search.ortsnamen.ch)"
          }
        ]
      }
    ],
    "hhb_id": 12458902,
    "external_ids": [
      {
        "institution": "ortsnamen.ch",
        "external_id": 16017808
      }
    ],
    "label_name": "Maria Einsiedeln",
    "url": "https://data.histhub.ch/place/12458902"
  },
  {
    "license": {
      "name": "CC BY-SA",
      "version": "4.0",
      "url": "https://creativecommons.org/licenses/by-sa/4.0/deed.de"
    },
    "types": [
      {
        "type": {
          "id": 18002275,
          "labels": {
            "deu": "Benediktiner"
          }
        },
        "attributions": [
          {
            "institution": "SSRQ"
          }
        ]
      }
    ],
    "names": [
      {
        "name": "Einsiedeln",
        "type": "standard",
        "lang": "deu",
        "attributions": [
          {
            "institution": "SSRQ"
          }
        ]
      }
    ],
    "relations_to_place": [
      {
        "place": {
          "name": "Ainsidellen",
          "id": 12489907,
          "uri": "https://data.histhub.ch/place/12489907"
        },
        "attributions": [
          {
            "institution": "SSRQ"
          }
        ]
      }
    ],
    "hhb_id": 11803113,
    "external_ids": [
      {
        "institution": "SSRQ",
        "external_id": "org000577"
      },
      {
        "institution": "HLS",
        "external_id": 11491
      }
    ],
    "label_name": "Einsiedeln",
    "url": "https://data.histhub.ch/org/11803113"
  },
  {
    "license": {
      "name": "CC BY-SA",
      "version": "4.0",
      "url": "https://creativecommons.org/licenses/by-sa/4.0/deed.de"
    },
    "forename": "Konrad",
    "names": [
      {
        "forename": "Konrad",
        "surname": "von Rechberg",
        "fullname": "Konrad von Rechberg",
        "lang": "deu",
        "type": "standard",
        "attributions": [
          {
            "institution": "HLS"
          }
        ]
      },
      {
        "forename": "Konrad",
        "surname": "von Rechberg",
        "fullname": "Konrad von Rechberg",
        "lang": "fra",
        "type": "standard",
        "attributions": [
          {
            "institution": "HLS"
          }
        ]
      },
      {
        "forename": "Konrad",
        "surname": "von Rechberg",
        "fullname": "Konrad von Rechberg",
        "lang": "ita",
        "type": "standard",
        "attributions": [
          {
            "institution": "HLS"
          }
        ]
      },
      {
        "forename": "Konrad",
        "surname": "von Rechberg",
        "fullname": "Konrad von Rechberg",
        "lang": "deu",
        "type": "standard",
        "attributions": [
          {
            "institution": "SSRQ"
          }
        ]
      },
      {
        "forename": "Konrad",
        "surname": "Einsiedeln",
        "fullname": "Konrad Einsiedeln",
        "lang": "deu",
        "type": "standard",
        "attributions": [
          {
            "institution": "SSRQ"
          }
        ]
      }
    ],
    "surname": "von Rechberg",
    "hhb_id": 11076684,
    "sex": [
      {
        "term": {
          "id": 18001363,
          "labels": {
            "fra": "masculin",
            "deu": "m\u00e4nnlich",
            "ita": "maschile",
            "eng": "male"
          }
        },
        "attributions": [
          {
            "institution": "HLS"
          }
        ]
      },
      {
        "term": {
          "id": 18001363,
          "labels": {
            "fra": "masculin",
            "deu": "m\u00e4nnlich",
            "ita": "maschile",
            "eng": "male"
          }
        },
        "attributions": [
          {
            "institution": "SSRQ"
          }
        ]
      }
    ],
    "existences": [
      {
        "start": {
          "date": "1440-01-01",
          "precision": {
            "mode": "after",
            "unit": "year",
            "size": "1",
            "type": "certain"
          },
          "type": {
            "id": 18002038,
            "labels": {
              "fra": "Naissance",
              "deu": "Geburt",
              "ita": "Nascita",
              "eng": "birth"
            }
          }
        },
        "end": {
          "date": "1526-09-01",
          "precision": {
            "mode": "after",
            "unit": "day",
            "size": "1",
            "type": "certain"
          },
          "type": {
            "id": 18002039,
            "labels": {
              "fra": "D\u00e9c\u00e8s",
              "deu": "Tod",
              "ita": "morte",
              "eng": "death"
            }
          }
        }
      }
    ],
    "occupations": [
      {
        "organization": {
          "name": "Einsiedeln",
          "id": 11803113,
          "uri": "https://data.histhub.ch/org/11803113"
        },
        "term": {
          "id": 18002593,
          "labels": {
            "fra": "Abb\u00e9",
            "deu": "Abt",
            "ita": "Abate"
          }
        },
        "attributions": [
          {
            "institution": "SSRQ"
          }
        ]
      }
    ],
    "external_ids": [
      {
        "institution": "HLS",
        "external_id": 12705
      },
      {
        "institution": "GND",
        "external_id": 1018386068
      },
      {
        "institution": "SSRQ",
        "external_id": "per001082"
      }
    ],
    "label_name": "Konrad von Rechberg",
    "url": "https://data.histhub.ch/person/11076684"
  },
  {
    "license": {
      "name": "CC BY-SA",
      "version": "4.0",
      "url": "https://creativecommons.org/licenses/by-sa/4.0/deed.de"
    },
    "relations_to_concept": [
      {
        "concept": {
          "id": 18005102,
          "uri": "https://data.histhub.ch/concept/18005102",
          "labels": {
            "deu": "Frieden (im Krieg)"
          }
        },
        "relation": "see_also"
      }
    ],
    "hhb_id": 18004492,
    "external_ids": [
      {
        "institution": "SSRQ",
        "external_id": "key003970"
      }
    ],
    "definitions": [
      {
        "text": "Friede der vier Orte Z\u00fcrich, Luzern, Schwyz und Glarus mit der Stadt St. Gallen und dem Land Appenzell nach dem St. Galler Krieg (1489\u20131490)",
        "lang": "deu",
        "attributions": [
          {
            "institution": "SSRQ"
          }
        ]
      }
    ],
    "label_name": "Friede von Einsiedeln (07.03.1490)",
    "labels": [
      {
        "is_preferred": true,
        "text": "Friede von Einsiedeln (07.03.1490)",
        "lang": "deu"
      }
    ],
    "url": "https://data.histhub.ch/concept/18004492"
  }
]

Max result count (default: 10)

POST https://data.histhub.ch/api/search/place/ 
{
  "version": 1,
  "limit": 2
}
[
  {
    "localisations": [
      {
        "localisation": {
          "coordinates": "POINT (611751 204875)",
          "gps": "POINT (46.9948312051505 7.593120183679544)",
          "srid": 21781
        },
        "attributions": [
          {
            "institution": "Ortsnamenbuch des Kantons Bern",
            "caption": "[Ortsnamenbuch des Kantons Bern](http://www.germanistik.unibe.ch/namenkunde/) \u2013 Ortsnamenbuch des Kantons Bern [Alter Kantonsteil]. I: Dokumentation und Deutung. Bern, Basel u. T\u00fcbingen: A. Francke. 1976 ff.; f\u00fcr die [Online-Publikation](https://search.ortsnamen.ch/record/309061494) aufbereitet durch [ortsnamen.ch](https://search.ortsnamen.ch)",
            "revision": "ortsnamen.ch"
          }
        ]
      }
    ],
    "license": {
      "name": "CC BY-SA",
      "version": "4.0",
      "url": "https://creativecommons.org/licenses/by-sa/4.0/deed.de"
    },
    "types": [
      {
        "type": {
          "id": 18001240,
          "labels": {
            "fra": "For\u00eat",
            "deu": "Wald",
            "ita": "Bosco",
            "eng": "forest"
          }
        },
        "attributions": [
          {
            "institution": "Ortsnamenbuch des Kantons Bern",
            "caption": "[Ortsnamenbuch des Kantons Bern](http://www.germanistik.unibe.ch/namenkunde/) \u2013 Ortsnamenbuch des Kantons Bern [Alter Kantonsteil]. I: Dokumentation und Deutung. Bern, Basel u. T\u00fcbingen: A. Francke. 1976 ff.; f\u00fcr die [Online-Publikation](https://search.ortsnamen.ch/record/309061494) aufbereitet durch [ortsnamen.ch](https://search.ortsnamen.ch)",
            "revision": "ortsnamen.ch"
          }
        ]
      }
    ],
    "names": [
      {
        "name": "Br\u00fcschhalde",
        "type": "original",
        "lang": "deu",
        "attributions": [
          {
            "institution": "Ortsnamenbuch des Kantons Bern",
            "caption": "[Ortsnamenbuch des Kantons Bern](http://www.germanistik.unibe.ch/namenkunde/) \u2013 Ortsnamenbuch des Kantons Bern [Alter Kantonsteil]. I: Dokumentation und Deutung. Bern, Basel u. T\u00fcbingen: A. Francke. 1976 ff.; f\u00fcr die [Online-Publikation](https://search.ortsnamen.ch/record/309061494) aufbereitet durch [ortsnamen.ch](https://search.ortsnamen.ch)",
            "revision": "ortsnamen.ch"
          }
        ]
      }
    ],
    "hhb_id": 12043907,
    "existences": [
      {
        "start": {
          "type": {
            "id": 18002037,
            "labels": {
              "fra": "premi\u00e8re mention",
              "deu": "Ersterw\u00e4hnung",
              "ita": "prima menzione",
              "eng": "first mention"
            }
          }
        },
        "end": {
          "type": {
            "id": 18002036,
            "labels": {
              "fra": "derni\u00e8re mention",
              "deu": "Letzterw\u00e4hnung",
              "ita": "ultima menzione",
              "eng": "last mention"
            }
          }
        }
      }
    ],
    "external_ids": [
      {
        "institution": "ortsnamen.ch",
        "external_id": 309061494
      }
    ],
    "label_name": "Br\u00fcschhalde",
    "url": "https://data.histhub.ch/place/12043907"
  },
  {
    "localisations": [
      {
        "localisation": {
          "coordinates": "POINT (611752 187875)",
          "gps": "POINT (46.84191275418268 7.592696861952314)",
          "srid": 21781
        },
        "attributions": [
          {
            "institution": "Ortsnamenbuch des Kantons Bern",
            "caption": "[Ortsnamenbuch des Kantons Bern](http://www.germanistik.unibe.ch/namenkunde/) \u2013 Ortsnamenbuch des Kantons Bern [Alter Kantonsteil]. I: Dokumentation und Deutung. Bern, Basel u. T\u00fcbingen: A. Francke. 1976 ff.; f\u00fcr die [Online-Publikation](https://search.ortsnamen.ch/record/309030280) aufbereitet durch [ortsnamen.ch](https://search.ortsnamen.ch)",
            "revision": "ortsnamen.ch"
          }
        ]
      }
    ],
    "license": {
      "name": "CC BY-SA",
      "version": "4.0",
      "url": "https://creativecommons.org/licenses/by-sa/4.0/deed.de"
    },
    "names": [
      {
        "name": "Hubematt",
        "type": "original",
        "lang": "deu",
        "attributions": [
          {
            "institution": "Ortsnamenbuch des Kantons Bern",
            "caption": "[Ortsnamenbuch des Kantons Bern](http://www.germanistik.unibe.ch/namenkunde/) \u2013 Ortsnamenbuch des Kantons Bern [Alter Kantonsteil]. I: Dokumentation und Deutung. Bern, Basel u. T\u00fcbingen: A. Francke. 1976 ff.; f\u00fcr die [Online-Publikation](https://search.ortsnamen.ch/record/309030280) aufbereitet durch [ortsnamen.ch](https://search.ortsnamen.ch)",
            "revision": "ortsnamen.ch"
          }
        ]
      }
    ],
    "hhb_id": 12043908,
    "existences": [
      {
        "start": {
          "type": {
            "id": 18002037,
            "labels": {
              "fra": "premi\u00e8re mention",
              "deu": "Ersterw\u00e4hnung",
              "ita": "prima menzione",
              "eng": "first mention"
            }
          }
        },
        "end": {
          "date": "2019-01-01",
          "precision": {
            "mode": "after",
            "unit": "year",
            "size": "1",
            "type": "certain"
          },
          "type": {
            "id": 18002036,
            "labels": {
              "fra": "derni\u00e8re mention",
              "deu": "Letzterw\u00e4hnung",
              "ita": "ultima menzione",
              "eng": "last mention"
            }
          }
        }
      }
    ],
    "external_ids": [
      {
        "institution": "ortsnamen.ch",
        "external_id": 309030280
      }
    ],
    "label_name": "Hubematt",
    "url": "https://data.histhub.ch/place/12043908"
  }
]

All results

POST https://data.histhub.ch/api/search/place/ 
{
  "version": 1,
  "limit": 0
}

Field names

name
Type-insensitive umbrella field comprising all fields containing a name of the entity
label_name
Normalised name, as shown on the details page
url
histHub URL
min_year
Entity must be mentioned sometime after this year
max_year
Entity must be mentioned sometime before this year
attributions
Data sources (e.g. "HLS" for Historisches Lexikon der Schweiz)
external_ids.institution
Other institution cataloguing this entity
external_ids.external_id
ID of this entity with that other institution
names.forename
Forename
names.surname
Surname
names.fullname
Full name
names.lang
Name's language as ISO 639-3 code (e.g. "deu")
names.attributions
Data source
titles.term
Title
titles.attributions
Data source
existence.start.date
Birth date as ISO 8601 string
existence.start.precision
Precision of the birth date
existence.end.date
Death date as ISO 8601 string
existence.end.precision
Precision of the death date
existence.attributions
Data source
sex.term
Gender (typically "female" oder "male")
sex.provider
Data source
occupations.term
Occupation
occupations.attributions
Data source
relations.person_name
Name of other, related person
relations.relation
Type of that relation (e.g. "fatherOf", "employerOf")
relations.person_id
Related person's histHub ID
relations.person_uri
Related person's histHub URL
names.name
Place name
names.lang
Name's language as ISO 639-3 code (e.g. "deu")
names.attributions
Data source
types.type.labels.deu
Place type as a German word
types.type.id
Place type as a numerical ID
types.attributions
Data source