This URI gives you access to the categories to which the specified contact belongs.

Use the following URI to get all of the categories for a contact identified by the {cid} value. To obtain the {cid} value, run the HTTP GET operation to obtain a Contact Object. See the Contacts section for details.

For example, suppose that Pete (identified by {guid}) has an address book with multiple categories. Some of the categories have an entry for Sam (he's uniquely identified by {cid}). This would occur if, for example, Sam is a member of the Football as well as College Friends categories. In that case, the URI points to those two categories in Pete's address book since each one contains an entry for Sam. To use the URI below you would need your own GUID and Sam's CID.

If the HTTP GET operation succeeds, the call responds with a collection of Category Objects. The Example JSON Body for GET Categories shows the structure of the collection as an array of Category Objects.

http://social.yahooapis.com/v1/user/{guid}/contact/{cid}/categories

Not available.

When you make a JSON request for a collection of categories, the information will be returned as an array of Category Objects.

See also JSON Body For GET Categories By CID.

See also Example XML Response Body for GET Categories.

The following sample responses show what two categories would look like. The responses reveal that the particular contact (uniquely identified by CID 5) is a member of the two categories BookClub and Clowns. If there were any more categories (for example, RingMasters, ShowGirls, Acrobats), they would be added to the category array of blocks just as BookClub and Clowns are laid out. The total number of categories is the value of the total field.