Skip to main content
GET
/
api
/
integration
/
logs
curl "https://api.musique.app/api/integration/logs?page=1&limit=10&status=200" \
  -H "X-API-Key: msk_live_1234567890abcdef"
{
  "data": [
    {
      "logId": "log_abc123xyz",
      "timestamp": "2024-01-20T15:22:30Z",
      "method": "POST",
      "endpoint": "/api/aud_9x8y7z6w5v4u3t/send",
      "statusCode": 200,
      "responseTime": 245,
      "requestSize": 512,
      "responseSize": 1024,
      "ipAddress": "203.0.113.45",
      "userAgent": "Node.js/18.0.0"
    },
    {
      "logId": "log_def456uvw",
      "timestamp": "2024-01-20T15:20:15Z",
      "method": "POST",
      "endpoint": "/api/audio",
      "statusCode": 201,
      "responseTime": 1823,
      "requestSize": 2048000,
      "responseSize": 512,
      "ipAddress": "203.0.113.45",
      "userAgent": "Python-requests/2.31.0"
    }
  ],
  "pagination": {
    "page": 1,
    "limit": 10,
    "total": 247,
    "totalPages": 25
  }
}
Retrieve logs of your API requests including requests, responses, and errors.
Log Retention: Logs are retained for 30 days. Export logs regularly if you need longer retention.

Request

Headers

X-API-Key
string
required
Your API authentication token

Query Parameters

page
number
default:"1"
Page number for pagination
limit
number
default:"50"
Number of logs per page (max 200)
startDate
string
Filter logs from this date (ISO 8601)
endDate
string
Filter logs until this date (ISO 8601)
endpoint
string
Filter by specific endpoint (e.g., “/api/audio”)
status
string
Filter by HTTP status code or range (e.g., “200”, “4xx”, “5xx”)
method
string
Filter by HTTP method (GET, POST, DELETE)

Response

data
array
Array of log entries
pagination
object
Pagination metadata
curl "https://api.musique.app/api/integration/logs?page=1&limit=10&status=200" \
  -H "X-API-Key: msk_live_1234567890abcdef"
{
  "data": [
    {
      "logId": "log_abc123xyz",
      "timestamp": "2024-01-20T15:22:30Z",
      "method": "POST",
      "endpoint": "/api/aud_9x8y7z6w5v4u3t/send",
      "statusCode": 200,
      "responseTime": 245,
      "requestSize": 512,
      "responseSize": 1024,
      "ipAddress": "203.0.113.45",
      "userAgent": "Node.js/18.0.0"
    },
    {
      "logId": "log_def456uvw",
      "timestamp": "2024-01-20T15:20:15Z",
      "method": "POST",
      "endpoint": "/api/audio",
      "statusCode": 201,
      "responseTime": 1823,
      "requestSize": 2048000,
      "responseSize": 512,
      "ipAddress": "203.0.113.45",
      "userAgent": "Python-requests/2.31.0"
    }
  ],
  "pagination": {
    "page": 1,
    "limit": 10,
    "total": 247,
    "totalPages": 25
  }
}

Common Uses

  • Debugging integration issues - Find failed requests and error details
  • Auditing API usage - Track who is making requests and when
  • Monitoring performance - Identify slow endpoints
  • Compliance and security reviews - Maintain audit trail

Filtering Examples

# Get errors from today
curl "https://api.musique.app/api/integration/logs?status=4xx&startDate=2024-01-20"

# Get all POST requests
curl "https://api.musique.app/api/integration/logs?method=POST"

# Get logs for audio endpoint
curl "https://api.musique.app/api/integration/logs?endpoint=/api/audio"