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.

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

Need Help?​