Need help with your APIs? I offer API discovery, governance & evangelism services. Explore services →
API Evangelist API Evangelist
Discovery
Learnings
Guidance
Toolbox
Alignment
API Evangelist LLC

The Climate Corporation Layers API

General data retrieval endpoints.

The Climate Corporation Layers API is one of 8 APIs that The Climate Corporation publishes on the APIs.io network, described by a machine-readable OpenAPI specification.

Tagged areas include Layers. The published artifact set on APIs.io includes an OpenAPI specification, an API reference, and API documentation.

This API exposes 13 operations across 13 paths, and defines 23 schemas. It is described by OpenAPI 3.0.0, at version 4.0.11.

Requests are made against a single base URL, https://platform.climate.com/.

13 operations 13 paths 23 schemas 13 GET

Metadata

The identity and technical contract details declared by the specification.

Specification
OpenAPI 3.0.0
API Version
4.0.11
Base URL
https://platform.climate.com
Authentication
OAuth 2.0, API Key
Resource Areas
1

Authentication & Security 2

The Climate Corporation Layers API declares 2 security schemes for authenticating requests. It supports OAuth 2.0 (oauth2_authorization_code) using the authorizationCode flow, exposing 21 scopes. An API key is passed in the header as X-Api-Key (api_key).

  • oauth2_authorization_code — Log in with FieldView OAuth2 provider (Authorization Code Grant). Used to authorize the client (partner) and user. The accesstoken is required to be provided i…
  • api_key — API access key used to control throttling (429 responses). This key is typically formatted: partner-{name}-{uuid}

Paths & Operations 13

Across 13 paths, the API surfaces 13 operations — 13 GET. Each is listed below with its method, path, parameters, and response codes.

Layers 13

General data retrieval endpoints.

GET
/v4/layers/scoutingObservations
Retrieve a list of scouting observations
4 params → 200206304400
GET
/v4/layers/scoutingObservations/{scoutingObservationId}
Retrieve individual scouting observation
1 param → 200400403404
GET
/v4/layers/scoutingObservations/{scoutingObservationId}/attachments
Retrieve attachments associated with a given scouting observation.
3 params → 200206304400403404
GET
/v4/layers/scoutingObservations/{scoutingObservationId}/attachments/{attachmentId}/contents
Retrieve the binary contents of a scouting observation’s attachment.
4 params → 200206400401403404416500
GET
/v4/layers/asPlanted
Retrieve a list of planting activities
7 params → 200206304400
GET
/v4/layers/asPlanted/{activityId}/contents
Retrieve the raw planting activity
3 params → 200206304400401403404416
GET
/v4/layers/asPlanted/{activityId}
Retrieve the summary of an activity as planted agronomic data
2 params → 200400401403404500503
GET
/v4/layers/asApplied
Retrieve a list of application activities
7 params → 200206304400
GET
/v4/layers/asApplied/{activityId}/contents
Retrieve the raw application activity
3 params → 200206304400401403404416
GET
/v4/layers/asApplied/{activityId}
Retrieve the summary of an activity as applied agronomic data
2 params → 200400401403404500503
GET
/v4/layers/asHarvested
Retrieve a list of harvest activities
7 params → 200206304400
GET
/v4/layers/asHarvested/{activityId}/contents
Retrieve the raw harvest activity
3 params → 200206304400401403404416
GET
/v4/layers/asHarvested/{activityId}
Retrieve the summary of an activity as harvested agronomic data
2 params → 200400401403404500503

Schemas 23

The contract defines 23 schemas that model the data the API accepts and returns. The most detailed are PlantingActivitySummaryResponse (31 properties), HarvestActivitySummaryResponse (23 properties), ApplicationActivitySummaryResponse (20 properties), ScoutingObservation (12 properties). Each schema is shown below with its type and property counts.

ApplicationActivitySummary
object
7 properties 7 required
HarvestActivities
object
A batch of harvest activities
1 property 1 required
ScoutingObservationSummary
object
4 properties 4 required
ScoutingObservationAttachment
object
5 properties 5 required
BinaryData
string
Binary contents
HarvestActivitySummary
object
7 properties 7 required
PlantingActivities
object
A batch of planting activities
1 property 1 required
HarvestActivitySummaryResponse
object
23 properties 18 required
ScoutingTag
object
1 property 1 required
ScoutingObservation
object
12 properties 12 required
HarvestActivityContents
object
1 property 1 required
ApplicationActivitySummaryResponse
object
20 properties 17 required
ScoutingObservationAttachmentContents
object
1 property 1 required
Empty
object
ScoutingObservations
object
A batch of scouting observations
1 property 1 required
ApplicationActivityContents
object
1 property 1 required
ScoutingObservationAttachments
object
A batch of scouting attachments
1 property 1 required
PlantingActivityContents
object
1 property 1 required
PlantingActivitySummary
object
7 properties 7 required
PlantingActivitySummaryResponse
object
31 properties 28 required
Error
object
1 property
Geometry
object
GeoJSON
2 properties 2 required
ApplicationActivities
object
A batch of application activities
1 property 1 required

Specification

The full machine-readable OpenAPI contract behind this narrative.

Source

the-climate-corporation-layers-api-openapi.yml Raw ↑

Other APIs The Climate Corporation publishes across the network.

The Climate Corporation Boundaries API
The Climate Corporation Exports API
The Climate Corporation FarmOrganizations API
The Climate Corporation Fields API
The Climate Corporation Operations API
The Climate Corporation ResourceOwners API
The Climate Corporation Uploads API