Mapping

Try it

GET /:handle/mapping

Returns the Elasticsearch mapping for the configured index. Useful for discovering available fields, their types, and analyzers.

Path parameters

Parameter	Type	Description
handle	string	Index handle as configured in config.yaml

Response

Returns the raw Elasticsearch mapping as a JSON object. The structure depends on your index mapping:

{
  "title": {
    "type": "text",
    "analyzer": "standard"
  },
  "country": {
    "type": "keyword"
  },
  "coordinates": {
    "type": "geo_point"
  },
  "population": {
    "type": "integer"
  }
}

Use cases

Discover fields

Find which fields are available for searching, filtering, and faceting.

Check field types

Determine which filter formats to use — keyword for string filters, numeric fields for range filters.

Geo fields

Identify geo_point fields for the geo map.

Histogram fields

Find numeric fields suitable for histograms.

Examples

curl "https://search-api-elysia-production.up.railway.app/collections/mapping"

Error responses

Status	Condition
401	Missing or invalid bearer token
404	Index handle not found