Habitica Challenge Data Tool (v5.1 - vApi NOT INSTALLED !)

Please wait. Fetching data from Habitica...

There was an error obtaining your data.

  • Check your challenge id is a Challenge Id which is a string of characters similar to your UID. The Challenge ID appears at the end of the URL. Eg. 2ff9822b-27f2-4774-98da-db349b57a38e
  • Please reload the page and then check that your User ID and API Token are correct.
  • If you're using Internet Explorer, try another browser. Chrome or Firefox will be more reliable.
  • If the page's URL starts with "http://" change it to start with "https://" (or just use this correct link).
  • If neither of those help, contact me! See "Help and Contact Details" at the bottom of this page.

Version History

5.1 - Those Who Drink Tea Spot Bugs2021-01-03
  • Bug Fixes:
    • Typo in the gem reward message. Thank you @Ceran for spotting this.
5.0 - Do it Faster, Makes us Stronger2020-12-02
  • Features:
    • Handling for future parameter of ?tasks. (Yah Faster Downloads)
    • Changing selection to owner for quicker fetch of owned challenges
4.3 - Insert name here + New Limits2020-11-20
  • Features:
    • Handling new page limits when getting users challenges. (Yes a little flasher but not in the good way.)
  • Bug Fixes:
    • Handling when the name key is missing from the Category (Yes messy data from Habitica).
    • Removing moment warnings
4.2 - Cookie Cutter2020-08-26
  • Features:
    • Showing version of API as well as version of tool
4.1 - Warp Speed2020-08-01
  • Features:
    • Fetch member's details while asking for list - thus cutting down requests making the tool faster.
4.0 - Don't Limit the Drinks2020-07-22
  • Features:
    • Handling the new Habitica API Limits.
  • Documentation:
    • Updated documentation due to API Limits.
3.0 - Roses & Clunky Lines2019-05-01
  • Features:
    • Adding usernames (with alt if username not defined).
    • Able to put carriage returns into message (Clunky but will do for now).
    • Adding more detail about the Leader in text sections
    • Made usernames and display names linked to Habitica Profile Page.
  • Documentation:
    • Updated reference & email for spam to generic Admin.
    • Ensure display name and username displayed in non grid data.
    • Username only on Baby grid data.
  • Bug Fixes:
    • Able to display data if "no owner".
    • Handling in habits no scoredUp or scoredDown data.
2.2 - Bad Daily Habit2018-06-25
  • Bug Fixes:
    • Fixing negative click count for missed dailies in All Task History.
2.1 - No More Time for Habits2018-06-25
  • Features:
    • Modifying code to handle new habit recording structure. Clicks summarised per day.
  • Documentation:
    • Updating notes to match new habit structure and how dailies history are recorded (now actual date time of when daily was ticked, not cron time).
  • Bug Fixes:
    • Removing the duplicate for completed in dailies.
2.0 - Bag full of Goodies2018-04-30
  • Features:
    • Added the ability to handle timeouts when fetching members and list of members.
    • Hide Avatar images now on as default to avoid memory issues.
    • Added other url parameters, bear and porridge.
    • Added json of appearance to chat.
  • Documentation:
    • Fix thanks for Blade. (Link to code supplied).
  • Bug Fixes:
    • Url parameters apply independent of whether or not the user id parameter is supplied. (Thank you @Accio Books!)
    • Checkbox url parameters can be set to false.
    • Put back Participants likes.
1.8 - Message the Owner2017-12-10
  • Features:
    • Added Feature to Message the owner directly from the Challenge Tool.
    • Showed User Ids for Owners and Guild Leaders in the Overview.
1.7 - Pretty Pictures2017-11-10
  • Features:
    • Added Avatar Image. Deprecating Avatar link (Not currently available).
    • Added ability to hide Avatar Image for Faster Loading
    • Added Summary and Category information for Challenge.
    • Added ary and Category information for Guild
    • Remove deprecated Leader Message.
    • Updating URL to new website format.
    • Better error with POST functions handling.
    • Direct links to challenge at Habitica
    • Added hide_avatar as url option.
  • Documentation:
    • Clean up of code.
    • Minor fixes to formatting of check boxes.
1.6 - More Lessons in Counting2017-09-11
  • Features:
    • Set the Guild Chat to the Duelling Grounds Tally for the Duelling Grounds as this used more by challenges.
  • Bug Fixes:
    • Single direction habits now count correctly in the right direction.
1.5 - Really I Can Count!2017-08-19
  • Bug Fixes:
    • Better handling of null strings with markdown.
    • Mage totals now show in overview.
1.4 - Links!2017-08-02
  • Features:
    • Adding Link to Party Tool for Guild
    • Adding id for Challenge in Header
  • Documentation:
    • Minor wording changes for the section descriptions.
  • Bug Fixes:
    • Handle no owner when retrieving challenges list. (Left it to error when choosing a challenge when there is no owner - force users to get the data fixed).
    • documentation / options always shows next to the re-fetch button
    • Typo Successfully
