In the new iNat API, observations are accessed by UUID instead of observation ID. So if you only know the observation ID, how do you get the UUID via the API (in order to retrieve the rest of the observation data)?

Not sure if this fully answers your question, but check this comment by @pisum : https://forum.inaturalist.org/t/search-observations-by-inaturalist-id-number/28413/2?u=earthknight

the v2 API is still early in development. is there a particular reason you’re trying to use that right now?

Thanks! That response explains how to retrieve an observation via an observation ID using the website, but I’m interested in how to do it via the API.

I have some scripts written for API v1 and I was investigating whether or not they will be able to migrate to API v2. Since everything in API v2 is based on UUID, it seems pretty critical that there’s a way to get the UUID using the observation ID, but so far I haven’t found a way to do this. Is the…

[image] zygy: a way to get the UUID using the observation ID One way is via GET /observations with id_above and id_below, using values one above and one below the required integer ID. This seems a little hacky, but I was able to get a valid response with the requested UUID via the API tester …

i assume the functionality will be added later, either where id will accept either the legacy numeric IDs if the input is a number, or UUIDs, if the input is a string; or where a legacy_id parameter will be added later. i wouldn’t assume that the id_above and id_below parameters will remain in the f…

Part of the point of API v2 is to remove the mapping between id and uuid, so a v2 method of doing that would defeat the purpose. For now, though, you can use API v1 for this. Here’s an example using curl and jq: curl "https://api.inaturalist.org/v1/observations/2" | jq ".results[0].uuid" That’s a…

Part of the point of API v2 is to remove the mapping between id and uuid , so a v2 method of doing that would defeat the purpose. Can you explain more about this? Is the plan to eventually switch over all the observation URLs to use uuids instead of ids? Currently, the only identifier that a naiv…

[image] zygy: Can you explain more about this? Is the plan to eventually switch over all the observation URLs to use uuids instead of ids? Well, the original plan was to switch to UUID-based URLs for obscured records as another roadblock to coordinate interpolation, but it’s becoming increasi…

API v2 question: How do you get the UUID for an observation?

Curators

jeanphilippeb February 14, 2023, 6:37am 8

I guess you are talking about:
https://forum.inaturalist.org/t/api-v2-feedback/21215

Topic		Replies	Views
Add UUID to observations/export csv Feature Requests web , implemented	2	1051	September 15, 2025
How to obtain the uuid with download observations? General	11	660	December 4, 2023
Why is there inconsistency in the way API v2 handles uuid in GET /places/{uuid} vs GET /observations/{uuid}? General question	0	60	May 25, 2026
Is the Observation Number Permanent? General	13	1345	April 29, 2020
Export by observation ID number URL blank CSV Bug Reports question	7	418	December 6, 2023

API v2 question: How do you get the UUID for an observation?

Related topics