Introduction

in order to enable a programmatic interface to the ground truth production process, an http api is made available this page aims at describing how to work with these integrations, what the available possibilities are, and the concepts and identifiers used the current possibilities are limited to reviewing delivered annotations prerequisites before you begin, make sure you have an account with permissions to use our api generated api credentials see advanced setup docid\ xmgm2k teox9jtn otqbm installed our python 3 sdk for authentication kognic auth https //pypi org/project/kognic auth/ this page will also assume that the user has access to at least one project where at least one input batch has been uploaded api client the kognic io python client https //pypi org/project/kognic io/ covers a majority of the endpoints for the case of missing coverage, we'll provide examples of how you can interact with our api with just kognic auth and the requests library endpoints you can discover the list of accessible endpoints within our swagger documentation https //annotation integration app kognic com/api request example here's an example using the kognic auth library to fetch the review docid\ eaokniu0rtitvvuddsgva available to the user import requests from kognic auth requests auth session import requestsauthsession base url = "https //annotation integration app kognic com/v1/" client = requestsauthsession() try response = client session get(base url + "reviews/error types") response raise for status() data = response json() print(data) except requests exceptions requestexception as e print(f"request error {e}")