Skip to content

Listing your submission forecast skill scores

This section provides an example of how to list your submissions and retrieve the submitted forecast time-series.

API Endpoints:

To interact with the Predicto API and retrieve information about your submissions and respective submitted forecast time-series, you can use the following endpoints:

Access Token Required

An access token must be included in the Authorization header of your request. If you haven't obtained an access token yet, please refer to the Authentication section.

Check this out

Check our Useful Links section for additional resources (Jupyter Notebook, API Specifications) to help you get started with the Predico platform.

Retrieving your historical submissions forecasts:

Here's how you can retrieve the list your past submissions.

download_submissions.py
import requests

# Authenticate via `/token` endpoint
access_token = "your_access_token_here"
headers = {
    'Authorization': f'Bearer {access_token}',
    'Accept': 'application/json'
}

# List your historical submissions:
response = requests.get(
    url='https://predico-elia.inesctec.pt/api/v1/market/challenge/submission',
    headers=headers
)

# Check if the request was successful
if response.status_code == 200:
    submissions = response.json()
else:
    print("Failed to retrieve submissions.")
    print(f"Status code: {response.status_code}")
    exit()

# Select a submission and respective challenge:
selected_submission = submissions["data"][0]
submission_id = selected_submission['id']
challenge_id = selected_submission['market_session_challenge']
print("Selected Submission:")
print(f"Submission ID: {submission_id}")
print(f"Challenge ID: {challenge_id}")

# Request the submitted forecast timeseries for this challenge
response = requests.get(
    url='https://predico-elia.inesctec.pt/api/v1/market/challenge/submission/forecasts',
    params={'challenge': challenge_id},
    headers=headers
)

# Check if the request was successful
if response.status_code == 200:
    submission_forecasts = response.json()
    print(submission_forecasts)
else:
    print("Failed to retrieve submission forecasts.")
    print(f"Status code: {response.status_code}")
    exit()

Download Full Example

JSON Example Response

After running the example script, you will have access your submissions list and the respective forecasted time-series.

If no data is received, please confirm if you are requesting data for the right challenge and/or resource identifier.

Click to view Example Response 
{
  "code": 200,
  "data": [
    {
      "id": "41ccbb67-1612-4045-8674-671e7631777d",
      "market_session_challenge_resource_id": "ba7203df-0618-4001-a2e9-b0a11cc477f9",
      "variable": "q50",
      "registered_at": "2024-10-25T15:35:04.213124Z",
      "market_session_challenge": "77c6e03a-0e45-467c-aa81-2cb7fb11c497",
      "user": "6a71b254-8a52-4dd8-a345-32c02af3ebb0"
    }
  ]
}

What's next?

Learn how to list your submission scores on the Predico platform in the Listing Submission Scores section.