Docs menu

VLR API endpoint

VLR.gg events API

Returns Valorant events from VLR.gg: ongoing, upcoming and completed events with prize pool, dates and region flag. Filter by `tier` (`all`, `vct`, `vcl`, `t3`, `gc`, `cg`, `off`) and `region` (`all`, `americas`, `emea`, `pacific`, `china`); `page` pages through completed events. Use vlr-event with a returned `id`.

GETapiKey1 credit/requestVLR/vlr/events

Endpoint facts

Method: GET
API path: /vlr/events
Auth: apiKey
Credits: 1 credit/request
Charged on: Successful 2xx responses only
Platform: VLR

VLR.gg VALORANT Esports API Try VLR.gg events API in Playground VLR API documentation

How this endpoint behaves

Header: x-api-key required.

Parameters:

tier: optional; allowed values: all, vct, vcl, t3, gc, cg, off. Default all. vct is the Valorant Champions Tour, vcl Challengers, t3 Tier 3, gc Game Changers, cg Collegiate, off Offseason.
region: optional; allowed values: all, americas, emea, pacific, china. Default all.
page: optional 1-based page of the list, default 1.

Notable response behavior:

status has these values: upcoming, ongoing, completed. prize and dates are the site's display strings.
has_more is true while further pages exist.
The response is cached for up to ten minutes.

Sampled response

Request, 29 Oct 2026: GET /vlr/events?tier=vct
Items in events: 73
Fields filled in every checked item: 8

Field	Filled in, of 73 checked	Values in the sample
id	73
name	73	“VCT 2026: China Threshold” and 72 other values
url	73	vlr.gg
status	73	completed (50), upcoming (22), ongoing (1)
prize	73	TBD (31), $0 (21), $250,000 (11) and 4 more
dates	73	“Oct 21—Nov 1” and 67 other values
country_code	73
image_url	73	owcdn.net

Request parameters

Parameter	Type	Required	Default	Description
x-api-key (header)	string	Yes		API key required
tier	string	No	all	Event tier; one of all, vct, vcl, t3, gc, cg, off; defaults to all Allowed values: all, vct, vcl, t3, gc, cg, off.
region	string	No	all	Event region; one of all, americas, emea, pacific, china; defaults to all Allowed values: all, americas, emea, pacific, china.
page	integer	No	1	1-based page number; defaults to 1 Minimum: 1. Maximum: 500.

cURL example

curl -X GET "https://api.crawlora.net/api/v1/vlr/events?tier=all&region=all&page=1" \
  -H "x-api-key: $CRAWLORA_API_KEY"

Example JSON response

{
  "code": 200,
  "msg": "OK",
  "data": {
    "source_url": "https://www.vlr.gg/events",
    "fetched_at": "2026-10-27T10:00:00Z",
    "tier": "all",
    "region": "all",
    "page": 1,
    "count": 1,
    "has_more": true,
    "events": [
      {
        "id": "3166",
        "name": "VCT 2026: China Threshold",
        "url": "https://www.vlr.gg/event/3166/vct-2026-china-threshold",
        "status": "ongoing",
        "prize": "TBD",
        "dates": "Oct 21—Nov 1",
        "country_code": "cn"
      }
    ]
  }
}

Request schema

No body schema

Response schema

Inline response schema

Field	Type	Required	Enum	Example	Description
code	integer	No			Code is the HTTP status code or a custom code used to indicate the result of the request @example 200
data	vlr.EventsResponse	No
data.count	integer	No		40
data.events	array	No
data.events[].country_code	string	No		br
data.events[].dates	string	No		Oct 22—Nov 3
data.events[].id	string	No		3166
data.events[].image_url	string	No
data.events[].name	string	No		VCT 2026: China Threshold
data.events[].prize	string	No		$500,000
data.events[].status	string	No	upcoming, ongoing, completed	ongoing
data.events[].url	string	No
data.fetched_at	string	No		2026-10-27T10:00:00Z
data.has_more	boolean	No		true
data.page	integer	No		1
data.region	string	No		all
data.source_url	string	No		https://www.vlr.gg/matches
data.tier	string	No		all
msg	unknown	No			Msg is the message that describes the result of the request @example "Request successful"

Failure responses

Status	Description	Schema
400	Bad Request	#/definitions/app.Response
429	Too Many Requests	#/definitions/app.Response
503	Service Unavailable	#/definitions/app.Response

Code examples

Use environment variables for secrets and keep Crawlora API keys server-side.

curl -X GET "https://api.crawlora.net/api/v1/vlr/events?tier=all&region=all&page=1" \
  -H "x-api-key: $CRAWLORA_API_KEY"

Shared guides

Authentication Errors and retries Rate limits and credits Pricing Acceptable use

More VLR endpoint docs VLR.gg VALORANT Esports API VLR.gg event agent pick rates API documentation VLR.gg event matches API documentation VLR.gg event player statistics API documentation VLR.gg event detail API documentation VLR.gg forum categories API documentation VLR.gg forum threads API documentation

