Skip to main content

Support & Help Centre

Kia ora. You are building with complex scientific data—we are here to help you get it right.

Contact Us​

Connect directly with our API and Meteorology experts for integration support:

Frequently Asked Questions (FAQs)​

Authentication: How do I authorize requests?​

All MetService APIs require authentication. Most use an API Key passed in the header. For specific details on obtaining a key and implementing the auth flow, see our Authentication Guide.

Versioning: How are breaking changes handled?​

We respect your roadmap. We support legacy versions for 12 months, giving you ample time to migrate to newer, more capable standards. Significant breaking changes are communicated via a changelog.

Error Handling: What do the HTTP status codes mean?​

We follow standard HTTP status codes.

  • 200 OK: Request successful.
  • 401 Unauthorized: Invalid API Key.
  • 403 Forbidden: Account does not have access to this specific product.
  • 429 Too Many Requests: Rate limit exceeded. For more details, see Error Handling.

Rate Limits: How many requests can I make?​

Rate limits vary by product and account tier. Standard developer keys usually have a burst limit of 5 requests per second. Check your specific contract or product guide for exact limits. More info: Rate Limits.

Endpoint Reference: Where can I find the full technical specifications?​

Full technical references, including OpenAPI specifications and interactive documentation, are available in the API Catalog under each product's "Reference" section.

Data Consistency: Why doesn't the API data match the MetService website or app?​

The API provides raw meteorological model data, which allows for maximum flexibility in how you use it. The MetService website and mobile app (both iOS/Android and Desktop) display curated forecasts where our meteorologists have selected the "Model of the Day" and applied specific aggregation logic. For more details on the difference between raw and curated data, see Weather Fundamentals.

If you are specifically looking for an API that provides the exact curated data that is displayed on our website, please see the Media Forecast API in our Upcoming APIs.

Ngā mihi,
The MetService API Team