File Upload

Scope3 supports multiple file formats, or schemas, that enable stateful processing of various types of data. These schemas are documented in the Schemas section of the documentation. Currently supported schemas:

Use Cases

There are a number of scenarios when you may want to upload data to Scope3. Such as traffic or media delivery data. With this data Scope3 is able to refine emissions modelling and report results in downstream tooling such as dashboards.

Upload Methods

3rd Party Integrations

Files may be ingested through various integrations (see Integrations section) such as Snowflake, Big Query, and cloud storage buckets.

File Upload API

To upload a file directly into the Scope3 API, use the Upload Data File API. The schema is specified through the type field, and the file data is added to the body of the request.

The upload API is asynchronous meaning that when you submit the request you will get back an id that you can send to the Get Data File Upload by ID to track the status of the upload. When complete, the upload will be marked as SUCCESS or FAILED and you can see statistics on rows processed vs skipped. Note there is a 100mb limit on files uploaded to the File Upload API.