1.3 - Banish the Chatter Bug2017-07-04
  • Features:
    • Added last cron to Participant details in Per Participant Stats/Random Winner.
  • Documentation:
    • Modified Participant details in Per Participant Stats/Random Winner to table for easier reading.
  • Bug Fixes:
    • Zero Chat Guilds are now fetch. Thanks @Altariel!
    • Chat Export and Chat Likes now show correctly for per member/random winner stats.
    • Papa Bear Option of Task Challenges now show all and correctly named columns for Tasks Overall.
1.2 - Message Ids2017-06-26
  • Features:
    • Added Message Id to Chat Sections for easy searching.
1.1 - Tick! Fixed up the Place2017-06-26
  • Features:
    • Added CheckList details in Participant Overall and Participant per Task.
    • Pressing the "Enter" key on the login screen down detects if you filled out challenge information. (Smart Detect if no challenge information will get list otherwise gets challenge data).
  • Documentation:
    • Formatting the front login page. Minor layout change of labels. Removing the word BETA. (Oops forgot to take the construction sign down).
    • Slight modification to the message warning to make it clearer (Added extra punctuation).
  • Bug Fixes:
    • Overview: now reflects it is the Overview for the challenge! Thanks @Altariel!
1.0 - Public Release!2017-06-19
  • Features:
    • Allowed user to have a select list of challenges they owned.
  • Documentation:
    • Further changing Member Details => Participant in Sections where it was missed
    • Add gems sent in confirmation message.
  • Bug Fixes:
    • Per Member stats only show leadership buttons if a leader.
    • Does not show HTML information if using leadership buttons in Participant List.
0.9 - beta release - While the Olds Gods Slept2017-06-03
  • Features:
    • Tasks Overall
    • Added Positive Clicks and Negative Clicks to Dashboard
    • Displaying correct error messages from Habitica. No more hardcoding.
    • Added Challenge Activity Breakdown to Overview.
    • Added Task (Type) Breakdown to Overview.
    • Added UID and if In Inn on Per Participant Stats.
    • Modify default columns for Baby & Mama View for Participant Overall.
    • Modify default columns for Baby View for Participant per Task.
  • Documentation:
    • Rename Section Member Overall Completion = > Participant Overall
    • Rename Section Member per Task Completion = > Participant per Task
    • Rename Section Member List = > Participant List
    • Rename Section Member Activity = > Participant Activity
    • Rename Section Per Member Stats/Random Winner = > Per Participant Stats/Random Winner
    • Rename Section All Task Completion History = > All Task History
    • In Overview Section Member => Participant
    • Minor Help text with Completion Stats tables
    • All Sections Completed => Clicks/Clicked
  • Bug Fixes:
    • Fixed Streaks to report correctly (A Negative streak is a negative Streak)
    • Fixed to-dos always to be counted as positive click regardless of value.
    • Handle zero habit difference values. Treated as positive. (Though this may be a bug in Habitica).
    • Awarding Gems in Per Member Stats/Random Winner now works all the time. Required to create new buttons for single section to fix. (Thank you @mandiferous. I finally found your bug)
    • Typo Challenge
0.8 - beta release - Are We There Yet? 2017-05-29
  • Features:
    • Names now render with markdown based on porridge option.
    • Prize at the top links to Select Winner. (Thank you @Accio Books!)
  • Documentation:
    • Minor text change re member activity.
    • Update to chat and PM Descriptions. (Thank you @Lorem)
  • Bug Fixes:
    • Allowed to Party challenges to be viewed. (Zero missing data for buffs/Transformation activity even though not calculated) (Thank you @Lalaitha)
    • Pretty names for tasks
    • Pretty names for challenges
    • Gem gifting message now shows message sent. (Thank you @mandiferous)
    • Removed incorrect references to the Data Display Tool. (Thank you @Alys)
    • Cold porridge now shows carriage returns.
    • Typo Participants
    • Minor formatting issues in Overview.
0.7 - beta release - Kill the Bug! 2017-05-13
  • Bug Fixes:
    • Re-fetching won't loose your random member
    • Re-fetching won't cause member selection/random member to loop multiple times
    • Leadership tools display correctly when switching challenges
    • Fix issue for Mod accessing Admin Tools
0.6 - beta release - Let the Mods Play! 2017-05-13
  • Features:
    • Allow the Mods to use the Admin Tools
  • Bug Fixes:
    • Fixed some version history gone astray
    • Won't crash if fetch details change without reloading - Need to fix leadership buttons appearing though
0.5 - beta release - The Final Push 2017-05-13
  • Features:
    • Added Challenge Gem Amount
    • Added User Gem Amount
  • Documentation:
    • Added notes about dates are displayed locally.
    • Added notes about leadership buttons.
    • Added notes on how to select multiple rows if leadership buttons available.
    • Ensured all columns are right justified for numbers and dates.
    • Minor Typos! I'm not *positive* I have them all ;)
  • Bug Fixes:
    • Leadership buttons now show if your the leader of the challenge. Not the leader of the guild. (Oops!)
    • Rename the confusing button from Fetch Group Data to Fetch Challenge Data (Only now this is noticed! Thanks @Alys)
