Errors

Base URL: https://app.lisn.dev/api

The API uses standard HTTP status codes and returns structured JSON errors.

Error Response Format

{
  "success": false,
  "error": {
    "code": "insufficient_balance",
    "message": "Your balance is too low to process this request.",
    "details": { "balance": 0.02, "estimated_cost": 0.15 }
  }
}

Error Codes

HTTP	Code	Description
`400`	`validation_error`	Invalid request body or parameters
`401`	`unauthorized`	Missing or invalid API token
`402`	`insufficient_balance`	Account balance too low
`403`	`forbidden`	No permission for this resource
`404`	`not_found`	Resource does not exist
`409`	`conflict`	Resource already exists (e.g. email)
`413`	`file_too_large`	Audio file exceeds size limit
`422`	`processing_error`	STT or LLM processing failed
`429`	`rate_limit`	Too many requests
`500`	`internal_error`	Unexpected server error

Webhooks SDK & Examples