Categories / Index

Name	Categories / Index
Description	Obtain a list of Categories that match given conditions
Type	GET
URL	/v9/categories
Credential Type	API\|User
Supports Pagination	No*

Long Description

Obtain a list of Categories that match given conditions.

Because the list of Categories rarely changes and is not very large ALL Categories will be returned from this endpoint if no parameters are passed.

Parameters

Name	Description	Type	Required	Location	Conditionals
`name`	Exact name of the Category	String	Optional	Query	No
`parent_id`	The ID of a parent Category.	Integer	optional	Query	No
`updated_at`	Date/time venue was updated	Date (ISO_8601)	Optional	Query	Yes

Examples

Request

Response

/v9/categories

{
  "categories": [{
    "id": "123",
    "url": "/categories/123",
    "parent": {
      "id": "19",
      "url": "/categories/19",
      "parent": {
        "id": "1",
        "url": "/categories/1",
        "parent": null,
        "name": "Sports",
        "updated_at": "2011-04-15T05:39:23Z"
      },
      "name": "Football",
      "updated_at": "2011-04-15T05:39:23Z"
    },
    "name": "Lingerie Football League",
    "updated_at": "2012-06-15T18:57:19Z"
  }, {
    "id": "85",
    "url": "/categories/85",
    "parent": {
      "id": "54",
      "url": "/categories/54",
      "parent": null,
      "name": "Concerts",
      "updated_at": "2010-07-30T17:39:59Z"
    },
    "name": "Latin",
    "updated_at": "2011-05-31T19:24:25Z"
  }, {
    "id": "9",
    "url": "/categories/9",
    "parent": {
      "id": "7",
      "url": "/categories/7",
      "parent": {
        "id": "1",
        "url": "/categories/1",
        "parent": null,
        "name": "Sports",
        "updated_at": "2011-04-15T05:39:23Z"
      },
      "name": "Basketball",
      "updated_at": "2011-04-15T05:39:23Z"
    },
    "name": "WNBA",
    "updated_at": "2011-04-15T05:39:23Z"
  }, {
    "id": "47",
    "url": "/categories/47",
    "parent": {
      "id": "44",
      "url": "/categories/44",
      "parent": {
        "id": "1",
        "url": "/categories/1",
        "parent": null,
        "name": "Sports",
        "updated_at": "2011-04-15T05:39:23Z"
      },
      "name": "Fighting",
      "updated_at": "2011-04-15T16:06:02Z"
    },
    "name": "Boxing",
    "updated_at": "2011-04-15T16:01:42Z"
  }, {
    "id": "28",
    "url": "/categories/28",
    "parent": {
      "id": "27",
      "url": "/categories/27",
      "parent": {
        "id": "1",
        "url": "/categories/1",
        "parent": null,
        "name": "Sports",
        "updated_at": "2011-04-15T05:39:23Z"
      },
      "name": "Auto Racing",
      "updated_at": "2011-04-15T16:04:42Z"
    },
    "name": "NASCAR",
    "updated_at": "2011-04-15T15:57:21Z"
  }, {
    "id": "133",
    "url": "/categories/133",
    "parent": {
      "id": "24",
      "url": "/categories/24",
      "parent": {
        "id": "1",
        "url": "/categories/1",
        "parent": null,
        "name": "Sports",
        "updated_at": "2011-04-15T05:39:23Z"
      },
      "name": "Golf",
      "updated_at": "2011-04-15T16:06:12Z"
    },
    "name": "LPGA",
    "updated_at": "2013-02-19T22:22:12Z"
  }, {
    "id": "57",
    "url": "/categories/57",
    "parent": {
      "id": "54",
      "url": "/categories/54",
      "parent": null,
      "name": "Concerts",
      "updated_at": "2010-07-30T17:39:59Z"
    },
    "name": "Rock & Pop",
    "updated_at": "2011-05-31T19:26:08Z"
  }, {
    "id": "76",
    "url": "/categories/76",
    "parent": {
      "id": "73",
      "url": "/categories/73",
      "parent": null,
      "name": "Special Events",
      "updated_at": "2010-07-30T17:39:59Z"
    },
    "name": "Fundraisers",
    "updated_at": "2010-07-30T17:39:59Z"
  }, {
    "id": "19",
    "url": "/categories/19",
    "parent": {
      "id": "1",
      "url": "/categories/1",
      "parent": null,
      "name": "Sports",
      "updated_at": "2011-04-15T05:39:23Z"
    },
    "name": "Football",
    "updated_at": "2011-04-15T05:39:23Z"
  }, {
    "id": "38",
    "url": "/categories/38",
    "parent": {
      "id": "34",
      "url": "/categories/34",
      "parent": {
        "id": "1",
        "url": "/categories/1",
        "parent": null,
        "name": "Sports",
        "updated_at": "2011-04-15T05:39:23Z"
      },
      "name": "Soccer",
      "updated_at": "2011-04-15T05:39:23Z"
    },
    "name": "Scottish Premiere League",
    "updated_at": "2011-04-15T05:39:23Z"
  }],
  "total_entries": 10,
  "page": 1
}