API Documentation

Access Belong’s public API to build, integrate, or automate token-gated experiences.
Our latest version (v3) includes OpenAPI documentation, REST endpoints, and developer-friendly responses.

API Versions

Belong API v3

Use our Open API interactive Docs to browse, test, and integrate faster than ever.

• Base URL: https://api.belong.net/api/v3
• OpenAPI JSON: https://api.belong.net/api/v3/openapi

---

Belong API v2 (Legacy)

• Base URL: https://api.belong.net/api/v2
• Note: Limited support. Use v3 for new integrations.

Belong API v1 (Legacy)

Fully deprecated.

Getting Started

1. Explore the docs
   Open API interactive Docs

2. Authenticate if needed
   Use Authorization: Bearer <token> for protected routes.

3. Test requests in browser
   Use the interactive API explorer to run and debug calls directly.

4. Start building
   Fetch events, manage addresses, and mint collections via simple REST endpoints.

Example Use Cases

• Create token-gated events
  → POST /events — Add event with NFT access & visibility rules.

• Autocomplete address input
  → GET /adresses/autocomplete?q=Burning — Get venue suggestions with coordinates.

• Publish Sui NFT collections
  → POST /crypto/sui/collection/publish — Create access tokens for events.