Getting Started

Logify is an open-source log management platform that lets you ingest, search, and visualize your application logs in real-time. Get up and running in under 5 minutes.

curl -X POST https://api.logify.dev/api/v1/logs \
  -H "Content-Type: application/json" \
  -H "X-API-Key: your-api-key" \
  -d '{"level":"info","message":"Hello from Logify!"}'

Authentication

All API requests must be authenticated using an API key. API keys are scoped to a single project and can be created or revoked from your dashboard.

How API keys work

• Each API key is tied to a specific project. Logs sent with that key are stored in the corresponding project.
• Keys are shown only once at creation time. Store them securely in environment variables.
• You can revoke a key at any time. Revoked keys immediately stop working.
• The number of API keys you can create depends on your plan (Free: 1, Pro: 10, Enterprise: unlimited).

Using your API key

Pass your API key in the X-API-Key header with every request:

X-API-Key: logify_k_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx

Log Ingestion API

The log ingestion endpoint accepts structured log data and stores it in your project. Logs are available for search and streaming within seconds of ingestion.

curl -X POST https://api.logify.dev/api/v1/logs \
  -H "Content-Type: application/json" \
  -H "X-API-Key: your-api-key-here" \
  -d '{
    "level": "info",
    "message": "User signed in successfully",
    "service": "auth-service",
    "environment": "production",
    "meta": {
      "userId": "usr_12345",
      "method": "oauth"
    },
    "tags": ["auth", "login"]
  }'

{
  "success": true,
  "data": {
    "id": "log_abc123def456",
    "level": "info",
    "message": "User signed in successfully",
    "service": "auth-service",
    "environment": "production",
    "timestamp": "2026-02-23T10:30:00.000Z",
    "meta": {
      "userId": "usr_12345",
      "method": "oauth"
    },
    "tags": ["auth", "login"]
  }
}

{
  "success": false,
  "error": {
    "code": "VALIDATION_ERROR",
    "message": "Invalid log level. Must be one of: debug, info, warn, error, fatal",
    "details": [
      {
        "field": "level",
        "message": "Invalid enum value"
      }
    ]
  }
}

{
  "success": false,
  "error": {
    "code": "RATE_LIMIT_EXCEEDED",
    "message": "Rate limit exceeded. Try again in 45 seconds.",
    "retryAfter": 45
  }
}

Rate Limits

API rate limits protect the platform and ensure fair usage across all users. Limits are applied per API key.

Rate limit headers

Every API response includes rate limit information in the headers:

X-RateLimit-Limit: 500
X-RateLimit-Remaining: 438
X-RateLimit-Reset: 1708732800

Handling rate limits

When you hit a rate limit, the API returns a 429 Too Many Requests response. Implement exponential backoff in your client:

async function sendLogWithRetry(payload, retries = 3) {
  for (let i = 0; i < retries; i++) {
    const res = await fetch("/api/v1/logs", {
      method: "POST",
      headers: { "X-API-Key": API_KEY },
      body: JSON.stringify(payload),
    });

    if (res.status !== 429) return res.json();

    const retryAfter = res.headers.get("Retry-After") || 2 ** i;
    await new Promise(r => setTimeout(r, retryAfter * 1000));
  }
  throw new Error("Rate limit exceeded after retries");
}

SDKs

Official SDKs are coming soon to make integration even easier. In the meantime, you can use the REST API directly from any language.

npm install @logify/node

pip install logify-python

go get github.com/logify/logify-go

Dashboard

The Logify dashboard provides a real-time view of your logs with powerful search and filtering capabilities.

# Simple text search
payment failed

# Search by field
service:auth-service level:error

# Search with tags
tag:deployment environment:production

# Search by trace ID
traceId:abc-123-def-456