---
updatedAt: 2025-11-10T18:13:53.000Z
agentTools:
  projectIndex: https://developer.answerhub.com/llms.txt
---

# 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
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

```json Sample Formatted JSON Response
{
    "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"
        }
    ]
}
```

# OpenAPI definition

```json
{
  "openapi": "3.1.0",
  "info": {
    "title": "api-settings",
    "version": "2.30.0"
  },
  "servers": [
    {
      "url": "https://apidocs.cloud.answerhub.com/services/v2"
    }
  ],
  "components": {
    "securitySchemes": {
      "sec0": {
        "type": "http",
        "scheme": "basic"
      }
    }
  },
  "security": [
    {
      "sec0": []
    }
  ],
  "paths": {
    "/{award}.json": {
      "get": {
        "summary": "Retrieve Award List",
        "description": "You can use this API request to retrieve a paged list of the awards currently installed on your AnswerHub site.",
        "operationId": "retrieve-award-list",
        "responses": {
          "200": {
            "description": "200",
            "content": {
              "application/json": {
                "examples": {
                  "Result": {
                    "value": "{}"
                  }
                },
                "schema": {
                  "type": "object",
                  "properties": {}
                }
              }
            }
          },
          "400": {
            "description": "400",
            "content": {
              "application/json": {
                "examples": {
                  "Result": {
                    "value": "{}"
                  }
                },
                "schema": {
                  "type": "object",
                  "properties": {}
                }
              }
            }
          }
        },
        "deprecated": false
      }
    }
  },
  "x-readme": {
    "headers": [
      {
        "key": "Accept",
        "value": "application/json"
      },
      {
        "key": "Content-type",
        "value": "application/json"
      }
    ],
    "explorer-enabled": true,
    "proxy-enabled": true
  },
  "x-readme-fauxas": true
}
```