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