Error Handling
The API returns standard HTTP status codes. On error, the response body includes a detail field with a human-readable message.
401Missing or invalid API key
The X-API-KEY header is missing, empty, or does not match a valid user.
400Invalid parameters
Invalid sign (must be a valid zodiac sign), unsupported language for your tier, invalid period, or invalid date format (use YYYY-MM-DD).
403Tier restriction
The requested date or period is not available for your subscription tier. Upgrade to access historical data or additional periods.
429Rate limit exceeded
You have exceeded your request limit for the current period. The response includes a detail message such as: 'Request limit exceeded (500 for free tier this period). Upgrade for more.'