Skip to main content

Documentation Index

Fetch the complete documentation index at: https://mintlify.com/HelenaLM32/ECHO/llms.txt

Use this file to discover all available pages before exploring further.

ECHO extends beyond the digital marketplace into physical cultural programming. Venue managers can register their spaces on the platform, attach events to those spaces, and reach the community of artists and buyers already active on ECHO. Artists looking for live opportunities can discover upcoming events and the venues behind them.

​
Registering a venue

Venue managers create a venue profile that describes the physical space and how to reach it. A venue record captures:
  • Name and address — publicly displayed identifiers
  • Capacity — maximum number of attendees the space can hold
  • Contact details — phone number (telefono), email, and website (sitio_web)
  • Hours (horario) — opening times or availability schedule
  • Photos — up to three images (img1, img2, img3) to showcase the space
{
  "name": "Sala Víctor Jara",
  "address": "Calle del Arte 12, Madrid",
  "capacity": 200,
  "telefono": "+34 912 345 678",
  "email": "info@salavictor.es",
  "sitio_web": "https://salavictor.es",
  "horario": "Lunes a Viernes 10:00–22:00"
}
Upload all three venue photos. Profiles with images receive significantly more engagement from artists browsing for event opportunities.

​
Creating an event

Events are linked to a registered venue and carry everything a visitor needs to decide whether to attend. 
{
  "venue_id": 7,
  "title": "Exposición: Formas del Tiempo",
  "description": "Una exploración de la escultura contemporánea en diálogo con la arquitectura del espacio.",
  "start_date": "2026-06-15T18:00:00",
  "end_date": "2026-06-15T22:00:00",
  "precio": 12.00,
  "categoria": "Arte 3D",
  "link_entradas": "https://entradas.salavictor.es/formas-del-tiempo",
  "img": "/uploads/events/formas-del-tiempo.jpg"
}
Each event stores:
FieldDescription
venue_idThe venue hosting the event
creator_idThe ECHO user who created the event record
titlePublic event name
descriptionFull event description
start_date / end_dateEvent datetime range
precioTicket price (0 for free events)
categoriaCreative discipline the event falls under
link_entradasExternal URL for ticket purchase
imgPromotional image

​
Discovering events

Artists and buyers on ECHO can browse all upcoming events or filter by venue. 
# All events on the platform
GET /events

# Events at a specific venue
GET /events/venue/{venueId}
The GET /events/venue/{venueId} endpoint is also how a venue’s own event calendar is displayed on its public profile — both use cases share the same query.
Events are visible to all authenticated users on ECHO, not just venue managers. Artists can use the event feed to identify venues aligned with their creative discipline.

​
Venue and event reviews

ECHO has a separate review system for venues and events, distinct from the order review system used in the marketplace. Any user can leave a review for a venue or an event after visiting or attending. Reviews include a score from 1 to 5 and an optional comment. The target_type field distinguishes whether the review applies to a VENUE or an EVENT. 
{
  "target_id": 7,
  "target_type": "VENUE",
  "score": 4,
  "comment": "Excelente espacio para exposiciones de pequeño formato. Buena iluminación natural."
}
Each user can submit at most one review per venue and one review per event. Attempting to submit a second review for the same target returns a conflict error.

​
Next steps

Venue Manager Role

Understand the full set of capabilities available to venue managers on ECHO.

Venues API

Full reference for venue registration and management endpoints.

Events API

Full reference for event creation and discovery endpoints.

Build docs developers (and LLMs) love

Get started for freeTalk to us