Weather Intelligence API

liveOpenAPI 3.1Draft v1

Sample data used to demonstrate EndpointOS API product workflows. A read-only weather-intelligence API: current observations and supported locations, packaged behind keys, docs, and usage limits.

Maintained by endpointos-demoUpdated May 28, 20262 resources100,000 requests/month

openapi.json TypeScript SDK

Introduction

A live REST API reference generated from Weather Intelligence API.

This documentation is generated from the project schema in EndpointOS. It shows the public method surface, authentication model, request schemas, response contracts, errors, pagination, usage limits, and OpenAPI export.

Quickstart

Make the first request

Use a project API key with the base URL and one of the generated resource paths. EndpointOS never displays private API keys in public documentation.

Issue a read or write key from the project dashboard.
Send it in Authorization: Bearer sapi_live_xxxxxxxx or x-api-key.
Call one of the generated endpoints below.
Inspect the request log and monthly usage in EndpointOS.

Run it/locations

curl "https://endpointos.dev/api/public/endpointos-demo/weather-intelligence/locations?limit=20&offset=0" \
  -H "Authorization: Bearer sapi_live_xxxxxxxx"

Response contractJSON envelope

{
  "data": [],
  "pagination": {
    "limit": 20,
    "offset": 0,
    "total": 0
  }
}

Authentication

API keys on every request

Every public request requires an EndpointOS API key. Key permissions are checked first, then each resource access mode decides which generated methods are exposed.

Header	Value	Use when
`Authorization`	`Bearer sapi_live_xxxxxxxx`	Recommended for server-to-server calls.
`x-api-key`	`sapi_test_xxxxxxxx`	Useful for curl examples and simple clients.

HeadersEither format works

Authorization: Bearer sapi_live_xxxxxxxx

x-api-key: sapi_test_xxxxxxxx

Base URL

Project-level API namespace

All endpoints below are relative to this base URL. The username and project slug are part of the namespace so different builders can publish APIs with the same project name without collisions.

https://endpointos.dev/api/public/endpointos-demo/weather-intelligence

Resource behavior

Access modes and data sources

Each resource controls its public method surface. API key permissions still apply, but a resource can intentionally expose fewer methods for dataset, lookup, or intake APIs.

Read/write

GET, POST, PATCH, DELETEManaged APIs that need the full record lifecycle.

Read-only

GETPublic datasets, reporting feeds, lookup APIs, and partner data products.

Write-only

POSTLead capture, form submissions, events, and private intake APIs.

Resource

locations

/locations

Supported locations for the weather feed.

locationsEndpointOS managedRead-only2 endpoints

Field	Type	Required	Unique	Default	Enum values	Notes
`city`	`string`	Yes	No	None	None	Required on create. String value
`country`	`string`	Yes	No	None	None	Required on create. String value
`latitude`	`number`	No	No	None	None	Finite numeric value
`longitude`	`number`	No	No	None	None	Finite numeric value
`timezone`	`string`	No	No	None	None	String value
`region`	`enum`	No	No	None	americas, emea, apac	Must match one enum value

citystring

Required: Yes
Unique: No
Default: None
Enum: None
Notes: Required on create. String value

countrystring

Required: Yes
Unique: No
Default: None
Enum: None
Notes: Required on create. String value

latitudenumber

Required: No
Unique: No
Default: None
Enum: None
Notes: Finite numeric value

longitudenumber

Required: No
Unique: No
Default: None
Enum: None
Notes: Finite numeric value

timezonestring

Required: No
Unique: No
Default: None
Enum: None
Notes: String value

regionenum

Required: No
Unique: No
Default: None
Enum: americas, emea, apac
Notes: Must match one enum value

Every record response also includes the server-managed id, createdAt, and updatedAt fields shown in the response example below.

GET/locations

List locations

Returns non-deleted records with pagination, filters, search, and sorting.

API key requiredRead-only or read-writeLogs every request

Request body

This endpoint does not accept a request body.

Possible responses

`200`OK	success	Request succeeded and returned a JSON response.
`400`Validation error	client	A filter, sort, or search parameter is malformed or unsupported by this resource's data source.
`401`Unauthorized	client	Missing or invalid API key.
`429`Rate limited	client	The project reached its monthly request limit.

