Skip to main content
Version: 1.0.0

TagMango API

Overview​

TagMango APIs are a collection of extensive RESTful APIs made to give partners and outside developers safe access to TagMango's main platform functionalities. By integrating with TagMango's creative economy platform, external apps can access essential features like messaging, gamification, course content, and subscriptions.

Getting Started​

  1. Obtain your API key from TagMango.
  2. Include required headers in all requests, x-whitelabel-host is required for all requests.
  3. Test endpoints using your API key.

Authentication & Headers​

  • Authorization: Bearer <your-api-key>
  • x-whitelabel-host: Your whitelabel dashboard domain (e.g., yourhost.tagmango.com)
  • x-timezone-offset: Timezone offset in minutes (e.g., 330 for IST)
info

x-timezone-offset header is optional. If not provided, the server will use the default timezone of the server. It's in minutes.

Security

API key should be handled securely and not exposed to the client.

Response Format​

All API endpoints return responses in JSON format with consistent structure:

{
  "message": "Operation completed successfully",
  "success": true,
  "data": <Response data here> 
}

Error Handling​

The API uses standard HTTP status codes:

  • 400 Bad Request: Invalid request parameters
  • 401 Unauthorized: Authentication failed
  • 404 Not Found: Resource not found
  • 429 Too Many Requests: Rate limit exceeded
  • 500 Internal Server Error: Server-side error
Rate Limiting
  • API has a rate limit of 120 requests per 10 seconds.
  • If you exceed the rate limit, you will receive a 429 status code.

Authentication​

Security Scheme Type:

apiKey

Header parameter name:

x-api-key