API Documentation
Error Reference
The API uses standard HTTP status codes. If something goes wrong, you'll get a clear JSON error with a human-readable message.
| Code | Meaning | What to do |
|---|---|---|
| 200 | Success | You're golden ✨ |
| 400 | Bad Request | Check your parameters — something's off |
| 401 | Unauthorized | Missing or invalid API key |
| 404 | Not Found | Endpoint or resource doesn't exist |
| 429 | Rate Limited | Slow down or upgrade to Premium |
| 500 | Server Error | Our fault — retry in a few seconds |
You're golden ✨
Check your parameters — something's off
Missing or invalid API key
Endpoint or resource doesn't exist
Slow down or upgrade to Premium
Our fault — retry in a few seconds
Example error response
{ "error": "Unauthorized", "message": "Invalid or missing API key.", "status": 401 }
Getting an unexpected error? Double-check your API key, make sure you're using HTTPS, and verify the ISIN or endpoint path is correct. Still stuck? Reach out at api@eulerpool.com — we respond fast.
Frequently Asked Questions
What does a 429 error mean?
A 429 status code means you've exceeded your rate limit. Check the X-RateLimit-Reset header to see when your limit resets, or upgrade to a Premium plan for unlimited requests.
How do I fix a 401 Unauthorized error?
A 401 error means your API key is missing or invalid. Verify you're passing the key as ?token=YOUR_API_KEY in the query string, or as an Authorization: Bearer header. Make sure the key hasn't been revoked.
What should I do when I get a 500 error?
A 500 error is a server-side issue on our end. Wait a few seconds and retry your request. If the problem persists, contact us at api@eulerpool.com. Our 99.9% uptime SLA means these are rare.