RequestGET /locations

curl "https://endpointos.dev/api/public/endpointos-demo/weather-intelligence/locations" \
  -H "Authorization: Bearer sapi_live_xxxxxxxx"

Response example200 OK

{
  "data": [
    {
      "id": "rec_abc123",
      "city": "San Francisco",
      "country": "United States",
      "latitude": 47.3769,
      "longitude": 8.5417,
      "timezone": "Example",
      "region": "americas",
      "createdAt": "2026-05-11T10:30:00.000Z",
      "updatedAt": "2026-05-11T10:30:00.000Z"
    }
  ],
  "pagination": {
    "limit": 20,
    "offset": 0,
    "total": 1
  }
}

Error exampleConsistent error object

{
  "error": {
    "code": "UNAUTHORIZED",
    "message": "A valid EndpointOS API key is required.",
    "details": {}
  }
}

GET/locations/{id}

Retrieve a location

Returns one non-deleted record by id.

API key requiredRead-only or read-writeLogs every request

Request body

This endpoint does not accept a request body.

Possible responses

`200`OK	success	Request succeeded and returned a JSON response.
`401`Unauthorized	client	Missing or invalid API key.
`404`Not found	client	The record id does not exist or was soft-deleted.
`429`Rate limited	client	The project reached its monthly request limit.

RequestGET /locations/{id}

curl "https://endpointos.dev/api/public/endpointos-demo/weather-intelligence/locations/rec_abc123" \
  -H "Authorization: Bearer sapi_live_xxxxxxxx"

Response example200 OK

{
  "data": {
    "id": "rec_abc123",
    "city": "Berlin",
    "country": "Germany",
    "latitude": 47.3769,
    "longitude": 8.5417,
    "timezone": "Example",
    "region": "americas",
    "createdAt": "2026-05-11T10:30:00.000Z",
    "updatedAt": "2026-05-11T10:42:00.000Z"
  }
}

Error exampleConsistent error object

{
  "error": {
    "code": "RECORD_NOT_FOUND",
    "message": "Record not found.",
    "details": {
      "id": "rec_abc123"
    }
  }
}

Resource

current-weather

/current-weather

Latest weather observation per supported location.

current-weatherEndpointOS managedRead-only2 endpoints

Field	Type	Required	Unique	Default	Enum values	Notes
`locationId`	`string`	Yes	No	None	None	Required on create. String value
`city`	`string`	Yes	No	None	None	Required on create. String value
`country`	`string`	Yes	No	None	None	Required on create. String value
`temperatureC`	`number`	Yes	No	None	None	Required on create. Finite numeric value
`humidity`	`number`	No	No	None	None	Finite numeric value
`windSpeedKph`	`number`	No	No	None	None	Finite numeric value
`condition`	`enum`	No	No	None	clear, partly_cloudy, cloudy, rain, snow, fog, thunderstorm	Must match one enum value
`observedAt`	`string`	No	No	None	None	String value

locationIdstring

Required: Yes
Unique: No
Default: None
Enum: None
Notes: Required on create. String value

citystring

Required: Yes
Unique: No
Default: None
Enum: None
Notes: Required on create. String value

countrystring

Required: Yes
Unique: No
Default: None
Enum: None
Notes: Required on create. String value

temperatureCnumber

Required: Yes
Unique: No
Default: None
Enum: None
Notes: Required on create. Finite numeric value

humiditynumber

Required: No
Unique: No
Default: None
Enum: None
Notes: Finite numeric value

windSpeedKphnumber

Required: No
Unique: No
Default: None
Enum: None
Notes: Finite numeric value

conditionenum

Required: No
Unique: No
Default: None
Enum: clear, partly_cloudy, cloudy, rain, snow, fog, thunderstorm
Notes: Must match one enum value

observedAtstring

Required: No
Unique: No
Default: None
Enum: None
Notes: String value

Every record response also includes the server-managed id, createdAt, and updatedAt fields shown in the response example below.

GET/current-weather

List current-weather

Returns non-deleted records with pagination, filters, search, and sorting.

