Home :: Basic :: Extra :: Donate

Tag-ToDo-List API
This API (ContentProvider) is useful for Android developers who would like to include content from Tag-ToDo-List in their own app search or other features. The API exposes the tasks and the tags, under various forms, as described below.

The authority (or simply put, the main URI of the content provider for this app) is content://com.android.todo.sync.provider

Tags
If you want to retrieve a Cursor object over the tags, the URI you seek is content://com.android.todo.sync.provider/tags

If you want to retrieve a Cursor over the tasks from a certain tag, just go deeper into this hierarchy: content://com.android.todo.sync.provider/tags/[tagname]. For example, content://com.android.todo.sync.provider/tags/Personal or content://com.android.todo.sync.provider/tags/Work

Tasks
A Cursor over all tasks (no matter what tag) is given by content://com.android.todo.sync.provider/tasks

A Cursor over due tasks is given by content://com.android.todo.sync.provider/tasks/due. This shows all the due tasks, including those dated in the future. If you just want those due today or earlier (meaning those that the user should have completed by now), access content://com.android.todo.sync.provider/tasks/due/present

Cursors
Both the tag and the task cursors have a "name" column which reveals their actual text. Additionally, a task cursor has a "status" column, which, if equal to 0, shows that the task is unchecked. The way to obtain these Cursors from the URIs mentioned above is through a ContentResolver.

If you use this API in one of your app features, i would appreciate it if you'd let me know so i can continuously improve it and the app itself. Thanks and good luck!
Feedback form