API Access Key & Authentication

API Authentication

The first step to using the API is to authenticate with your weatherstack account's unique API access key, which can be found in your account dashboard after registration. To authenticate with the API, simply use the base URL below and pass your API access key to the API's access_key parameter.

Example API Request:

Sign Up to Run API Request

Keep it safe: Please ensure that you keep your API access key private and do not expose it in any publicly available part of your application. If you ever need to reset your key, simply visit your account dashboard to do so.

256-bit HTTPS Encryption

Users can connect to the weatherstack using industry-standard SSL (HTTPS) by attaching an s to the HTTP protocol as shown in the example API request below.

Example API Request:                                                                     Available on: All Plans

API Error Codes

Whenever an API request fails, the weatherstack API will return an error object in lightweight JSON format. Each error object contains an error code, an error type, and an info object containing details about the error that occurred. Below you will find an example error as well as a list of common API errors.

Example API Error:

Common API Errors: