The categories methodmreturns a hierarchy of all job categories and sub-categories used in the Elance system.

This method must be called using an HTTPS GET request. All responses are returned in the JSON format.

tableofcontents_number_textPreconditions

This method requires that the calling application has authenticated a user with the OAuth 2.0 protocol, as described on the Getting Started page.

tableofcontents_number_textRequired URL Parameters

There are no required URL parameters for this method.

tableofcontents_number_textOptional Query String Parameters

There are no optional query string parameters for this method.

tableofcontents_number_textResponse Data Description

The data property of the response for this method contains an associative array of CategoryData objects whose key name is the ID for the category. The CategoryData object and its sub-objects are described below.

Property Name Data Type Description
catId integer The unique ID assigned to this category.
catName string The name of this category as it appears on the Elance Web site.
children Array of SubcategoryData objects An associative array of SubcategoryData objects whose key name is the ID for the category. The SubcategoryData object is described below.

tableofcontents_number_textSubcategoryData Object Description

Property Name Data Type Description
catId integer The unique ID assigned to this subcategory.
parentId integer The ID of this category's direct parent.
catName string The name of this subcategory as it appears on the Elance Web site.

tableofcontents_number_textRequest/Response Examples in JSON

tableofcontents_number_textRequesting the List of Categories

tableofcontents_number_textRequest

The following URL retrieves the current category list, including all subcategories.

https://api.elance.com/api2/categories?access_token=4eb1de8bf06b10210e000005|3828514|OJShVvvqedVk2a28BOO4fA

tableofcontents_number_textResponse

NOTE: This response has been truncated to display only a single category.

{
   "api": "categories",
   "rcode": 1,
   "data": {
      "10179": {
         "catId": 10179,
         "catName": "Admin Support",
         "children": {
            "12535": {
               "catId": 12535,
               "parentId": "10179",
               "catName": "Bulk Mailing"
            },
            "12536": {
               "catId": 12536,
               "parentId": "10179",
               "catName": "Customer Service"
            },
            "10194": {
               "catId": 10194,
               "parentId": "10179",
               "catName": "Data Entry"
            },
            "10199": {
               "catId": 10199,
               "parentId": "10179",
               "catName": "Event Planning"
            },
            "12537": {
               "catId": 12537,
               "parentId": "10179",
               "catName": "Fact Checking"
            },
            "12538": {
               "catId": 12538,
               "parentId": "10179",
               "catName": "Mailing List Development"
            },
            "10200": {
               "catId": 10200,
               "parentId": "10179",
               "catName": "Office Management"
            },
            "10201": {
               "catId": 10201,
               "parentId": "10179",
               "catName": "Other - Administrative Support"
            },
            "10195": {
               "catId": 10195,
               "parentId": "10179",
               "catName": "Presentation Formatting"
            },
            "12540": {
               "catId": 12540,
               "parentId": "10179",
               "catName": "Research"
            },
            "10196": {
               "catId": 10196,
               "parentId": "10179",
               "catName": "Transcription"
            },
            "10198": {
               "catId": 10198,
               "parentId": "10179",
               "catName": "Travel Planning"
            },
            "10243": {
               "catId": 10243,
               "parentId": "10179",
               "catName": "Virtual Assistant"
            },
            "10197": {
               "catId": 10197,
               "parentId": "10179",
               "catName": "Word Processing"
            }
         }
      }, [...]
   }
}

tableofcontents_number_textError Codes

For a list of additional error codes that can be thrown by this method, see Common API Error Codes.