Version: 1.0.0

BriskTag API

BriskTag v2 Backend API for XBRL/iXBRL financial reporting platform.

Authentication

This API uses Bearer JWT authentication. To authenticate:

1. Call POST /api/auth/sign-in/email with your credentials
2. Use the returned JWT token in the Authorization: Bearer <token> header

Multi-Tenancy

Most endpoints are scoped to an organization (tenant). Users can only access resources within their organization unless they have SUPER_ADMIN role.

Response Format

Success Response:

{
  "success": true,
  "data": { ... }
}

Paginated Response:

{
  "success": true,
  "data": [ ... ],
  "page": 1,
  "limit": 10,
  "total": 100
}

Error Response:

{
  "status": false,
  "message": "Error description"
}

Authentication

HTTP: Bearer Auth

JWT token obtained from Better Auth. Use the /api/auth/sign-in/email endpoint to authenticate.

Security Scheme Type:	http
HTTP Authorization Scheme:	bearer
Bearer format:	JWT

API Key: CookieAuth

Session cookie set by Better Auth after authentication.

Security Scheme Type:	apiKey
Cookie parameter name:	better-auth.session_token

License