Beladed Events API

Get All

beta

Get All through the reviewed Beladed Events contract.

GET/api/events/general/all

Authentication: public
Minimum permission: read
Accounts: Business, Streamer, Personal
Platforms: server, web, browser-extension, ios, android, react-native
Stability: beta

curl --request GET 'https://api.beladed.dev/api/events/general/all?search=example_search&order=desc&sort=example_sort&limit=25&offset=5&categoryId=id_demo_001&subCategoryId=id_demo_001&experienceTypeId=id_demo_001&experienceSubTypeId=id_demo_001&city=example_city&state=example_state&country=USA&postalCode=example_postalcode&newest=true&upcoming=true' \
  --header 'Accept: application/json'

const response = await fetch("https://api.beladed.dev/api/events/general/all?search=example_search&order=desc&sort=example_sort&limit=25&offset=5&categoryId=id_demo_001&subCategoryId=id_demo_001&experienceTypeId=id_demo_001&experienceSubTypeId=id_demo_001&city=example_city&state=example_state&country=USA&postalCode=example_postalcode&newest=true&upcoming=true", {
  method: "GET",
  headers: {
  "Accept": "application/json"
}
});
const data = await response.json();

import requests

response = requests.request(
    "GET",
    "https://api.beladed.dev/api/events/general/all?search=example_search&order=desc&sort=example_sort&limit=25&offset=5&categoryId=id_demo_001&subCategoryId=id_demo_001&experienceTypeId=id_demo_001&experienceSubTypeId=id_demo_001&city=example_city&state=example_state&country=USA&postalCode=example_postalcode&newest=true&upcoming=true",
    headers={"Accept":"application/json"},
    timeout=30,
)
response.raise_for_status()
data = response.json()

<?php
$client = curl_init("https://api.beladed.dev/api/events/general/all?search=example_search&order=desc&sort=example_sort&limit=25&offset=5&categoryId=id_demo_001&subCategoryId=id_demo_001&experienceTypeId=id_demo_001&experienceSubTypeId=id_demo_001&city=example_city&state=example_state&country=USA&postalCode=example_postalcode&newest=true&upcoming=true");
curl_setopt_array($client, [
  CURLOPT_CUSTOMREQUEST => "GET",
  CURLOPT_HTTPHEADER => ["Accept: application/json"],
  CURLOPT_RETURNTRANSFER => true,
]);
$response = curl_exec($client);

require "net/http"
require "json"

uri = URI("https://api.beladed.dev/api/events/general/all?search=example_search&order=desc&sort=example_sort&limit=25&offset=5&categoryId=id_demo_001&subCategoryId=id_demo_001&experienceTypeId=id_demo_001&experienceSubTypeId=id_demo_001&city=example_city&state=example_state&country=USA&postalCode=example_postalcode&newest=true&upcoming=true")
request = Net::HTTP::Get.new(uri)
request["Accept"] = "application/json"
response = Net::HTTP.start(uri.hostname, uri.port, use_ssl: true) { |http| http.request(request) }

var request = java.net.http.HttpRequest.newBuilder()
    .uri(java.net.URI.create("https://api.beladed.dev/api/events/general/all?search=example_search&order=desc&sort=example_sort&limit=25&offset=5&categoryId=id_demo_001&subCategoryId=id_demo_001&experienceTypeId=id_demo_001&experienceSubTypeId=id_demo_001&city=example_city&state=example_state&country=USA&postalCode=example_postalcode&newest=true&upcoming=true"))
    .header("Accept", "application/json")
    .method("GET", java.net.http.HttpRequest.BodyPublishers.noBody())
    .build();
var response = java.net.http.HttpClient.newHttpClient().send(request, java.net.http.HttpResponse.BodyHandlers.ofString());

package main

import (
  "bytes"
  "net/http"
)

func callBeladed() (*http.Response, error) {
  body := []byte("")
  request, err := http.NewRequest("GET", "https://api.beladed.dev/api/events/general/all?search=example_search&order=desc&sort=example_sort&limit=25&offset=5&categoryId=id_demo_001&subCategoryId=id_demo_001&experienceTypeId=id_demo_001&experienceSubTypeId=id_demo_001&city=example_city&state=example_state&country=USA&postalCode=example_postalcode&newest=true&upcoming=true", bytes.NewReader(body))
  if err != nil { return nil, err }
  request.Header.Set("Accept", "application/json")
  return http.DefaultClient.Do(request)
}