0.4 - beta release - LIKE the rearrange? 2017-05-09
  • Features:
    • Chat Likes
    • PMs
    • Per Member Stats/Random Winner
    • Add Likes and Participant Likes Counts to Chat Export
    • Added Message, Gift Gems and Award Challenge to all tables if challenge owner. (Created function as required).
    • Remove Leadership Tools, Member Stats, Member Attribute (Function replace and/or information not useful).
  • Documentation:
    • Rearrange Menu headers and sections
0.3 - beta release - Quick Fixes to avoid being a Fool! 2017-04-01
  • Features:
    • Added Created date of Challenge to the header
  • Documentation:
    • Rename Admin to Mod (Less confusion)
    • Rename Leader to Owner
  • Bug Fixes:
    • Make Task information left justified
    • Fix task totals do not keep increasing when changing porridge options
    • Do not count dailies that are not due in streaks.
0.2 - beta release - This one is Useful! 2017-03-30
  • Features:
    • Upgrading code as per changes to Party And Guild Data Tool
    • Random Winner (Placeholder)
    • Leadership Tools
    • Chat Export with System Messages
    • Member Overall Completion
    • Member per Task Completion
    • All Task Completion History
  • Documentation:
    • Possible Future Features updated
    • Help and Contact Details updated
0.1 - beta release 2016-12-12
  • Features:
    • Overview
    • Member List Section (sample)
    • Member Activity Section (sample)
    • Member Stats Section (sample)
    • Chat Export Section
    • Chat Export without System Messages Section
  • Documentation:
    • Privacy and security notes (also related comments within the code)
    • What's On This Page? (descriptions of each feature)
    • Possible Future Features
    • Suspected Bugs (no support for old browsers; mobile support unknown)
    • Help and Contact Details
close version history (or click the version number again to close)

This page shows you certain information from your Habitica account. You can read the full list below, or just enter your details and try it out.

Enter your Habitica API details (from the Settings -> API page)

To ensure quick loads, only use one instance of Third Party Tool at a time.

Challenge ID:

Enter either the Challenge ID, or the URL for the Challenge. The Challenge ID is a string of characters similar to your User ID, e.g. 2ff9822b-27f2-4774-98da-db349b57a38e. The Challenge ID appears at the end of the URL or on the left hand panel on the website. It is not the name of the challenge. You can always just post the entire URL, which is much easier!

Privacy and security notes:

  • Your API Token is a password - do not share it with anyone, not even the maintainer of this page if you are seeking help.
  • When you enter your User ID and API Token here and click "Fetch My Data", your ID and Token are sent to Habitica's servers. They are not sent anywhere else. To confirm that, you can ask someone who knows the JavaScript programming language to examine the source of this page.
  • This page does not save your User ID and API Token to any location, but your browser might, if it has been configured to save form and password information. If you are using this page on a shared computer, you should clear any data that the browser has saved.
  • You cannot view anyone else's private data by using this page.
  • To clear your data, reload the page.

What's On This Page?

Leadership Buttons: to message challenge participants, gift gems and award & close the challenge only appear if you are the challenge owner.

All dates are displayed as per users' device.

FYI: Last Active date is the latest date of either Challenge Task Completion, Cron, Chat or Drop. It does not include if the user is chatting or using other areas of Habitica.

Possible Future Features

  • Section to choose winners by Daily/All Task Completed/Most Positive Ticks etc
  • Column Filtering (as opposed to single search box)
  • Multi line text box for PMs and chat messages.
  • Other Stuff?: Send me ideas! Contact details are below.

Known Bugs

The hiding and closing of sections is a bit funky. (One day I will fix it but not today.)

Internet Explorer will produce odd results if you use the "Re-Fetch Data" button. Reloading the page will fix the problem. Avoid using that button. Avoiding Internet Explorer will also work.

This page will not work correctly on old browsers because it uses modern website features and relies on compliance to standards (both can be lacking in old browsers). Updating your browser is important for general safety on the internet! If you have upgraded your browser to the latest version and are still having problems, please tell me! Contact details are below.

Regardless of what bugs there might be, this page cannot damage your account. It does not contain any code that could result in any changes being made on Habitica except actions performed through this website/API..

Thank You!

Thank you to @Alys & Ryan for their code which this is based. Thank you to Blade who provided me the code for the Avatars both the js and implementation here. Thank you all in the Javascript and Aspiring Comrades in answering my newbie questions.

Help and Contact Details

This page has been created by cTheDragons. If you have questions, problems, or suggestions, you're welcome to contact me, although I cannot guarantee that I'll always be able to spend a lot of time on this. You can contact me at Testing & Bug Squashing for Dragon Tools. I tend to ignore emails & PMs.

Code can be source at Github. Contributions are welcome. As already stated, any issues please report to Testing & Bug Squashing for Dragon Tools for a faster response and to avoid duplication.

If you have general questions about Habitica, post them to Tavern or Habitica Help: Ask a Question Guild.

hide documentation / options