DTN API Endpoints API

openapi: 3.2.0
info:
  title: DTN Observation API Endpoints API
  description: '# Introduction


    Welcome to the DTN Observations API - your gateway to access live and historical measured weather station data for over 70,000 devices globally from public and private station networks. DTN’s fast, robust, and scalable Observations API has been designed to cater to a wide range of users, including:


    - Scientists engaged in climate research

    - Energy company analysts

    - Insurance analysts and loss-adjusters

    - Software developers building weather apps


    **Key features**: DTN Observations API, gives access to both real-time and historical data in one endpoint for an ever growing list of atmospheric, road, agricultural and marine parameters. Data is quality controlled and available in metric or imperial units and gap-filling with model data is also possible. Our stations endpoint helps you to identify relevant weather stations and their meta-data. Up to 30 days of data can be requested per query, with archived data available from 1901 to 1 minute ago. Like other DTN API’s, your response comes in a neatly packaged format which is easily parsable using any GeoJSON parser. The interactive documentation that follows is a guide to setting up requests, understanding responses, and leveraging all the features of DTN’s Observations API. ## Prerequisites


    To start using the DTN Observations API, you don''t need to be a programming wiz. If you''re comfortable with the basics of RESTful APIs - things like GET and POST requests - you''re good to go. Don''t sweat the details; our easy-to-follow and interactive docs, Postman collection, and user-friendly API design will have you pulling weather observations in no time. ## API Credentials


    To start making requests, you will first need your API credentials that includes your client ID and client secret. If you do not have your API credentials, please contact your account manager or the DTN sales team at apisupport@dtn.com. Remember not to share your API credentials publicly or use others'' API keys, as this may compromise the security of your data. After you have obtained your API credentials, head over to the authentication section of this documentation to learn how to get your access token. ## Account Scopes


    Account scopes define the features your account can access and the extent to which you can access them. **a) Core Scope**


    The Core Scope is designed for basic usage, offering access to fundamental features:


    * **Limited Access:** Only `Core` parameters are available in the Observations endpoint. You can find the full list of these parameters in the Parameters endpoint. * **Time Restrictions:** You can only access observation data from the past 32 days. * **Observation Limitations:** Access is restricted to public observations. **b) Plus Scope**


    The Plus Scope is the most advanced scope, offering more features and fewer limitations compared to the Core Scope. * **Full Access:** Accounts with this scope can access all `Core` parameters as well as additional parameters not included in the Core Scope. * **Latest and Archive Access:** Observation data is available from both the latest updates and archived records dating back to 1901. * **Observation Access:** Public observations and those from DTN EU are fully accessible. For details about the features and limitations of these scopes, refer to the descriptions provided for each endpoint. > **Note:** `Core Scope` applies to new customers by default, existing customers are entitled to the `Plus Scope`. For new customers, please contact apisupport@dtn.com to enable access to the `Plus Scope`.'
  version: 2.0.0
servers:
- url: https://obs.api.dtn.com
tags:


# --- truncated at 32 KB (119 KB total) ---
# Full source: https://artifacts.apis.io/dtn/openapi/dtn-api-endpoints-api-openapi.yml