Help Needed with Migrating from API v1 to API v2 for KoboToolbox Humanitarian Server

[ckoyuncu]

Hi everyone,

I’m working on migrating a pipeline that was using the KoboToolbox API v1 (specifically for the Humanitarian server). After v1 was deprecated, we’ve encountered issues accessing the correct API v2 endpoints. For example, I used to pull data from endpoints like https://kc.humanitarianresponse.info/api/v1/data/{form_id}, but now I need to migrate to v2 and am struggling to find equivalent endpoints.

I’ve tried accessing https://kobo.humanitarianresponse.info/api/v2/assets/, but I’m not sure how to correctly retrieve form data and submissions as we did with v1. Additionally, I need clarification on handling project invites and permissions under v2.

Can someone help guide me on how to correctly interact with the KoboToolbox API v2, particularly for the humanitarian server? Any documentation or examples would be really helpful!

Thanks in advance!

[Kal_Lam]

Welcome back to the community, @ckoyuncu! Maybe this post discussed previously should provide you some help:

KoBo API examples, using new KPI endpoints

This is copied from some private correspondence I had a while ago. Perhaps it’s useful to someone in this format, until more official documentation is developed for the new API In writing “new,” I’m contrasting KPI to the old KoBoCAT (/api/v1) API. KoBo API Examples I’ve used curl to demonstrate these API calls. You’ll notice that all my curl commands begin with curl --silent --user jnm_api:some-secret-phrase --header 'Accept: application/json' and end by being piped to python -m…

[osmanburcu]

Hi @ckoyuncu, do you still need help? I am happy to help!