API key requiredRead-only or read-writeLogs every request

Request body

This endpoint does not accept a request body.

Possible responses

`200`OK	success	Request succeeded and returned a JSON response.
`400`Validation error	client	A filter, sort, or search parameter is malformed or unsupported by this resource's data source.
`401`Unauthorized	client	Missing or invalid API key.
`429`Rate limited	client	The project reached its monthly request limit.

RequestGET /current-weather

curl "https://endpointos.dev/api/public/endpointos-demo/weather-intelligence/current-weather" \
  -H "Authorization: Bearer sapi_live_xxxxxxxx"

Response example200 OK

{
  "data": [
    {
      "id": "rec_abc123",
      "locationId": "rec_abc123",
      "city": "San Francisco",
      "country": "United States",
      "temperatureC": 21,
      "humidity": 64,
      "windSpeedKph": 12,
      "condition": "clear",
      "observedAt": "Example",
      "createdAt": "2026-05-11T10:30:00.000Z",
      "updatedAt": "2026-05-11T10:30:00.000Z"
    }
  ],
  "pagination": {
    "limit": 20,
    "offset": 0,
    "total": 1
  }
}

Error exampleConsistent error object

{
  "error": {
    "code": "UNAUTHORIZED",
    "message": "A valid EndpointOS API key is required.",
    "details": {}
  }
}

GET/current-weather/{id}

Retrieve a current-weather

Returns one non-deleted record by id.

API key requiredRead-only or read-writeLogs every request

Request body

This endpoint does not accept a request body.

Possible responses

`200`OK	success	Request succeeded and returned a JSON response.
`401`Unauthorized	client	Missing or invalid API key.
`404`Not found	client	The record id does not exist or was soft-deleted.
`429`Rate limited	client	The project reached its monthly request limit.

RequestGET /current-weather/{id}

curl "https://endpointos.dev/api/public/endpointos-demo/weather-intelligence/current-weather/rec_abc123" \
  -H "Authorization: Bearer sapi_live_xxxxxxxx"

Response example200 OK

{
  "data": {
    "id": "rec_abc123",
    "locationId": "rec_def456",
    "city": "Berlin",
    "country": "United States",
    "temperatureC": 21,
    "humidity": 64,
    "windSpeedKph": 12,
    "condition": "clear",
    "observedAt": "Example",
    "createdAt": "2026-05-11T10:30:00.000Z",
    "updatedAt": "2026-05-11T10:42:00.000Z"
  }
}

Error exampleConsistent error object

{
  "error": {
    "code": "RECORD_NOT_FOUND",
    "message": "Record not found.",
    "details": {
      "id": "rec_abc123"
    }
  }
}

Conventions

Pagination

List endpoints support limit and offset. The default limit is 20 and the maximum limit is 100.

Query parameters

`limit`number	optional	Page size. Defaults to 20 and caps at 100.
`offset`number	optional	Zero-based offset for the first returned record.

List responsePaginated

{
  "data": [
    {
      "id": "rec_abc123",
      "title": "Dark mode",
      "createdAt": "2026-05-11T10:30:00.000Z",
      "updatedAt": "2026-05-11T10:30:00.000Z"
    }
  ],
  "pagination": {
    "limit": 20,
    "offset": 0,
    "total": 1
  }
}

Conventions

Filtering

What a collection endpoint accepts depends on where its data lives. The table below is generated from what each resource\u2019s data source actually implements, so a control listed here is one the API will honour, and a control missing from it returns 400 UNSUPPORTED_QUERY rather than quietly ignoring you.

`/locations` (EndpointOS managed)

Query controls

`field=value`string	optional	Equality filter. Any defined field.
`field[ne]`string	optional	Exclude records matching this value.
`field[in]`string	optional	Comma-separated list of values.
`field[gt]`string	optional	Greater than. Number, date and datetime fields.
`field[gte]`string	optional	Greater than or equal.
`field[lt]`string	optional	Less than.
`field[lte]`string	optional	Less than or equal.
`q`string	optional	Search string and enum fields.
`sort`string	optional	Sort by a field, createdAt, or updatedAt.
`limit`integer	optional	Page size, up to 100.
`offset`integer	optional	Records to skip.

