Retrieve jobs categories

This is a convenience method that returns jobs categories from Trade Me Jobs.

URL:	https://api.trademe.co.nz/v1/categories/jobs.{file_format}
HTTP Method:	GET
Requires Authentication?	No
Permission Required:	Public
Supported Formats:	XML, JSON
Rate Limited?	No

URL parameters

file_format

Enumeration (required)

The format of the response.

xml	Serialize responses into XML.
json	Serialize responses into JSON.

Query String parameters

region	Integer (optional)	The ID of the region used to filter listing counts. Only applicable if with_counts is true.
with_counts	Boolean (optional)	Indicates whether to include the number of listings in each category. Defaults to false.

Returns

Collection of <JobCategory>

A category containing all job categories.

Name	String or null	Name
Code	String or null	Code
SubCategories	Collection of <JobCategory> or null	SubCategories
(This type has already been defined)

Example XML Response (switch to JSON)

<JobCategories xmlns="http://api.trademe.co.nz/v1">
  <JobCategory>
    <Name>ABC</Name>
    <Code>ABC</Code>
    <SubCategories>
      <JobCategory />
      <JobCategory />
    </SubCategories>
  </JobCategory>
  <JobCategory>
    <Name>ABC</Name>
    <Code>ABC</Code>
    <SubCategories>
      <JobCategory />
      <JobCategory />
    </SubCategories>
  </JobCategory>
</JobCategories>

Example JSON Response (switch to XML)

[
  {
    "Name": "ABC",
    "Code": "ABC",
    "SubCategories": [
      {
      },
      {
      }
    ]
  },
  {
    "Name": "ABC",
    "Code": "ABC",
    "SubCategories": [
      {
      },
      {
      }
    ]
  }
]