API Reference

Kendo API is built around REST. Our API has predictable, resource-oriented URLs, and uses HTTP response codes to indicate API errors. We use built-in HTTP features, like HTTP verbs, which are understood by off-the-shelf HTTP clients. We support cross-origin resource sharing, allowing you to interact securely with our API from a client-side web application (though you should never expose your secret API key in any public website's client-side code). JSON is returned by all API responses, including errors.

The requests in the right sidebar are designed to work as is. The sample requests are performed using your API key which can be retrieved from your account settings on the web dashboard : xyxyxyxyxyxyxyxyxyxyx. This API key is unique and linked to your account under the email address xxxx@email.com. Only you can see these account-specific values.

API Main URL

All of our API endpoints are HTTPS secured. HTTP requests are rejected.

https://kendoemailapp.com/

Authentication

In order to reach our API endpoints, you need to authenticate using your API key xyxyxyxyxyxyxyxyxyxyx which you must include in your HTTP query url.

Your API key serves for authentication and identification, you should keep it secret.

Simple HTTP request with API key

curl "https://kendoemailapp.com/findmail?key=xyxyxyxyxyxyxyxyxyxyx" -H "Content-Type:application/json"

If you are logged in, your API key is included in all the examples on this page, so you can test any example right away. Only you can see this value.

Status Codes

Kendo uses conventional HTTP response codes to indicate the success or failure of an API request. In general, codes in the 2xx range indicate success, codes in the4xx range indicate an error that failed given the information provided, and codes in the 5xx range indicate an error with Kendo's servers.

HTTP status code summary

200 - OKEverything worked as expected.
400 - Bad RequestThe request was unacceptable, often due to missing a required parameter.
401 - UnauthorizedNo valid API key provided.
402 - Request FailedThe parameters were valid but the request failed.
404 - Not FoundThe requested resource doesn't exist.
50x - Server Errors