Description

Retrieve a list of watches of a particular Brand and/or Family.

Optionally, an extra date parameter can be provided, to limit the list to only those watch entries created or modified after a given date. This can be useful to check for updates.

URL

https://api.watchbase.com/v1/watches

Parameters

key Your WatchBase API Key
format (optional) Possible values: xml, json. Defaults to: xml
brand-id BrandID of the brand you wish to list the watches for
family-id (optional) FamilyID of the family you wish to list the watches for. If left empty, all watches within the given brand will be listed
updated-since (optional) limit the returned watch list to all watch entries created or modified after the given date. Format: yyyy-mm-dd

Output

List of watches of the given brand (and family), optionally limited by the updated-since parameter.

Example API Call

Show all SevenFriday watches, in their M-Series family (BrandID = 37, FamilyID = 279).

Click to see the output:
https://api.watchbase.com/v1/watches?brand-id=37&family-id=279&key=B4PMCSMEXeGo1c0Lpk5HmEQw2bKhSqaIwzhuJ9cy

Example output


<?xml version="1.0" encoding="UTF-8"?>
<response>
	<num_results>4</num_results>
	<watches>
		<watch>
			<id>11702</id>
			<refnr>M1</refnr>
			<name>M1</name>
			<brand>
				<id>37</id>
				<name>SevenFriday</name>
			</brand>
			<family>
				<id>279</id>
				<name>M-Series</name>
			</family>
			<thumb>http://cdn.watchbase.com/watch/medium/sevenfriday/m-series/m1-19.png</thumb>
			<updated>2016-02-25</updated>
		</watch>
		<watch>
			<id>11703</id>
			<refnr>M2</refnr>
			<name>M2</name>
			<brand>
				<id>37</id>
				<name>SevenFriday</name>
			</brand>
			<family>
				<id>279</id>
				<name>M-Series</name>
			</family>
			<thumb>http://cdn.watchbase.com/watch/medium/sevenfriday/none/m2-80.jpg</thumb>
			<updated>2016-02-25</updated>
		</watch>
		<watch>
			<id>16625</id>
			<refnr>M2-2</refnr>
			<name>M2-2</name>
			<brand>
				<id>37</id>
				<name>SevenFriday</name>
			</brand>
			<family>
				<id>279</id>
				<name>M-Series</name>
			</family>
			<thumb>http://cdn.watchbase.com/watch/medium/sevenfriday/m-series/m2-2-77.png</thumb>
			<updated>2015-08-08</updated>
		</watch>
		<watch>
			<id>16626</id>
			<refnr>M2 Boom</refnr>
			<name>M2 Boom</name>
			<brand>
				<id>37</id>
				<name>SevenFriday</name>
			</brand>
			<family>
				<id>279</id>
				<name>M-Series</name>
			</family>
			<thumb>http://cdn.watchbase.com/watch/medium/sevenfriday/m-series/m2-boom-9c.jpg</thumb>
			<updated>2015-08-08</updated>
		</watch>
	</watches>
</response>

Need more help with this?
Don’t hesitate to contact us here.

Was this helpful?

Yes No
You indicated this topic was not helpful to you ...
Could you please leave a comment telling us why? Thank you!
Thanks for your feedback.