API Reference – Token Verification

Welcome to the Hawaiian.gg API reference.
This section documents how to verify a user's authentication token.

---

Base URL

https://auth.hawaiian.gg/api

---

Authentication

All requests to the API require an Authorization header containing a valid bearer token.

Example:

Authorization: Bearer YOUR_ACCESS_TOKEN

---

Verify Token

Endpoint

GET /auth/@users/verify

Description

Validates the token provided by the user and returns a structured payload containing identity information.

---

Request Headers

Header	Type	Required	Description
Authorization	string	✅	Bearer token to validate

---

Request Example

curl -X POST "https://auth.hawaiian.gg/api/auth/@users/verify" \
  -H "Authorization: Bearer YOUR_ACCESS_TOKEN"
Response
200 OK

Field	Type	Description
status	string	Status of the request (success)
user	object	User identity information

Example:

{
  "status": "success",
  "user": {
    "id": "109350302777377037234",
    "name": "Verified Hawaii",
    "email": "verifiedhawaii44@gmail.com",
    "picture": "https://lh3.googleusercontent.com/a/ACg8ocICYCC7ManL_kMU9CKjd..."
  }
}

Error Codes

Status Code	Message
401	Unauthorized – Missing or invalid token
403	Forbidden – Token does not have required scopes
500	Internal Server Error – An error occurred on the server

Example Error Response

{
  "status": "error",
  "message": "Missing or invalid token"
}

Notes Tokens expire after 90 days unless otherwise specified. Scopes determine which endpoints the token can access.