Buscar Eventos Por Título

Descrição

Retorna uma lista com até 10 eventos filtrados pelo título. É necessário informar ao menos 2 caracteres no parâmetro de busca.

Verbo

GET

URL Base

https://api.soargi.com

Endpoint

/events/search?title=Congresso

Cabeçalhos

Parâmetro Valor
Authorization Bearer Token

Parâmetros de Consulta (Query String)

Parâmetro Tipo Obrigatório Descrição
title string Sim Título ou parte do título do evento (mínimo 2 caracteres).

Sucesso - 200

{
  "success": true,
  "message": "Events filtered successfully.",
  "data": [
    {
      "event_id": 12,
      "title": "Congresso Nacional de Saúde",
      "description": "Evento privado sobre o Congresso Nacional de Saúde.",
      "start_date": "2025-06-06",
      "end_date": "2025-06-07",
      "start_time": "09:00:00",
      "end_time": "18:00:00",
      "country": "US",
      "state": "Florida (FL)",
      "address": "Lakehurst",
      "postal_code": "0000000",
      "timezone": "America/New_York",
      "cover_image": "https://api.soargi.com/public/images/events/1745714592_62ff3a0df888e555ceea.png",
      "otp": "915511",
      "otp_expiration": "2025-06-07 23:59:59",
      "status": "active",
      "created_by": "João",
      "picture": null,
      "created_at": "2025-04-25 14:52:17",
      "updated_at": "2025-04-27 00:43:12"
    }
  ]
}

Erro - 400 (Título inválido - apenas 1 caracter)

{
    "status": 400,
    "error": 400,
    "messages": {
        "error": "Please provide at least 2 characters to search."
    }
}

Erro - 404 (Nenhum evento encontrado)

{
    "status": 404,
    "error": 404,
    "messages": {
        "error": "No events found with the provided title."
    }
}

Códigos de Resposta

  • 200 - Eventos encontrados
  • 422 - Parâmetro "title" inválido ou ausente
  • 404 - Nenhum evento encontrado