> ## Documentation Index
> Fetch the complete documentation index at: https://docs.thatsme.com.br/llms.txt
> Use this file to discover all available pages before exploring further.

# Listar eventos públicos (sem auth)

> Lista paginada do diretório público de eventos. Retorna apenas eventos de organizações em plano pago, com is_private=false e status ACTIVE. Cada evento inclui ai_analysis (skills, keywords, level) extraído via IA — pensado pra busca semântica por LLMs (Claude, GPT, Gemini) e SEO. Rate limit: 30 req/min por IP.



## OpenAPI

````yaml /openapi.json get /event/public-list
openapi: 3.0.3
info:
  title: That's Me API
  version: '1.0'
  description: >-
    API pública da That's Me — emita certificados digitais, consulte eventos e
    analytics via API.
servers:
  - url: https://api.thatsme.com.br/api
    description: Produção
  - url: https://servicetest.thatsme.com.br/api
    description: Sandbox
security: []
tags:
  - name: Emissões
    description: Emitir certificados e gerenciar destinatários
  - name: Eventos
    description: Criar e gerenciar eventos
  - name: Badges
    description: Gerenciar badges/TMs
  - name: Saldo
    description: Consultar saldo de emissões
  - name: Dashboard
    description: Analytics e exportação de dados
  - name: Webhooks
    description: Configurar notificações em tempo real
  - name: API Keys
    description: Gerenciar chaves de API
  - name: Verificação
    description: Verificar autenticidade de certificados
paths:
  /event/public-list:
    get:
      tags:
        - Public Directory
      summary: Listar eventos públicos (sem auth)
      description: >-
        Lista paginada do diretório público de eventos. Retorna apenas eventos
        de organizações em plano pago, com is_private=false e status ACTIVE.
        Cada evento inclui ai_analysis (skills, keywords, level) extraído via IA
        — pensado pra busca semântica por LLMs (Claude, GPT, Gemini) e SEO. Rate
        limit: 30 req/min por IP.
      parameters:
        - name: q
          in: query
          required: false
          schema:
            type: string
          description: Termo de busca (busca em name, description, skills, keywords).
        - name: category
          in: query
          required: false
          schema:
            type: string
            enum:
              - SPORTS
              - EDUCATION
              - CORPORATE
              - SOCIOCULTURAL
          description: Filtro por categoria do evento.
        - name: state
          in: query
          required: false
          schema:
            type: string
          description: Filtro por estado/província.
        - name: city
          in: query
          required: false
          schema:
            type: string
          description: Filtro por cidade.
        - name: page
          in: query
          required: false
          schema:
            type: integer
            default: 1
          description: Página (a partir de 1).
        - name: limit
          in: query
          required: false
          schema:
            type: integer
            default: 20
            maximum: 50
          description: Eventos por página (máx 50).
      responses:
        '200':
          description: Lista paginada de eventos públicos com AI analysis.
          content:
            application/json:
              schema:
                type: object
                properties:
                  events:
                    type: array
                    items:
                      $ref: '#/components/schemas/PublicEventDto'
                  total:
                    type: integer
                  page:
                    type: integer
                  totalPages:
                    type: integer
        '429':
          description: Rate limit excedido.
      security: []
components:
  schemas:
    PublicEventDto:
      type: object
      description: Evento do diretório público (sem dados pessoais de destinatários).
      properties:
        event_id:
          type: string
          description: UUID do evento.
        name:
          type: string
        description:
          type: string
          nullable: true
        category:
          type: string
          enum:
            - SPORTS
            - EDUCATION
            - CORPORATE
            - SOCIOCULTURAL
        subcategory:
          type: string
          nullable: true
        city:
          type: string
          nullable: true
        state:
          type: string
          nullable: true
        location_type:
          type: string
          enum:
            - PHYSICAL
            - ONLINE
          nullable: true
        initial_date:
          type: string
          nullable: true
        finish_date:
          type: string
          nullable: true
        recurrence_type:
          type: string
          nullable: true
        image_url:
          type: string
          nullable: true
        official_url:
          type: string
          nullable: true
        certificate_count:
          type: integer
          description: Número de certificados já emitidos por este evento.
        ai_analysis:
          type: object
          nullable: true
          description: >-
            Análise semântica do evento gerada por IA. Use isso pra match com
            histórico do usuário.
          properties:
            skills:
              type: array
              items:
                type: object
                properties:
                  label:
                    type: string
                  confidence:
                    type: number
            keywords:
              type: array
              items:
                type: object
                properties:
                  label:
                    type: string
                  confidence:
                    type: number
            level:
              type: string
              nullable: true
        issuer:
          type: object
          description: >-
            Perfil público do emissor. NÃO contém dados pessoais de
            destinatários.
          properties:
            name:
              type: string
            company_name:
              type: string
              nullable: true
            nickname:
              type: string
              nullable: true
            pic_url:
              type: string
              nullable: true
            verified:
              type: boolean
              description: True se a organização passou no KYB.
        platform_url:
          type: string
          description: URL canônica do evento na plataforma That's Me.

````