Plans on more API aspect tutorials?

I’m toying around with accessing data using the API aspect, and I was happy to see that there have been new tutorials added in 2026, such as this one: 101.2. How to get started with PyVO — DP1

Are there plans for more? For example, I’ve successfully accessed the TAP endpoint, but now I’m trying to query the SIA endpoint ( https://data.lsst.cloud/api/dp1/query) using the pyvo SIAService following a similar pattern, but I’m getting a not found error for the default coordinates

image

I’m very much a novice, and documentation on how to do this via the API is sparse, so I’m not sure if I’m doing a configuration wrong, or the endpoint isn’t right, etc. so any additional tutorials for things like this would be really cool! Thanks!

@JohnStorgion , thank you for your post! I was able to reproduce your result, and after some internal investigation with our RSP team, we were able to identify a typo in the https://data.lsst.cloud/api-aspect page for the SIA service endpoint: it should be https://data.lsst.cloud/api/sia/dp1/query instead of https://data.lsst.cloud/api/dp1/query. The typo has been fixed in the documentation source and the page should be updated shortly.

Another thing to keep in mind is the scope of the token: for retrieving images, make sure to also select read:image when generating one (see the documentation in Creating user tokens — Rubin Science Platform).

The following minimal example worked for me from Google Colab:

import pyvo
import requests
token = ...
session = requests.Session()
session.headers["Authorization"] = f"Bearer {token}"
rsp_sia_url = "https://data.lsst.cloud/api/sia/dp1/query"
sia_service = pyvo.dal.SIA2Service(rsp_sia_url, session=session, check_baseurl=False)
circle = (53.076, -28.110, 0.05)
results = sia_service.search(pos=circle, calib_level=2, maxrec=5)

We can confirm that more or updated API tutorials are on the way; stay tuned!

I’ll mark this as the solution, but please let us know if you have any more questions!

1 Like

This worked perfectly, thank you @plazas ! Glad I was able to help catch an issue.

1 Like