Open in Playground Back to group

Docs menu

VLR API endpoint

VLR.gg events API

GETapiKey1 credit/requestVLR/vlr/events

Endpoint facts

Method: GET
API path: /vlr/events
Auth: apiKey
Credits: 1 credit/request
Charged on: Successful 2xx responses only
Platform: VLR

VLR.gg VALORANT Esports API Try VLR.gg events API in Playground VLR API documentation

How this endpoint behaves

Header: x-api-key required.

Parameters:

tier: optional; allowed values: all, vct, vcl, t3, gc, cg, off. Default all. vct is the Valorant Champions Tour, vcl Challengers, t3 Tier 3, gc Game Changers, cg Collegiate, off Offseason.
region: optional; allowed values: all, americas, emea, pacific, china. Default all.
page: optional 1-based page of the list, default 1.

Notable response behavior:

status has these values: upcoming, ongoing, completed. prize and dates are the site's display strings.
has_more is true while further pages exist.
The response is cached for up to ten minutes.

Sampled response

Request, 29 Oct 2026: GET /vlr/events?tier=vct
Items in events: 73
Fields filled in every checked item: 8

Field	Filled in, of 73 checked	Values in the sample
id	73
name	73	“VCT 2026: China Threshold” and 72 other values
url	73	vlr.gg
status	73	completed (50), upcoming (22), ongoing (1)
prize	73	TBD (31), $0 (21), $250,000 (11) and 4 more
dates	73	“Oct 21—Nov 1” and 67 other values
country_code	73
image_url	73	owcdn.net

Request parameters

Parameter	Type	Required	Default	Description
x-api-key (header)	string	Yes		API key required
tier	string	No	all	Event tier; one of all, vct, vcl, t3, gc, cg, off; defaults to all Allowed values: all, vct, vcl, t3, gc, cg, off.
region	string	No	all	Event region; one of all, americas, emea, pacific, china; defaults to all Allowed values: all, americas, emea, pacific, china.
page	integer	No	1	1-based page number; defaults to 1 Minimum: 1. Maximum: 500.

cURL example

curl -X GET "https://api.crawlora.net/api/v1/vlr/events?tier=all&region=all&page=1" \
  -H "x-api-key: $CRAWLORA_API_KEY"

Example JSON response

{
  "code": 200,
  "msg": "OK",
  "data": {
    "source_url": "https://www.vlr.gg/events",
    "fetched_at": "2026-10-27T10:00:00Z",
    "tier": "all",
    "region": "all",
    "page": 1,
    "count": 1,
    "has_more": true,
    "events": [
      {
        "id": "3166",
        "name": "VCT 2026: China Threshold",
        "url": "https://www.vlr.gg/event/3166/vct-2026-china-threshold",
        "status": "ongoing",
        "prize": "TBD",
        "dates": "Oct 21—Nov 1",
        "country_code": "cn"
      }
    ]
  }
}

Request schema

No body schema

Response schema

Inline response schema

Field	Type	Required	Enum	Example	Description
code	integer	No			Code is the HTTP status code or a custom code used to indicate the result of the request @example 200
data	vlr.EventsResponse	No
data.count	integer	No		40
data.events	array	No
data.events[].country_code	string	No		br
data.events[].dates	string	No		Oct 22—Nov 3
data.events[].id	string	No		3166
data.events[].image_url	string	No
data.events[].name	string	No		VCT 2026: China Threshold
data.events[].prize	string	No		$500,000
data.events[].status	string	No	upcoming, ongoing, completed	ongoing
data.events[].url	string	No
data.fetched_at	string	No		2026-10-27T10:00:00Z
data.has_more	boolean	No		true
data.page	integer	No		1
data.region	string	No		all
data.source_url	string	No		https://www.vlr.gg/matches
data.tier	string	No		all
msg	unknown	No			Msg is the message that describes the result of the request @example "Request successful"

Failure responses

Status	Description	Schema
400	Bad Request	#/definitions/app.Response
429	Too Many Requests	#/definitions/app.Response
503	Service Unavailable	#/definitions/app.Response

Code examples

Use environment variables for secrets and keep Crawlora API keys server-side.

curl -X GET "https://api.crawlora.net/api/v1/vlr/events?tier=all&region=all&page=1" \
  -H "x-api-key: $CRAWLORA_API_KEY"

Shared guides

Authentication Errors and retries Rate limits and credits Pricing Acceptable use

Open in Playground Back to group

VLR.gg events API

Endpoint facts

How this endpoint behaves

Sampled response

Request parameters

cURL example

Example JSON response

Failure responses

Code examples

Shared guides

Related

VLR.gg events API

Endpoint facts

How this endpoint behaves

Sampled response

Request parameters

cURL example

Example JSON response

Failure responses

Code examples

Shared guides

Related