Website logo

Retrieve legal notice for a category

Retrieves the legal notice that the user is required to agree to before listing. Most categories do not require that the user agree to a legal notice - these categories will return an empty string.

This API is deprecated in favour of the category details API.

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

URL parameters

category String (required)

The number of the category to retrieve the legal notice for. This must be a leaf category (for example, you cannot view the legal notice for Business, Farming & Industry, but you can for Business, Farming & Industry > Carbon credits).

file_format Enumeration (required) The format of the response.
xml Serialize responses into XML.
json Serialize responses into JSON.

Returns

<LegalNotice>

Text String or null

The text which can be used to display a legal notice

Examples

https://api.trademe.co.nz/v1/Categories/6327/LegalNotice.xml - Retrieves the legal notice for the carbon credits category.

Example XML Response (switch to JSON)

<LegalNotice xmlns="http://api.trademe.co.nz/v1">
  <Text>ABC</Text>
</LegalNotice>

Example JSON Response (switch to XML)

{
  "Text": "ABC"
}