Error Handling

Error response format

All error responses follow a consistent format:

{
  "error": "Human-readable error message",
  "code": "ERROR_CODE",
  "details": {}  // Optional additional context
}

HTTP status codes

Status	Meaning	When it occurs
`400`	Bad Request	Invalid parameters or malformed request
`401`	Unauthorized	Missing or invalid API key
`403`	Forbidden	API key doesn’t have access to this endpoint
`404`	Not Found	Endpoint doesn’t exist
`422`	Unprocessable Entity	Valid request but invalid data
`429`	Too Many Requests	Rate limit exceeded
`500`	Internal Server Error	Something went wrong on our end

Common error codes

Authentication errors

{
  "error": "Invalid API key",
  "code": "UNAUTHORIZED"
}

Solution: Check that your API key is correct and included in the X-API-Key header.

Validation errors

{
  "error": "Invalid email format",
  "code": "VALIDATION_ERROR",
  "details": {
    "field": "email",
    "value": "not-an-email"
  }
}

Solution: Check the parameter requirements in the API reference.

Rate limit errors

{
  "error": "Rate limit exceeded",
  "code": "RATE_LIMIT_EXCEEDED",
  "retry_after": 60
}

Solution: Wait for the retry_after seconds before retrying. See Rate Limits.

Error handling examples

try {
  const response = await fetch('https://api.tinyfn.io/v1/validate/email?email=test', {
    headers: { 'X-API-Key': apiKey }
  });

  if (!response.ok) {
    const error = await response.json();
    console.error(`Error ${response.status}: ${error.error}`);
    return;
  }

  const data = await response.json();
} catch (err) {
  console.error('Network error:', err);
}

import requests

try:
    response = requests.get(
        'https://api.tinyfn.io/v1/validate/email',
        params={'email': 'test'},
        headers={'X-API-Key': api_key}
    )
    response.raise_for_status()
    data = response.json()
except requests.exceptions.HTTPError as e:
    error = e.response.json()
    print(f"API Error: {error['error']}")
except requests.exceptions.RequestException as e:
    print(f"Network error: {e}")

Getting help

If you encounter persistent errors or believe there’s an issue with the API:

Check API Status

View current system status and incidents

Contact Support

Reach out if you need help

Getting Started

Guides

Error Handling

Error response format

HTTP status codes

Common error codes

Authentication errors

Validation errors

Rate limit errors

Error handling examples

Getting help

Check API Status

Contact Support

​Error response format

​HTTP status codes

​Common error codes

​Authentication errors

​Validation errors

​Rate limit errors

​Error handling examples

​Getting help

Check API Status

Contact Support

Error response format

HTTP status codes

Common error codes

Authentication errors

Validation errors

Rate limit errors

Error handling examples

Getting help