Retrieve Award List

You can use this API request to retrieve a paged list of the awards currently installed on your AnswerHub site.

/services/v2/award.json

You can use the following parameters in your retrieve award list request:

Sort: sort by date or relevance
Search: q, type, lang
Other options: wrap, v1

🚧

Permissions & Notes:

  • You must have the Use site permission under Anonymous Roles in the Advanced Editor.

  • The actual list of AwardType (types of awards) returned depends on the set of installed and active plugins for your system (they may contribute additional types of awards).

  • We added this request in version 1.6.3.

Sample Request

A GET retrieve award list request sent to https://apidocs.cloud.answerhub.com using a human-readable Username/Password (answerhub/test123) would look like this:

curl 
-u answerhub:test123 
-H "Accept: application/json" 
-H "Content-type: application/json" 
-X GET "https://apidocs.cloud.answerhub.com/services/v2/award.json"

Sample Response

Successful Response:

  • HTTP Status 200 - OK
{
    "name": "",
    "sort": "creationDate",
    "page": 1,
    "pageSize": 1,
    "pageCount": 47,
    "listCount": 47,
    "totalCount": 47,
    "list": [
        {
            "id": 498,
            "creationDate": 1542779465000,
            "creationDateFormatted": "11/21/2018 05:51 AM",
            "name": "The Thinker",
            "description": "Suggested an idea with 100 views",
            "active": true,
            "level": "bronze",
            "mode": "per_node"
        },
        {
            "id": 501,
            "creationDate": 1542779465000,
            "creationDateFormatted": "11/21/2018 05:51 AM",
            "name": "Bright Idea",
            "description": "Suggested an idea voted up 5 times",
            "active": true,
            "level": "bronze",
            "mode": "per_node"
        },
        {
            "id": 502,
            "creationDate": 1542779465000,
            "creationDateFormatted": "11/21/2018 05:51 AM",
            "name": "Critic",
            "description": "First down vote",
            "active": true,
            "level": "bronze",
            "mode": "per_user_and_site"
        },
        {
            "id": 505,
            "creationDate": 1542779465000,
            "creationDateFormatted": "11/21/2018 05:51 AM",
            "name": "Supporter",
            "description": "First up vote",
            "active": true,
            "level": "bronze",
            "mode": "per_user_and_site"
        },
        {
            "id": 506,
            "creationDate": 1542779465000,
            "creationDateFormatted": "11/21/2018 05:51 AM",
            "name": "Citizen Patrol",
            "description": "First flagged post",
            "active": true,
            "level": "bronze",
            "mode": "per_user_and_site"
        },
        {
            "id": 507,
            "creationDate": 1542779465000,
            "creationDateFormatted": "11/21/2018 05:51 AM",
            "name": "Editor",
            "description": "First edit",
            "active": true,
            "level": "bronze",
            "mode": "per_user_and_site"
        },
        {
            "id": 508,
            "creationDate": 1542779465000,
            "creationDateFormatted": "11/21/2018 05:51 AM",
            "name": "Cleanup",
            "description": "First Rollback",
            "active": true,
            "level": "bronze",
            "mode": "per_user_and_site"
        },
        {
            "id": 511,
            "creationDate": 1542779465000,
            "creationDateFormatted": "11/21/2018 05:51 AM",
            "name": "Nice Question",
            "description": "Question voted up 3 times",
            "active": true,
            "level": "bronze",
            "mode": "per_node"
        },
        {
            "id": 512,
            "creationDate": 1542779465000,
            "creationDateFormatted": "11/21/2018 05:51 AM",
            "name": "Nice Answer",
            "description": "Answer voted up 3 times",
            "active": true,
            "level": "bronze",
            "mode": "per_node"
        },
        {
            "id": 518,
            "creationDate": 1542779465000,
            "creationDateFormatted": "11/21/2018 05:51 AM",
            "name": "Popular Question",
            "description": "Asked a question with 200 views",
            "active": true,
            "level": "bronze",
            "mode": "per_node"
        },
        {
            "id": 520,
            "creationDate": 1542779465000,
            "creationDateFormatted": "11/21/2018 05:51 AM",
            "name": "Disciplined",
            "description": "Deleted own post with score of 3 or higher",
            "active": true,
            "level": "bronze",
            "mode": "per_node"
        },
        {
            "id": 523,
            "creationDate": 1542779465000,
            "creationDateFormatted": "11/21/2018 05:51 AM",
            "name": "Peer Pressure",
            "description": "Deleted own post with score of -3 or lower",
            "active": true,
            "level": "bronze",
            "mode": "per_author_and_node"
        },
        {
            "id": 524,
            "creationDate": 1542779465000,
            "creationDateFormatted": "11/21/2018 05:51 AM",
            "name": "Pundit",
            "description": "Left 10 comments",
            "active": true,
            "level": "bronze",
            "mode": "per_user_and_site"
        },
        {
            "id": 527,
            "creationDate": 1542779465000,
            "creationDateFormatted": "11/21/2018 05:51 AM",
            "name": "Student",
            "description": "Asked first question with at least one up vote",
            "active": true,
            "level": "bronze",
            "mode": "per_author_and_site"
        },
        {
            "id": 528,
            "creationDate": 1542779465000,
            "creationDateFormatted": "11/21/2018 05:51 AM",
            "name": "Teacher",
            "description": "Answered first question with at least one up vote",
            "active": true,
            "level": "bronze",
            "mode": "per_author_and_site"
        },
        {
            "id": 529,
            "creationDate": 1542779465000,
            "creationDateFormatted": "11/21/2018 05:51 AM",
            "name": "Scholar",
            "description": "First accepted answer on your own question",
            "active": true,
            "level": "bronze",
            "mode": "per_user_and_site"
        },
        {
            "id": 534,
            "creationDate": 1542779465000,
            "creationDateFormatted": "11/21/2018 05:51 AM",
            "name": "Organizer",
            "description": "First retag",
            "active": true,
            "level": "bronze",
            "mode": "per_user_and_site"
        },
        {
            "id": 537,
            "creationDate": 1542779465000,
            "creationDateFormatted": "11/21/2018 05:51 AM",
            "name": "Self Learner",
            "description": "Answered your own question with at least 3 upvotes",
            "active": true,
            "level": "bronze",
            "mode": "per_user_and_node"
        },
        {
            "id": 491,
            "creationDate": 1542779465000,
            "creationDateFormatted": "11/21/2018 05:51 AM",
            "name": "Awareness of Issues",
            "description": "Voted on 10 questions",
            "active": true,
            "level": "silver",
            "mode": "per_user_and_site"
        },
        {
            "id": 492,
            "creationDate": 1542779465000,
            "creationDateFormatted": "11/21/2018 05:51 AM",
            "name": "Statler and Waldorf",
            "description": "Provided 25 comments",
            "active": true,
            "level": "silver",
            "mode": "per_user_and_site"
        },
        {
            "id": 494,
            "creationDate": 1542779465000,
            "creationDateFormatted": "11/21/2018 05:51 AM",
            "name": "Attention to Results",
            "description": "Voted on 20 answers",
            "active": true,
            "level": "silver",
            "mode": "per_user_and_site"
        },
        {
            "id": 495,
            "creationDate": 1542779465000,
            "creationDateFormatted": "11/21/2018 05:51 AM",
            "name": "Good Citizen",
            "description": "Voted 50 times, provided 10 questions and 10 answers",
            "active": true,
            "level": "silver",
            "mode": "per_user_and_site"
        },
        {
            "id": 499,
            "creationDate": 1542779465000,
            "creationDateFormatted": "11/21/2018 05:51 AM",
            "name": "Kickstarter",
            "description": "Suggested an idea with 300 views",
            "active": true,
            "level": "silver",
            "mode": "per_node"
        },
        {
            "id": 504,
            "creationDate": 1542779465000,
            "creationDateFormatted": "11/21/2018 05:51 AM",
            "name": "Whiz Kid",
            "description": "Suggested an idea voted up 20 times",
            "active": true,
            "level": "silver",
            "mode": "per_node"
        },
        {
            "id": 509,
            "creationDate": 1542779465000,
            "creationDateFormatted": "11/21/2018 05:51 AM",
            "name": "Civic Duty",
            "description": "Voted 15 times",
            "active": true,
            "level": "silver",
            "mode": "per_user_and_site"
        },
        {
            "id": 510,
            "creationDate": 1542779465000,
            "creationDateFormatted": "11/21/2018 05:51 AM",
            "name": "Strunk & White",
            "description": "Edited 10 entries",
            "active": true,
            "level": "silver",
            "mode": "per_user_and_site"
        },
        {
            "id": 514,
            "creationDate": 1542779465000,
            "creationDateFormatted": "11/21/2018 05:51 AM",
            "name": "Good Question",
            "description": "Question voted up 5 times",
            "active": true,
            "level": "silver",
            "mode": "per_node"
        },
        {
            "id": 515,
            "creationDate": 1542779465000,
            "creationDateFormatted": "11/21/2018 05:51 AM",
            "name": "Good Answer",
            "description": "Answer voted up 5 times",
            "active": true,
            "level": "silver",
            "mode": "per_node"
        },
        {
            "id": 517,
            "creationDate": 1542779465000,
            "creationDateFormatted": "11/21/2018 05:51 AM",
            "name": "Notable Question",
            "description": "Asked a question with 300 views",
            "active": true,
            "level": "silver",
            "mode": "per_node"
        },
        {
            "id": 522,
            "creationDate": 1542779465000,
            "creationDateFormatted": "11/21/2018 05:51 AM",
            "name": "Necromancer",
            "description": "Answered a question more than 60 days later with at least 5 votes",
            "active": true,
            "level": "silver",
            "mode": "per_node"
        },
        {
            "id": 525,
            "creationDate": 1542779465000,
            "creationDateFormatted": "11/21/2018 05:51 AM",
            "name": "Enlightened",
            "description": "First answer was accepted with at least 10 up votes",
            "active": true,
            "level": "silver",
            "mode": "per_parent"
        },
        {
            "id": 526,
            "creationDate": 1542779465000,
            "creationDateFormatted": "11/21/2018 05:51 AM",
            "name": "Guru",
            "description": "Accepted answer and voted up 20 times",
            "active": true,
            "level": "silver",
            "mode": "per_author_and_node"
        },
        {
            "id": 531,
            "creationDate": 1542779465000,
            "creationDateFormatted": "11/21/2018 05:51 AM",
            "name": "Enthusiast",
            "description": "Visited the site each day for 30 consecutive days",
            "active": true,
            "level": "silver",
            "mode": "per_user_and_site"
        },
        {
            "id": 533,
            "creationDate": 1542779465000,
            "creationDateFormatted": "11/21/2018 05:51 AM",
            "name": "Favorite Question",
            "description": "Question favorited by 25 users",
            "active": true,
            "level": "silver",
            "mode": "per_node"
        },
        {
            "id": 535,
            "creationDate": 1542779465000,
            "creationDateFormatted": "11/21/2018 05:51 AM",
            "name": "Taxonomist",
            "description": "Created a tag used by 50 questions",
            "active": true,
            "level": "silver",
            "mode": "any"
        },
        {
            "id": 536,
            "creationDate": 1542779465000,
            "creationDateFormatted": "11/21/2018 05:51 AM",
            "name": "Yearling",
            "description": "Active member for a year, earning at least 200 reputation",
            "active": true,
            "level": "silver",
            "mode": "per_user_and_site"
        },
        {
            "id": 493,
            "creationDate": 1542779465000,
            "creationDateFormatted": "11/21/2018 05:51 AM",
            "name": "Know-It-All",
            "description": "Received at least 3 accepted answers",
            "active": true,
            "level": "gold",
            "mode": "per_author_and_site"
        },
        {
            "id": 496,
            "creationDate": 1542779465000,
            "creationDateFormatted": "11/21/2018 05:51 AM",
            "name": "Alex Trebek",
            "description": "Accepted answers on 3 or more questions",
            "active": true,
            "level": "gold",
            "mode": "per_user"
        },
        {
            "id": 497,
            "creationDate": 1542779465000,
            "creationDateFormatted": "11/21/2018 05:51 AM",
            "name": "Seal of Approval",
            "description": "User who accepts answers on 50% of questions they have posted",
            "active": true,
            "level": "gold",
            "mode": "per_user"
        },
        {
            "id": 500,
            "creationDate": 1542779465000,
            "creationDateFormatted": "11/21/2018 05:51 AM",
            "name": "Innovator",
            "description": "Suggested an idea with 500 views",
            "active": true,
            "level": "gold",
            "mode": "per_node"
        },
        {
            "id": 503,
            "creationDate": 1542779465000,
            "creationDateFormatted": "11/21/2018 05:51 AM",
            "name": "Genius",
            "description": "Suggested an idea voted up 50 times",
            "active": true,
            "level": "gold",
            "mode": "per_node"
        },
        {
            "id": 513,
            "creationDate": 1542779465000,
            "creationDateFormatted": "11/21/2018 05:51 AM",
            "name": "Great Question",
            "description": "Question voted up 8 times",
            "active": true,
            "level": "gold",
            "mode": "per_node"
        },
        {
            "id": 516,
            "creationDate": 1542779465000,
            "creationDateFormatted": "11/21/2018 05:51 AM",
            "name": "Great Answer",
            "description": "Answer voted up 8 times",
            "active": true,
            "level": "gold",
            "mode": "per_node"
        },
        {
            "id": 519,
            "creationDate": 1542779465000,
            "creationDateFormatted": "11/21/2018 05:51 AM",
            "name": "Famous Question",
            "description": "Asked a question with 500 views",
            "active": true,
            "level": "gold",
            "mode": "per_node"
        },
        {
            "id": 521,
            "creationDate": 1542779465000,
            "creationDateFormatted": "11/21/2018 05:51 AM",
            "name": "Autobiographer",
            "description": "Completed all user profile fields",
            "active": true,
            "level": "gold",
            "mode": "per_user"
        },
        {
            "id": 530,
            "creationDate": 1542779465000,
            "creationDateFormatted": "11/21/2018 05:51 AM",
            "name": "Fanatic",
            "description": "Visited the site each day for 100 consecutive days",
            "active": true,
            "level": "gold",
            "mode": "per_user_and_site"
        },
        {
            "id": 532,
            "creationDate": 1542779465000,
            "creationDateFormatted": "11/21/2018 05:51 AM",
            "name": "Stellar Question",
            "description": "Question favorited by 100 users",
            "active": true,
            "level": "gold",
            "mode": "per_node"
        }
    ]
}
Language
Authorization
Basic
base64
:
Click Try It! to start a request and see the response here!