Skip to main content

Getting Started

The following guide will enable you to get data from MetService's public API, and understand how to integrate with the wider platform.

You just want to make to make test calls to the server? See the API Reference and make use of the Request panel.

API Maturity Model​

To help you choose the right integration path, we categorize our APIs into two maturity levels: Core and Classic.

For a detailed breakdown of each category and to see which APIs provide the data you need, please visit our API Catalog.

Prerequisites​

  • Basic understanding of REST APIs - Need help? ChatGPT can explain
  • Your favorite HTTP client (cURL, Postman, or your programming language of choice)
  • A MetService API key (see Authentication)

Quick Start Steps​

1. Get Your API Key​

# Example request with your API key
curl -H "apikey: YOUR_API_KEY" "https://api.metservice.com/nowcast/v1/point-nowcast/SiiNNNNNN"

Your API key should be included in the apikey header for all requests.

2. Choose Your Location​

MetService APIs use location IDs to identify forecast points. You can:

curl -H "apikey: YOUR_API_KEY" "https://api.metservice.com/locations/v1/nearby?lat=-41.2866&lon=174.7756"

3. Make Your First Request​

Here's a complete example getting weather data for Wellington:

curl -H "apikey: YOUR_API_KEY" \
     "https://api.metservice.com/nowcast/v1/point-nowcast/SiiNNNNNN"

Example Response​

{
  "location": {
    "name": "Wellington",
    "latitude": -41.2866,
    "longitude": 174.7756
  },
  "forecast": {
    "temperature": 18,
    "humidity": 65,
    "windSpeed": 20
  }
}

Next Steps​

  1. Explore API Guides

  2. Learn Best Practices

  3. Integration Resources

    • Code Examples & SDKs: We provide generated code samples in popular languages for every endpoint within the API Reference pages.
    • API Reference

Need Help?​