Token - Token Check

Endpoint

/o/token/check

Overview

Checks whether a token exists and is currently valid.

Authentication

Pass api_key or auth_token as a query parameter, or send countly-token as a header. See Authentication.

Permissions

• Any authenticated dashboard user.

Request Parameters

Parameter	Type	Required	Description
api_key	String	Yes (or use auth_token)	Dashboard API key.
auth_token	String	Yes (or use api_key)	Dashboard auth token.
token	String	Yes	Token value to validate.

Examples

Example 1: Check token validity

/o/token/check?api_key=YOUR_API_KEY&token=0e1c012f855e7065e779b57a616792fb5bd03834

Response

Success Response

Valid token:

{
  "result": {
    "valid": true,
    "time": 1800
  }
}

Invalid or expired token:

{
  "result": {
    "valid": false,
    "time": 0
  }
}

Response Fields

Field	Type	Description
result.valid	Boolean	Whether the token is valid now.
result.time	Number	Remaining lifetime in seconds (0 invalid/expired, -1 for no-expiry tokens).

Error Responses

Status Code: 400 Bad Request

{
  "result": "Missing parameter \"token\""
}

Status Code: 400 Bad Request

{
  "result": "Missing parameter \"api_key\" or \"auth_token\""
}

Status Code: 404 Not Found

{
  "result": "Database error message"
}

Behavior

Behavior Modes

Mode	Trigger	Processing Path	Response Shape
Valid token	Token exists and is not expired	Reads token metadata, computes remaining lifetime in seconds (-1 for non-expiring).	Wrapped { "result": { "valid": true, "time": ... } }
Invalid token	Token missing or expired	Returns invalid status with zero remaining lifetime.	Wrapped { "result": { "valid": false, "time": 0 } }

Related Endpoints

• Token Create
• Token Delete
• Token List

Implementation details

Database Collections

Collection	Used for	Data touched by this endpoint
countly.members	Auth validation	Resolves authenticated member.
countly.auth_tokens	Token check source	Reads token state and expiry fields.