User-friendly and secure login solutions for your app

User Information Endpoint

The User Information Endpoint allows clients to retrieve detailed information about a user, including optional data from linked accounts (Discord, Microsoft, Google) if available.

Do not use this to sign in users. Use Validate User Authentication instead.

URL: https://api.accounda.com/v1/user/information/

Method: GET

Authorization string Bearer token for accessing the endpoint. Format: Bearer your_access_token.

Client-ID string The client identifier associated with the registered application.

auth_id integer The ID of the authorization for which user information is being requested.

google(optional), boolean If provided, additional Google data is returned if available and authorized.

microsoft(optional), boolean If provided, additional Microsoft data is returned if available and authorized.

github(optional), boolean If provided, additional GitHub data is returned if available and authorized.

discord(optional), boolean If provided, additional Discord data is returned if available and authorized.

GET /v1/user/information/?auth_id=user_related_auth_id&discord=1&microsoft=1&google=1&github=1 HTTP/1.1
Host: api.accounda.com
Authorization: Bearer your_access_token
Client-ID: your_client_id
Content-Type: application/json

Content-Type: application/json

On success, the API returns a JSON object containing user information along with any additional data from linked accounts if requested.

Status Code: 200 OK

{
    "data": {
        "username": "johndoe",
        "first_name": "John",
        "last_name": "Doe",
        "email": "john.doe@example.com",
        "google": {
          "username": "john_google",
          "first_name": "John",
          "last_name": "Doe",
          "email": "google.johndoe@example.com",
          "id": "1122334455"
        },
        "microsoft": {
          "username": "john_microsoft",
          "first_name": "John",
          "last_name": "Doe",
          "email": "microsoft.johndoe@example.com",
          "id": "0987654321"
        },
        "discord": {
          "username": "john_discord",
          "locale": "en-US",
          "email": "discord.johndoe@example.com",
          "id": "1234567890"
        },
        "github": {
          "name": "John Github",
          "email": "github.johndoe@example.com",
          "id": "3254567890"
        }
    }
}

If the request fails due to invalid credentials or other issues, the API returns an error message.

Status Code: 400 Bad Request

Missing or Invalid Headers

{
  "error": "Authorization and Client-ID headers are required"
}

Invalid Access Token

{
  "error": "Invalid access token"
}

Expired Access Token

{
  "error": "Access token has expired"
}

Invalid Client ID

{
  "error": "Invalid client ID"
}

Invalid Auth ID or Token

{
  "error": "Invalid auth ID or token"
}

Inactive or Expired Application

{
  "error": "The application associated with the provided client_id has expired.
            Please renew your access or contact support."
}

This endpoint requires client credentials (client_id) and a valid access token. All API requests should be made over HTTPS to ensure data security.

The access token is valid for a limited time and should be refreshed before it expires.
Ensure that the client_secret is kept secure and never shared publicly.
Optional linked account data (Google, Microsoft, Discord, GitHub) will only be included if requested and authorized.
Do not use this request to sign in users.

Um auf geschützte Bereiche der API zuzugreifen, benötigst du einen Access Token.

Access Token Endpoint

Aktualisiere einen abgelaufenen Zugriffstoken, um eine erneute Authentifizierung zu vermeiden.

Refresh Token Endpoint

Verifiziere die Authentifizierung eines Nutzers, um eine korrekte Anmeldung sicherzustellen.

User Validation Endpoint