Skip to main content
GET
https://service.thatsme.com.br
/
api
/
v1.0
/
events
Listar Eventos
curl --request GET \
  --url https://service.thatsme.com.br/api/v1.0/events \
  --header 'Authorization: Bearer <token>'
{
  "data": [
    {
      "event_id": "event_123",
      "name": "Workshop de Tecnologia",
      "status": "ACTIVE",
      "category": "EDUCATION",
      "created_at": "2024-01-15T10:20:00Z"
    }
  ],
  "total": 20,
  "limit": 10,
  "offset": 0
}
Retorna uma lista enxuta de eventos do próprio emissor autenticado, com foco em localizar o event_id necessário para iniciar emissões de certificados. Este endpoint exige autenticação via Bearer Token e não lista eventos de outros emissores.
Uso recomendado: utilize este endpoint para localizar o event_id
Para obter informações completas de um evento, utilizeGET /api/v1.0/events/{id}

​
Parâmetros de consulta

​
limit
number
Quantidade máxima de eventos retornados por página.
​
offset
number
Posição inicial da listagem para paginação.
​
q
string
Busca textual por nome do evento (case-insensitive). Recomendado para localizar rapidamente o evento desejado.
​
status
string
Filtra por status do evento (ex.: ACTIVE or COMPLETED).
​
category
string
Filtra por categoria do evento (ex.: EDUCATION, SPORTS, CORPORATE, SOCIOCULTURAL).
​
created_from
string
Filtra eventos criados a partir de uma data (ISO 8601).
​
created_to
string
Filtra eventos criados até uma data (ISO 8601).
​
sort
string
Campo de ordenação. Padrão recomendado: created_at.
​
order
string
Ordem de ordenação: asc ou desc.
Padrão recomendado: desc.
limit controla quantos eventos retornam por chamada.
offset controla a partir de qual posição a listagem começa (paginação).Para localizar eventos rapidamente, recomenda-se combinar q + status e ordenar por created_at.

​
Resposta

​
data
array
Lista de eventos do emissor autenticado, retornando somente campos essenciais para identificação.
​
total
number
Quantidade total de eventos encontrados para os filtros aplicados
​
limit
number
Limite aplicado na consulta
​
offset
number
Offset aplicado na consulta

​
Exemplos de uso

GET /api/v1.0/events?limit=10&offset=0&sort=created_at&order=desc

GET /api/v1.0/events?q=workshop&limit=10&offset=0&sort=created_at&order=desc

GET /api/v1.0/events?status=ACTIVE&limit=10&offset=0&sort=created_at&order=desc

​
Exemplo de resposta

{
  "data": [
    {
      "event_id": "event_123",
      "name": "Workshop de Tecnologia",
      "status": "ACTIVE",
      "category": "EDUCATION",
      "created_at": "2024-01-15T10:20:00Z"
    }
  ],
  "total": 20,
  "limit": 10,
  "offset": 0
}