Every API here is available over the APIs.io API and to AI agents over MCP.
MCP server
One button, every client — Claude, Cursor, VS Code and the rest.
https://apis.io/mcp
Tools for apis
7 MCP tools reach this
find_apisBrowse and filter every API in the catalog.
get_api_artifactsOne API's artifacts, grouped by type.
get_openapiThe primary OpenAPI for this API.
find_similar_apisAPIs that look like this one.
apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.
resolveTurn a domain, URL or GitHub org into the provider it belongs to.
find_cohortsEvery scored population of providers in the catalog.
All 92 tools →
Call it yourself
curl for this page
This API
curl "https://apis.io/api/v1/apis/microsoft-azure:microsoft-azure-weather-data-api"
All apis
curl "https://apis.io/api/v1/apis?limit=25"
Discovery needs no key. Ratings and market analysis are Pro.
Get an API key
Free tier, no form to fill in. Signing in shares your email address with us — we
store it to create your key and to recognise you if you sign in with another
provider. See our Privacy Policy and
Terms.
A second provider on the same verified email joins the account you already have.
openapi: 3.2.0
info:
title: Microsoft Azure Weather Data API
version: '1.0'
description: 'Operations tagged WeatherData across 2 of this provider''s published API definitions: azure-agfoodplatform-data-plane-service-openapi-original.yml, microsoft-azure-data-manager-for-agriculture-data-plane-service-openapi-original.yml. Each path carries the servers of the definition it was published in.'
security:
- Bearer: []
tags:
- name: Weather Data
paths:
/weather-data/:fetch:
post:
tags:
- Weather Data
description: Returns a list of WeatherData.
operationId: microsoftAzureWeatherdataGet
parameters:
- in: query
name: api-version
description: The requested API version
required: true
schema:
type: string
responses:
'200':
description: Success
headers:
x-ms-cache-hit:
description: Indicate whether the request was cache hit or cache miss.
schema:
type: boolean
x-ms-response-latency-in-milliseconds:
description: Time taken in milliseconds for processing the request at server side.
schema:
type: integer
format: int32
content:
application/json:
schema:
$ref: '#/components/schemas/WeatherDataProviderResponse'
default:
description: Error
headers:
x-ms-error-code:
x-ms-client-name: ErrorCode
schema:
type: string
x-ms-error-response: true
content:
application/json:
schema:
$ref: '#/components/schemas/ErrorResponse'
x-ms-examples:
WeatherData_Get:
$ref: ./examples/WeatherData_Get.json
summary: Microsoft Azure Post Weather Data :fetch
requestBody:
content:
application/json:
schema:
$ref: '#/components/schemas/WeatherDataProviderRequest'
description: Weather data provider request.
required: true
/weather-data:fetch:
post:
tags:
- Weather Data
description: Returns a list of WeatherData.
operationId: postWeatherData:fetch
parameters:
- in: query
name: api-version
description: The requested API version
required: true
schema:
type: string
responses:
'200':
description: Success
content:
application/json:
schema:
$ref: '#/components/schemas/WeatherDataProviderResponse'
default:
description: Error
headers:
x-ms-error-code:
x-ms-client-name: ErrorCode
schema:
type: string
x-ms-error-response: true
content:
application/json:
schema:
$ref: '#/components/schemas/ErrorResponse'
x-ms-examples:
WeatherData_Get:
$ref: ./examples/WeatherData_Get.json
summary: Microsoft Azure Post Weather Data:fetch
requestBody:
content:
application/json:
schema:
$ref: '#/components/schemas/WeatherDataProviderRequest_2'
description: Weather data provider request.
required: true
x-operation-id-source: normalized
x-operation-id-original: microsoftAzureWeatherdataGet
components:
schemas:
WeatherDataProviderRequest:
description: Schema of weather data provider request.
required:
- extensionApiName
- extensionId
- providerApiKey
- units
type: object
properties:
locations:
description: List of locations for which weather data need to be fetched from the provider.
type: array
items:
$ref: '#/components/schemas/WeatherLocation'
providerAppId:
description: App id of the weather data provider.
maxLength: 200
minLength: 2
type: string
providerApiKey:
description: Api key of the weather data provider.
maxLength: 200
minLength: 2
type: string
extensionId:
description: Id of the extension to be used for the providerInput. eg. DTN.ClearAg.
minLength: 1
type: string
extensionApiName:
description: Extension api name to which request is to be made.
minLength: 1
type: string
language:
description: 'Language (IETF BCP 47 language tag) in which search results should be returned by the data provider. Examples: ''en-US'', ''es'', ''es-MX'', ''fr-FR''.'
type: string
startTimeHours:
format: int32
description: Start of time range. Hour 0 represents the current hour. (Only applicable for DTN.ClearAg extension.)
maximum: 240
minimum: 0
type: integer
endTimeHours:
format: int32
description: End of time range. Supported ranges are from 0 to 240. (Only applicable for DTN.ClearAg extension.)
maximum: 240
minimum: 0
type: integer
duration:
format: int32
description: Specifies for how many days the daily forecast responses are returned. Available values are 1, 5, 10, 25 and 45. (Only applicable for Azure Weather Maps extension.)
type: integer
units:
description: Units for which request to data provider is to be sent. Supported values are 'e' for English units, 'm' for Metric units, 'h' for Hybrid units (UK) and 's' for Metric SI units.
minLength: 1
type: string
additionalParams:
$ref: '#/components/schemas/AdditionalProviderParameters'
WeatherMetadata:
description: Schema of Weather Metadata.
required:
- extensionApiName
- extensionId
- extensionVersion
- units
- weatherDataType
type: object
properties:
extensionVersion:
description: Version of the weather data extension.
minLength: 1
type: string
weatherDataType:
description: Type of weather data (forecast/historical).
minLength: 1
type: string
extensionId:
description: Id of the extension to be used for the providerInput. eg. DTN.ClearAg.
minLength: 1
type: string
extensionApiName:
description: Extension api name to which request is to be made.
minLength: 1
type: string
language:
description: 'Language (IETF BCP 47 language tag) in which search results should be returned by the data provider. Examples: ''en-US'', ''es'', ''es-MX'', ''fr-FR''.'
type: string
startTimeHours:
format: int32
description: Start of time range. Hour 0 represents the current hour. (Only applicable for DTN.ClearAg extension.)
maximum: 240
minimum: 0
type: integer
endTimeHours:
format: int32
description: End of time range. (Only applicable for DTN.ClearAg extension.)
maximum: 240
minimum: 0
type: integer
duration:
format: int32
description: Specifies for how many days the daily forecast responses are returned. Available values are 1, 5, 10, 25 and 45. (Only applicable for Azure Weather Maps extension.)
type: integer
units:
description: Units for which request to data provider is to be sent. Supported values are 'e' for English units, 'm' for Metric units, 'h' for Hybrid units (UK) and 's' for Metric SI units.
minLength: 1
type: string
additionalParams:
$ref: '#/components/schemas/AdditionalProviderParameters'
Measures:
description: Schema for storing measurement readings and unit.
type: object
properties:
unit:
description: Data unit.
maxLength: 50
minLength: 1
type: string
values:
description: Data values.
type: array
items:
format: double
type: number
Error:
description: An error from the Azure AgPlatform service.
required:
- code
- message
type: object
properties:
code:
description: Server-defined set of error codes.
minLength: 1
type: string
message:
description: Human-readable representation of the error.
minLength: 1
type: string
target:
description: Target of the error.
type: string
details:
description: Array of details about specific errors that led to this reported error.
type: array
items:
$ref: '#/components/schemas/Error'
innererror:
$ref: '#/components/schemas/InnerError'
WeatherDataForPassthrough:
description: Schema of weather data.
type: object
properties:
wetBulbTemperature:
$ref: '#/components/schemas/Measures'
cloudCover:
$ref: '#/components/schemas/Measures'
dayOfWeek:
description: Day of week.
type: array
items:
type: string
dayOrNight:
description: This data field indicates whether it is daytime or nighttime based on the Local Apparent Time of the location.
type: array
items:
type: string
expirationTime:
description: Expiration time in Utc format.
type: array
items:
type: string
iconCode:
description: This number is the key to the weather icon lookup. The data field shows the icon number that is matched to represent the observed weather conditions.
type: array
items:
type: string
iconCodeExtend:
description: Code representing full set sensible weather.
type: array
items:
type: string
hasPrecipitation:
description: Indicates whether there is precipitation or not.
type: array
items:
type: boolean
pressureMeanSeaLevel:
$ref: '#/components/schemas/Measures'
relativeHumidity:
$ref: '#/components/schemas/Measures'
temperature:
$ref: '#/components/schemas/Measures'
temperatureDewPoint:
$ref: '#/components/schemas/Measures'
temperatureFeelsLike:
$ref: '#/components/schemas/Measures'
temperatureHeatIndex:
$ref: '#/components/schemas/Measures'
temperatureWindChill:
$ref: '#/components/schemas/Measures'
uvDescription:
description: The UV Index Description which complements the UV Index value by providing an associated level of risk of skin damage due to exposure (-2 = Not Available, -1 = No Report, 0 to 2 = Low, 3 to 5 = Moderate, 6 to 7 = High, 8 to 10 = Very High, 11 to 16 = Extreme).
type: array
items:
type: string
uvIndex:
description: Hourly maximum UV index.
type: array
items:
type: string
validTimeLocal:
description: Time forecast is valid in local apparent time.
type: array
items:
type: string
validTime:
description: Time forecast is valid in Utc format.
type: array
items:
type: string
visibility:
$ref: '#/components/schemas/Measures'
windDirection:
$ref: '#/components/schemas/Measures'
windGust:
$ref: '#/components/schemas/Measures'
windSpeed:
$ref: '#/components/schemas/Measures'
wxPhraseLong:
description: Hourly sensible weather phrase containing longer description.
type: array
items:
type: string
wxPhraseShort:
description: Hourly sensible weather phrase containing short description.
type: array
items:
type: string
additionalAttributes:
description: 'A collection of key value pairs that belongs to the resource. Each pair must not have a key greater than 50 characters and must not have a value greater than 250 characters. Note: A maximum of 100 key value pairs can be provided for a resource and only string and numeral values are supported.'
type: object
additionalProperties: {}
WeatherLocationData:
description: Schema of WeatherLocationData data.
type: object
properties:
location:
$ref: '#/components/schemas/WeatherLocation'
requestCompletionTime:
description: Request Completion Time in Utc of the location.
type: string
lastRefreshedDateTime:
format: date-time
description: 'Date-time when resource was last requested, sample format: yyyy-MM-ddTHH:mm:ssZ.'
type: string
example: 2020-12-31T11:10:21Z.
data:
$ref: '#/components/schemas/WeatherDataForPassthrough'
InnerError:
description: Inner error containing list of errors.See https://github.com/Microsoft/api-guidelines/blob/vNext/Guidelines.md#innererror--object for InnerError reference document.
type: object
properties:
code:
description: Specific error code than was provided by the containing error.
type: string
innererror:
$ref: '#/components/schemas/InnerError'
WeatherDataProviderResponse:
description: Schema of Weather Data Provider Response.
required:
- weatherMetadata
type: object
properties:
weatherMetadata:
$ref: '#/components/schemas/WeatherMetadata'
status:
description: Indicates a Succeeded, Failed, or PartiallySucceeded response.
enum:
- Succeeded
- Failed
- PartiallySucceeded
type: string
x-ms-enum:
name: Status
modelAsString: true
locations:
description: List of weather data for all the weather locations.
type: array
items:
$ref: '#/components/schemas/WeatherLocationData'
errors:
$ref: '#/components/schemas/WeatherDataErrors'
AdditionalProviderParameters:
description: Schema of additional parameters for weather data provider request.
type: object
properties:
iconResolution:
description: Icon Resolution (Only applicable for AzureWeatherMaps).
type: string
details:
description: Details (Only applicable for AzureWeatherMaps).
default: true
type: boolean
WeatherLocation:
description: Schema of Location data.
required:
- type
- value
type: object
properties:
type:
description: Location Type eg. LatLong/IataCode/IcaoCode/Placeid/PostalKey.
maxLength: 25
minLength: 2
enum:
- LatLong
- IataCode
- IcaoCode
- PlaceId
- PostalKey
type: string
x-ms-enum:
name: LocationType
modelAsString: true
value:
description: Location Value eg. "10,-25" for LocationType Type "LatLong".
minLength: 1
type: string
ErrorResponse:
description: An error response from the Azure AgPlatform service. See https://github.com/Microsoft/api-guidelines/blob/vNext/Guidelines.md#7102-error-condition-responses for ErrorResponse reference document.
type: object
properties:
error:
$ref: '#/components/schemas/Error'
traceId:
description: Unique trace Id.
type: string
ErrorForLocation:
description: Model for error information for a failed location.
type: object
properties:
location:
$ref: '#/components/schemas/WeatherLocation'
code:
format: int32
description: Status code returned by data provider.
type: integer
description:
description: Description of the error.
type: string
retryable:
description: Flag suggesting if retry attempt with same request body should be made to fetch required data.
type: boolean
WeatherDataErrors:
description: Model for errors encountered for all failed locations.
type: object
properties:
locations:
description: List of errors encountered for all failed locations.
type: array
items:
$ref: '#/components/schemas/ErrorForLocation'
WeatherDataProviderRequest_2:
description: Schema of weather data provider request.
required:
- extensionApiName
- extensionId
- units
type: object
properties:
credentials:
$ref: '#/components/schemas/ApiKeyAuthCredentials'
locations:
description: List of locations for which weather data need to be fetched from the provider.
type: array
items:
$ref: '#/components/schemas/WeatherLocation_2'
extensionId:
description: Id of the extension to be used for the providerInput. eg. DTN.ClearAg.
maxLength: 100
minLength: 2
type: string
extensionApiName:
description: Extension api name to which request is to be made.
maxLength: 100
minLength: 2
type: string
language:
description: 'Language (IETF BCP 47 language tag) in which search results should be returned by the data provider. Examples: ''en-US'', ''es'', ''es-MX'', ''fr-FR''.'
maxLength: 100
minLength: 0
type: string
startTimeHours:
format: int32
description: Start of time range. Hour 0 represents the current hour. (Only applicable for DTN.ClearAg extension.)
maximum: 240
minimum: 0
type: integer
endTimeHours:
format: int32
description: End of time range. (Only applicable for DTN.ClearAg extension.)
maximum: 240
minimum: 0
type: integer
duration:
format: int32
description: Specifies for how many days the daily forecast responses are returned. Available values are 1, 5, 10, 25 and 45. (Only applicable for Azure Weather Maps extension.)
type: integer
units:
description: Units for which request to data provider is to be sent. Supported values are 'e' for English units, 'm' for Metric units, 'h' for Hybrid units (UK) and 's' for Metric SI units.
minLength: 1
type: string
additionalParams:
$ref: '#/components/schemas/AdditionalProviderParameters_2'
WeatherMetadata_2:
description: Schema of Weather Metadata.
required:
- extensionApiName
- extensionId
- extensionVersion
- units
- weatherDataType
type: object
properties:
extensionVersion:
description: Version of the weather data extension.
minLength: 1
type: string
weatherDataType:
description: Type of weather data (forecast/historical).
minLength: 1
type: string
extensionId:
description: Id of the extension to be used for the providerInput. eg. DTN.ClearAg.
maxLength: 100
minLength: 2
type: string
extensionApiName:
description: Extension api name to which request is to be made.
maxLength: 100
minLength: 2
type: string
language:
description: 'Language (IETF BCP 47 language tag) in which search results should be returned by the data provider. Examples: ''en-US'', ''es'', ''es-MX'', ''fr-FR''.'
maxLength: 100
minLength: 0
type: string
startTimeHours:
format: int32
description: Start of time range. Hour 0 represents the current hour. (Only applicable for DTN.ClearAg extension.)
maximum: 240
minimum: 0
type: integer
endTimeHours:
format: int32
description: End of time range. (Only applicable for DTN.ClearAg extension.)
maximum: 240
minimum: 0
type: integer
duration:
format: int32
description: Specifies for how many days the daily forecast responses are returned. Available values are 1, 5, 10, 25 and 45. (Only applicable for Azure Weather Maps extension.)
type: integer
units:
description: Units for which request to data provider is to be sent. Supported values are 'e' for English units, 'm' for Metric units, 'h' for Hybrid units (UK) and 's' for Metric SI units.
minLength: 1
type: string
additionalParams:
$ref: '#/components/schemas/AdditionalProviderParameters_2'
ApiKeyAuthCredentials:
description: Api Key Auth Credentials class for API Key based Auth.
type: object
allOf:
- $ref: '#/components/schemas/AuthCredentials'
- required:
- apiKey
type: object
properties:
apiKey:
$ref: '#/components/schemas/KeyVaultProperties'
x-ms-discriminator-value: ApiKeyAuthCredentials
Measures_2:
description: Schema for storing measurement readings and unit.
type: object
properties:
unit:
description: Data unit.
maxLength: 50
minLength: 1
type: string
value:
description: Data values.
type: array
items:
format: double
type: number
AuthCredentials:
description: AuthCredentials abstract base class for Auth Purpose.
required:
- kind
type: object
properties:
kind:
$ref: '#/components/schemas/AuthCredentialsKind'
discriminator:
propertyName: kind
WeatherDataForPassthrough_2:
description: Schema of weather data.
type: object
properties:
additionalAttributes:
description: 'A collection of key value pairs that belongs to the resource. Each pair must not have a key greater than 50 characters and must not have a value greater than 250 characters. Note: A maximum of 100 key value pairs can be provided for a resource and only string and numeral values are supported.'
type: object
additionalProperties: {}
wetBulbTemperature:
$ref: '#/components/schemas/Measures_2'
cloudCover:
$ref: '#/components/schemas/Measures_2'
dayOfWeek:
description: Day of week.
type: array
items:
type: string
dayOrNight:
description: This data field indicates whether it is daytime or nighttime based on the Local Apparent Time of the location.
type: array
items:
type: string
expirationTime:
description: Expiration time in Utc format.
type: array
items:
type: string
iconCode:
description: This number is the key to the weather icon lookup. The data field shows the icon number that is matched to represent the observed weather conditions.
type: array
items:
format: int32
type: integer
iconCodeExtend:
description: Code representing full set sensible weather.
type: array
items:
format: int32
type: integer
hasPrecipitation:
description: Indicates whether there is precipitation or not.
type: array
items:
type: boolean
pressureMeanSeaLevel:
$ref: '#/components/schemas/Measures_2'
relativeHumidity:
$ref: '#/components/schemas/Measures_2'
temperature:
$ref: '#/components/schemas/Measures_2'
temperatureDewPoint:
$ref: '#/components/schemas/Measures_2'
temperatureFeelsLike:
$ref: '#/components/schemas/Measures_2'
temperatureHeatIndex:
$ref: '#/components/schemas/Measures_2'
temperatureWindChill:
$ref: '#/components/schemas/Measures_2'
uvDescription:
description: The UV Index Description which complements the UV Index value by providing an associated level of risk of skin damage due to exposure (-2 = Not Available, -1 = No Report, 0 to 2 = Low, 3 to 5 = Moderate, 6 to 7 = High, 8 to 10 = Very High, 11 to 16 = Extreme).
type: array
items:
type: string
uvIndex:
description: Hourly maximum UV index.
type: array
items:
format: double
type: number
validTimeLocal:
description: Time forecast is valid in local apparent time.
type: array
items:
type: string
validTime:
description: Time forecast is valid in Utc format.
type: array
items:
type: string
visibility:
$ref: '#/components/schemas/Measures_2'
windDirection:
$ref: '#/components/schemas/Measures_2'
windGust:
$ref: '#/components/schemas/Measures_2'
windSpeed:
$ref: '#/components/schemas/Measures_2'
wxPhraseLong:
description: Hourly sensible weather phrase containing longer description.
type: array
items:
type: string
wxPhraseShort:
description: Hourly sensible weather phrase containing short description.
type: array
items:
type: string
WeatherLocationData_2:
description: Schema of WeatherLocationData data.
type: object
properties:
location:
$ref: '#/components/schemas/WeatherLocation_2'
requestCompletionTime:
description: Request Completion Time in Utc of the location.
type: string
lastRefreshedDateTime:
format: date-time
description: 'Date-time when resource was last requested, sample format: yyyy-MM-ddTHH:mm:ssZ.'
type: string
example: '2020-12-31T11:10:21Z'
data:
$ref: '#/components/schemas/WeatherDataForPassthrough_2'
AuthCredentialsKind:
description: Enum for different types of AuthCredentials supported.
enum:
- OAuthClientCredentials
- ApiKeyAuthCredentials
type: string
x-ms-enum:
name: AuthCredentialsKind
modelAsString: true
AdditionalProviderParameters_2:
description: Schema of additional parameters for weather data provider request.
type: object
properties:
iconResolution:
description: Icon Resolution (Only applicable for AzureWeatherMaps).
maxLength: 100
minLength: 2
type: string
details:
description: Details (Only applicable for AzureWeatherMaps).
default: true
type: boolean
WeatherLocation_2:
description: Schema of Location data.
required:
- type
- value
type: object
properties:
type:
description: Location Type eg. LatLong/IataCode/IcaoCode/Placeid/PostalKey.
maxLength: 25
minLength: 2
enum:
- LatLong
- IataCode
- IcaoCode
- PlaceId
- PostalKey
type: string
x-ms-enum:
name: LocationType
modelAsString: true
value:
description: Location Value eg. "10,-25" for LocationType Type "LatLong".
maxLength: 100
minLength: 2
type: string
KeyVaultProperties:
description: Properties of the key vault.
required:
- keyName
- keyVaultUri
- keyVersion
type: object
properties:
keyVaultUri:
description: Uri of the key vault.
maxLength: 100
minLength: 2
type: string
keyName:
description: Name of Key Vault key.
maxLength: 256
minLength: 2
type: string
keyVersion:
description: Version of Key Vault key.
maxLength: 256
minLength: 2
type: string
securitySchemes:
Bearer:
type: apiKey
name: Authorization
in: header
description: Please provide a valid bearer token for authorized API calls. Note that you might need to clear your browser cache if you tried un-authenticated calls before.
x-refined-from:
- azure-agfoodplatform-data-plane-service-openapi-original.yml
- microsoft-azure-data-manager-for-agriculture-data-plane-service-openapi-original.yml
x-ms-parameterized-host:
hostTemplate: '{endpoint}'
useSchemePrefix: false
parameters:
- $ref: '#/components/parameters/Endpoint'