`/current-weather` (EndpointOS managed)

Query controls

`field=value`string	optional	Equality filter. Any defined field.
`field[ne]`string	optional	Exclude records matching this value.
`field[in]`string	optional	Comma-separated list of values.
`field[gt]`string	optional	Greater than. Number, date and datetime fields.
`field[gte]`string	optional	Greater than or equal.
`field[lt]`string	optional	Less than.
`field[lte]`string	optional	Less than or equal.
`q`string	optional	Search string and enum fields.
`sort`string	optional	Sort by a field, createdAt, or updatedAt.
`limit`integer	optional	Page size, up to 100.
`offset`integer	optional	Records to skip.

Filtered requestGET

GET /locations?city[in]=value1,value2&latitude[gte]=10&limit=20

Conventions

Errors

EndpointOS returns stable error codes so clients can handle validation, auth, missing records, and usage limits without parsing prose.

Code	Status	Meaning
`UNAUTHORIZED`	401	Missing, malformed, or invalid API key.
`FORBIDDEN`	403	The API key cannot perform this operation.
`PROJECT_NOT_FOUND`	404	The project slug does not resolve to an API.
`API_VERSION_NOT_FOUND`	404	The requested API version does not exist.
`API_CONTRACT_NOT_PUBLISHED`	404	The API contract for this version has not been published.
`BREAKING_CHANGE_REQUIRES_VERSION`	400	The change is breaking and requires publishing a new API version.
`RESOURCE_NOT_FOUND`	404	The resource slug does not exist in the project.
`RECORD_NOT_FOUND`	404	The record id does not exist or was deleted.
`PROJECT_ARCHIVED`	503	The project is currently archived by its owner.
`PROJECT_PAUSED`	503	The project is paused because the workspace plan no longer covers it.
`VALIDATION_ERROR`	400	The request body failed schema validation.
`PAYLOAD_TOO_LARGE`	413	The request body is larger than the size limit. Send fewer or smaller fields, or split the write across several requests.
`RATE_LIMITED`	429	The project has reached its monthly request limit.
`STORAGE_LIMIT_REACHED`	413	The project or workspace storage limit has been reached.
`QUERY_TOO_BROAD`	413	The filtered or searched result set is too large for ad-hoc filtering.
`UNSUPPORTED_QUERY`	400	This resource's data source cannot honour part of the query (a filter operator, a filter field, sort, or search). The error details name what it does support.
`WRITE_NOT_SUPPORTED`	405	This resource's data source does not implement this write. Read-only sources such as BigQuery accept GET only. The Allow header lists the methods that do work, and the error details name the writes the source does support.
`INTERNAL_ERROR`	500	EndpointOS could not complete the request.

{
  "error": {
    "code": "VALIDATION_ERROR",
    "message": "Field 'title' is required.",
    "details": {
      "field": "title"
    }
  }
}

Conventions

Rate limits

EndpointOS counts public API requests per project each month. When the project reaches its limit, the API returns 429 RATE_LIMITED.

Limit response429 RATE_LIMITED

{
  "error": {
    "code": "RATE_LIMITED",
    "message": "Monthly request limit exceeded.",
    "details": {
      "limit": 100000,
      "resetAt": "2026-06-01T00:00:00.000Z"
    }
  }
}

Validation policy

Unknown fields are rejected

EndpointOS rejects fields that are not defined on the resource schema. This keeps generated APIs predictable and prevents accidental writes to undeclared data.

Developer portal

Request API access

Want to call this API? Send the owner an access request. If approved, they'll issue you an API key and a private link to see your usage.

Request API access

Weather Intelligence API

A live REST API reference generated from Weather Intelligence API.

Make the first request

API keys on every request

Project-level API namespace

Access modes and data sources

locations

List locations

Request body

Retrieve a location

Request body

current-weather

List current-weather

Request body

Retrieve a current-weather

Request body

Pagination

Filtering

/locations (EndpointOS managed)

/current-weather (EndpointOS managed)

Errors

Rate limits

Unknown fields are rejected

Request API access

`/locations` (EndpointOS managed)

`/current-weather` (EndpointOS managed)