---
title: "GET /search/{system_class}"
method: GET
path: "/search/{system_class}"
tags: ["Proposal"]
---

# GET /search/{system_class}

`GET /search/{system_class}`

Searches the database for entries matching a provided search term. 
  Results are ordered with exact prefix matches appearing first, followed by entries containing the search term within their name or appellation.

## Path parameters

- `system_class` 'all' | 'acquisition' | 'activity' | 'administrative_unit' | 'appellation' | 'artifact' | 'bibliography' | 'creation' | 'edition' | 'event' | 'external_reference' | 'feature' | 'file' | 'group' | 'human_remains' | 'modification' | 'move' | 'person' | 'place' | 'production' | 'reference_system' | 'source' | 'source_translation' | 'stratigraphic_unit' | 'type' | 'type_tools', required

## Query parameters

- `term` string
- `limit` integer
- `page` integer

## Response `200`

Success

- SearchModel
  - `name` string, required — The name of the entity
  - `id` string, uri, required — The unique identifier URL of the entity
  - `description` string, nullable — A description of the entity
  - `system_class` string, required — The system class of the entity
  - `begin` string, date-time, nullable — The start date of the entity
  - `end` string, date-time, nullable — The end date of the entity

## Other responses

- `400` — Bad Request
- `401` — Unauthorized
- `403` — Access denied
- `404` — Resource not found
- `409` — Conflict
- `500` — Internal server error

## Changes

- **2025-12-03** `008688998b83` — 6 breaking, 1 info
  - the `allOf[#/components/schemas/ApiError]/url` response's property format changed from `uri` to no format for status `401`
  - the `allOf[#/components/schemas/ApiError]/url` response's property format changed from `uri` to no format for status `403`
  - the `allOf[#/components/schemas/ApiError]/url` response's property format changed from `uri` to no format for status `404`
  - the `allOf[#/components/schemas/ApiError]/url` response's property format changed from `uri` to no format for status `409`
  - …3 more
- **2025-12-02** `26f86ddcd57c` — 1 breaking, 9 info
  - removed the enum value `type_tools` from the `path` request parameter `system_class`
  - added `#/components/schemas/ApiError, subschema #2` to the response body `allOf` list for the response status `404`
  - added `#/components/schemas/ApiError, #/components/schemas/ParameterError, subschema #3` to the response body `anyOf` list for the response status `400`
  - removed `#/components/schemas/ErrorModel, #/components/schemas/ParameterErrorModel` from the response body `oneOf` list for the response status `400`
  - …6 more
- …earlier changes not shown

[Full history](https://skmtc.dev/craws/apis/openatlas-api/changes/search/:system_class/get.md)

---

[API](https://skmtc.dev/craws/apis/openatlas-api.md) · [All operations](https://skmtc.dev/craws/apis/openatlas-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/craws/openatlas-api/revisions/edaf3e95085d/schema)