using var client = new HttpClient();
using var request = new HttpRequestMessage(new HttpMethod("GET"), "https://api.beladed.dev/api/events/general/all?search=example_search&order=desc&sort=example_sort&limit=25&offset=5&categoryId=id_demo_001&subCategoryId=id_demo_001&experienceTypeId=id_demo_001&experienceSubTypeId=id_demo_001&city=example_city&state=example_state&country=USA&postalCode=example_postalcode&newest=true&upcoming=true");
request.Headers.TryAddWithoutValidation("Accept", "application/json");
using var response = await client.SendAsync(request);
response.EnsureSuccessStatusCode();

var request = URLRequest(url: URL(string: "https://api.beladed.dev/api/events/general/all?search=example_search&order=desc&sort=example_sort&limit=25&offset=5&categoryId=id_demo_001&subCategoryId=id_demo_001&experienceTypeId=id_demo_001&experienceSubTypeId=id_demo_001&city=example_city&state=example_state&country=USA&postalCode=example_postalcode&newest=true&upcoming=true")!)
request.httpMethod = "GET"
request.setValue("application/json", forHTTPHeaderField: "Accept")
let (data, response) = try await URLSession.shared.data(for: request)

val request = okhttp3.Request.Builder()
  .url("https://api.beladed.dev/api/events/general/all?search=example_search&order=desc&sort=example_sort&limit=25&offset=5&categoryId=id_demo_001&subCategoryId=id_demo_001&experienceTypeId=id_demo_001&experienceSubTypeId=id_demo_001&city=example_city&state=example_state&country=USA&postalCode=example_postalcode&newest=true&upcoming=true")
  .addHeader("Accept", "application/json")
  .method("GET", null)
  .build()
val response = okhttp3.OkHttpClient().newCall(request).execute()

Parameters

searchqueryoptional

string — Filter by search.

Example: example_search

orderqueryoptional

string — Filter by order.

Example: desc

sortqueryoptional

string — Filter by sort.

Example: example_sort

limitqueryoptional

number — Filter by limit.

Example: 25

offsetqueryoptional

number — Filter by offset.

Example: 5

categoryIdqueryoptional

string — Filter by categoryId.

Example: id_demo_001

subCategoryIdqueryoptional

string — Filter by subCategoryId.

Example: id_demo_001

experienceTypeIdqueryoptional

string — Filter by experienceTypeId.

Example: id_demo_001

experienceSubTypeIdqueryoptional

string — Filter by experienceSubTypeId.

Example: id_demo_001

cityqueryoptional

string — Filter by city.

Example: example_city

statequeryoptional

string — Filter by state.

Example: example_state

countryqueryoptional

string — Filter by country.

Example: USA

postalCodequeryoptional

string — Filter by postalCode.

Example: example_postalcode

newestqueryoptional

boolean — Filter by newest.

Example: true

upcomingqueryoptional

boolean — Filter by upcoming.

Example: true

Request body

No body is required.

Responses

200The request succeeded.

Responseapplication/json

Schema

{
  "type": "object",
  "properties": {
    "data": {
      "type": "object",
      "properties": {
        "id": {
          "type": "string"
        },
        "status": {
          "type": "string"
        }
      }
    },
    "requestId": {
      "type": "string"
    }
  }
}

{
  "data": {
    "id": "id_demo_001",
    "status": "available"
  },
  "requestId": "req_demo_001"
}

Errors

400invalid_request

The request did not satisfy the documented contract.

404not_found

The requested public or account-owned resource was not found.

429rate_limited

Retry after the current product limit resets.

Reliability

Idempotency: Read-only operation.
Pagination: Use the documented limit and offset query parameters when present; process results idempotently.
Rate limit: Subject to current account, product, and abuse-protection limits. Honor Retry-After when returned.
Webhook events: No related public event is declared.

Contract provenance

This operation is published from reviewed repository contracts. Source metadata is included for traceability without exposing internal implementation details.

Route owner: ../beladed-api-cloudflare/src/functions/events.js
Handler owner: ../beladed-api-cloudflare/src/functions/core/EventsGeneral.js
Verified: 2026-07-11