Skip to main content
GET
/
events
/
public
/
list
List events
curl --request GET \
  --url https://api.n2.market/api/v1/events/public/list \
  --header 'X-API-Key: <api-key>'
{
  "events": [
    {
      "id": "event-123",
      "titles": {
        "pt": "Copa do Mundo 2026",
        "en": "World Cup 2026",
        "es": "Copa del Mundo 2026"
      },
      "subTitles": {
        "pt": "Fase de grupos",
        "en": "Group stage",
        "es": "Fase de grupos"
      },
      "descriptions": {
        "pt": "Mercados relacionados à Copa do Mundo",
        "en": "Markets related to the World Cup",
        "es": "Mercados relacionados con la Copa del Mundo"
      },
      "images": [
        "https://cdn.n2.market/events/worldcup.png"
      ],
      "highlighted": true,
      "markets": [
        {
          "id": "market-456",
          "questions": {
            "pt": "Brasil será campeão?",
            "en": "Will Brazil be champion?",
            "es": "¿Brasil será campeón?"
          },
          "outcomes": [
            {
              "id": "yes",
              "text": {
                "pt": "Sim",
                "en": "Yes",
                "es": "Sí"
              },
              "probability": 0.25
            },
            {
              "id": "no",
              "text": {
                "pt": "Não",
                "en": "No",
                "es": "No"
              },
              "probability": 0.75
            }
          ],
          "status": "ACTIVE"
        }
      ],
      "createdAt": "2026-01-15T10:00:00.000Z",
      "updatedAt": "2026-03-30T12:00:00.000Z"
    }
  ],
  "total": 25,
  "limit": 20,
  "offset": 0
}

Authorizations

X-API-Key
string
header
required

API Key for authentication. Get your key from the dashboard.

Query Parameters

highlighted
boolean

Filter by event highlighted status

marketHighlighted
boolean

Filter by market highlighted status within events

categoryIds
string

Comma-separated list of category IDs to filter by

limit
integer
default:20

Maximum number of events to return

Required range: 1 <= x <= 100
offset
integer
default:0

Number of events to skip for pagination

Required range: x >= 0

Response

200 - application/json

List of events retrieved successfully

events
object[]
total
integer
limit
integer
offset
integer