---
title: "El Salvador Tourism Events Search"
method: POST
path: "/sv/mitur-sv/events-search/v1"
tags: ["El Salvador", "Ministerio de Turismo de El Salvador"]
---

# El Salvador Tourism Events Search

`POST /sv/mitur-sv/events-search/v1`

## Request

- Base URL: `https://api.croma.run`
- URL: `https://api.croma.run/sv/mitur-sv/events-search/v1`
- Auth: HTTP bearer

Search the official agenda of El Salvador's Ministerio de Turismo: festivals, fairs, concerts, sports and cultural events across the country, each with its dates, venue, department and links for more information. Without `from_date` it returns events that have not ended yet. Filter by date range (`from_date`/`to_date`, matched against the days the event runs), `department` and free text over the name and venue. Served by Croma (`as_of` says how current the data is).

**Dataset endpoint**: answers from the whole source in milliseconds and carries `as_of`.

## Headers

- `Idempotency-Key` string

## Request body

- object
  - `query` string: Optional search terms matched against the event's name and venue.
  - `department` '' | 'Ahuachapán' | 'Cabañas' | 'Chalatenango' | 'Cuscatlán' | 'La Libertad' | 'La Paz' | 'La Unión' | 'Morazán' | 'San Miguel' | 'San Salvador' | 'San Vicente' | 'Santa Ana' | 'Sonsonate' | 'Usulután': Optional department of El Salvador, e.g. `La Libertad`, `Santa Ana`, `Usulután`.
  - `from_date` string, date: Optional date filter in yyyy-mm-dd format.
  - `to_date` string, date: Optional date filter in yyyy-mm-dd format.
  - `page` integer: 1-based page number for paginated results.
  - `per_page` integer: Results per page (1-50).

## Response `200`

Successful response

- MiturSvEventsSearchResponse
  - `data` MiturSvEventsSearchData, required
    - `as_of` string, nullable, required: How current the data in this response is.
    - `query` string, required
    - `department` string, nullable, required
    - `from_date` string, required: Events still running on or after this date. Today in El Salvador unless given.
    - `to_date` string, nullable, required
    - `total` number, required: Matches, counted up to 1000.
    - `total_is_exact` boolean, required: False when more than 1000 match: `total` is then 1000, and the pages go on.
    - `page` number, required
    - `per_page` number, required
    - `total_pages` number, required: Pages over `total`; there are more when `total_is_exact` is false.
    - `count` number, required
    - `results` object[], required
      - `id` string, required: The event's permanent id in the official agenda, e.g. "22744".
      - `slug` string, required: The event's slug on the official tourism site.
      - `name` string, required: The event's name.
      - `start_date` string, nullable, required: `yyyy-mm-dd` the event starts.
      - `end_date` string, nullable, required: `yyyy-mm-dd` the event ends; the start date for a one-day event.
      - `venue` string, nullable, required: Where it takes place, e.g. "Centro Histórico de San Salvador".
      - `department` 'Ahuachapán' | 'Cabañas' | 'Chalatenango' | 'Cuscatlán' | 'La Libertad' | 'La Paz' | 'La Unión' | 'Morazán' | 'San Miguel' | 'San Salvador' | 'San Vicente' | 'Santa Ana' | 'Sonsonate' | 'Usulután', nullable, required: The department of El Salvador it takes place in.
      - `links` string[], required: Links the agenda gives for more information: the organiser's page, tickets, a post.
      - `official_url` string, required: The event's page on the official tourism site.
      - `updated_at` string, required: When the Ministerio last changed the event.

## Other responses

- `400`: Invalid request body
- `401`: Missing or invalid API key
- `429`: Rate limit exceeded
- `500`: Internal error
- `502`: Upstream source returned an error

---

[API](https://skmtc.dev/usecroma/apis/croma-marketplace-api.md) · [All operations](https://skmtc.dev/usecroma/apis/croma-marketplace-api/llms.txt) · [OpenAPI document](https://skmtc.dev/usecroma/apis/croma-marketplace-api/revisions/df016cdb29d7?raw)