Account

Information about your OpenET account.

Note: OpenET uses a tiered system for accounts. Results from each of the following endpoints may vary by account. For more information, check out the Quota section.

Account Status

Retrieve information about your account in a JSON format. See the Quota page for additional details.

Upload

post

Upload a temporary GeoJSON file to use with OpenET.

Authorizations

AuthorizationstringRequired

Body

filestring · binaryRequired

Responses

200

Successful Response

application/json

Responseany

422

Validation Error

application/json

No content

Take a look at how you might call this method:

curl -X 'GET' \
  'https://openet-api.org/account/status' \
  -H 'accept: application/json' \
  -H 'Authorization: YOUR_API_KEY'

import requests

# set your API key before making the request
header = {"Authorization": YOUR_API_KEY}

# query the api 
resp = requests.get(
    headers=header,
    url="https://openet-api.org/account/status"
)

print(resp.json())

Account Storage

If your OpenET account is not synced with your personal Google Earth Engine account, all exported data will be stored in a secure private Google Cloud Bucket. The following endpoint allows you to retrieve downloadable links to these files. This endpoint must be called to continue exporting if there are over 100 files which have not been retrieved.

Once this endpoint has been called, all existing files will be moved to a public bucket with a 24 hour lifecycle. Data return is in a JSON format.

Warning: exported files will be automatically deleted after 7 days if not retrieved.

Storage

get

Retrieves information on all current files exported to OpenET's Google Bucket.

Authorizations

AuthorizationstringRequired

Responses

200

Successful Response

application/json

Responseany

200

Successful Response

No content

Take a look at how you might call this method using our official libraries, or via curl:

curl -X 'GET' \
  'https://openet-api.org/account/storage' \
  -H 'accept: application/json' \
  -H 'Authorization: YOUR_API_KEY'

import requests

# set your API key before making the request
header = {"Authorization": YOUR_API_KEY}

# query the api 
resp = requests.get(
    headers=header,
    url="https://openet-api.org/account/storage"
)

print(resp.json())

Upload a File

As an alternative to storing shapefiles on Google Earth Engine, OpenET allows you to generate a temporary asset id by uploading a RFC 7946 formatted GeoJSON file to delineate boundaries for data extractions.

Each file uploaded has a maximum file size of 25mb and expires after 72 hours. During this time you can use the generated temporary asset id for the corresponding parameter. Data return is in a JSON format.

Upload

post

Upload a temporary GeoJSON file to use with OpenET.

Authorizations

AuthorizationstringRequired

Body

filestring · binaryRequired

Responses

200

Successful Response

application/json

Responseany

422

Validation Error

application/json

No content

Take a look at how you might call this method using python, or via curl:

curl -X 'POST' \
  'https://openet-api.org/account/upload' \
  -H 'accept: application/json' \
  -H 'Authorization: YOUR_API_KEY' \
  -H 'Content-Type: multipart/form-data' \
  -F 'file=@YOUR_FILE.geojson'

import requests

# set your API key before making the request
header = {"Authorization": YOUR_API_KEY}

# endpoint arguments
args = {
    'file': ('PATH/TO/sample.geojson', open('PATH/TO/sample.geojson', 'rb'), 'application/geo+json')
}

# query the api 
resp = requests.post(
    headers=header,
    files=args,
    url="https://openet-api.org/account/upload"
)

print(resp.json())

Decrypt a File

If you have opted to encrypt a file during an export, the following endpoint allows you to decrypt it. This works for both .TIFF rasters and .CSV files. Each account has its own unique rotating key so that no user will be able to decrypt another user's files.

Note: OpenET's free account tier does not offer this encryption service. See the Quota page for more information.

Decrypt

post

Decrypt an OpenET encrypted file.

Authorizations

AuthorizationstringRequired

Body

filestring · binaryRequired

Responses

200

Successful Response

application/json

Responseany

422

Validation Error

application/json

No content

Take a look at how you might call this method using our official libraries, or via curl:

curl -X 'POST' \
  'https://openet-api.org/account/decrypt' \
  -H 'accept: application/json' \
  -H 'Authorization: YOUR_API_KEY' \
  -H 'Content-Type: multipart/form-data' \
  -F 'file=@YOUR_ENCRYPTED_FILE.tif;type=image/tiff'

import requests

# set your API key before making the request
header = {"Authorization": YOUR_API_KEY}

# endpoint arguments
args = {
    'file': ('PATH/TO/encrypted.geojson', open('PATH/TO/encrypted.geojson', 'rb'), 'application/geo+json')
}

# query the api 
resp = requests.get(
    headers=header,
    files=args,
    url="https://openet-api.org/account/decrypt"
)

print(resp.json())

Last updated 11 days ago

hashtagAccount Status

hashtagUpload

hashtagAccount Storage

hashtagStorage

hashtagUpload a File

hashtagUpload

hashtagDecrypt a File

hashtagDecrypt

Account Status

Upload

Account Storage

Storage

Upload a File

Upload

Decrypt a File

Decrypt