Allegiance API

Coming Soon

Build powerful integrations with the Allegiance Network. Access server data, statistics, and more through our secure REST API.

Authentication

All API requests must be authenticated using a Bearer token in the header. You can generate an API key from your dashboard settings.

curl -X GET "https://api.allegiance-network.com/v1/servers" \
  -H "Authorization: Bearer YOUR_API_KEY"

Keep your API keys secure. Never expose them in client-side code or public repositories.

Core Endpoints

GET/v1/servers

Retrieve a paginated list of public servers ordered by rank.

GET/v1/servers/{id}

Get detailed information about a specific server by ID.

GET/v1/users/me

Get the authenticated user's profile and settings.

POST/v1/servers/{id}/vote

Register a vote for a specific server (Rate limited).

Response Format

All responses are formatted in JSON. Successful requests will return a 200-level status code.

{
  "data": {
    "id": "1234-5678",
    "name": "Awesome Community",
    "members": 15420,
    "tags": ["gaming", "social"]
  },
  "meta": {
    "timestamp": "2024-03-21T10:00:00Z"
  }
}

Rate Limits

Public API60 req/min
Authenticated1000 req/min

Headers are included in every response indicating your remaining quota.

Need Help?

Join our developer community on Discord to discuss the API and get support.

Join Community

Ready to Start Building?

Check out our roadmap to see what's coming next for the API and platform.

View Roadmap