Returns a single client identified by its integer ID.

Response

Status: 200 OK

<?xml version="1.0" encoding="UTF-8"?>
<client>
  <account-id type="integer">1</account-id>
  <id type="integer">1</id>
  <created-at type="datetime">2012-05-18T10:00:00Z</created-at>
  <updated-at type="datetime">2012-05-18T11:00:00Z</updated-at>
  <address1 nil="true"></address1>
  <address2 nil="true"></address2>
  <city nil="true"></city>
  <country-code nil="true"></country-code>
  <state nil="true"></state>
  <zip nil="true"></zip>
  <email nil="true"></email>
  <fax nil="true"></fax>
  <fullname>S&#233;bastien Grosjean</fullname>
  <mobile nil="true"></mobile>
  <phone nil="true"></phone>
  <notes nil="true"></notes>
</client>

Returns a list of all clients. A default of maximum 50 clients is returned per page, ordered by fullname, then creation date.

Parameters

• page. Optional. Specifies the page of clients to retrieve. (default: 1)
  • Example: https://www.bookingsync.com/clients.xml?page=2
• per_page. Optional. Specifies the maximum number of clients to return per page. (default: 50, maximum: 500)
  • Example: https://www.bookingsync.com/clients.xml?per_page=500

Response

Status: 200 OK

<?xml version="1.0" encoding="UTF-8"?>
<clients type="array">
  <client>
    ...
  </client>
  <client>
    ...
  </client>
  ...
</clients>

Creates a new client. The XML for the new client is returned on a successful request with the timestamps recorded.

If the account doesn’t allow for more clients to be created, a “507 Insufficient Storage” response will be returned.

Request

<?xml version="1.0" encoding="UTF-8"?>
<client>
  <fullname>Sébastien Grosjean</firstname>
</client>

Response

Status: 201 Created
Location: https://www.bookingsync.com/clients/#{new-client-id}.xml

<?xml version="1.0" encoding="UTF-8"?>
<client>
  <account-id type="integer">1</account-id>
  <id type="integer">1</id>
  <created-at type="datetime">2012-05-18T22:01:45Z</created-at>
  <updated-at type="datetime">2012-05-18T22:01:45Z</updated-at>
  <address1 nil="true"></address1>
  <address2 nil="true"></address2>
  <city nil="true"></city>
  <country-code nil="true"></country-code>
  <state nil="true"></state>
  <zip nil="true"></zip>
  <email nil="true"></email>
  <fax nil="true"></fax>
  <fullname>S&#233;bastien Grosjean</fullname>
  <mobile nil="true"></mobile>
  <phone nil="true"></phone>
  <notes nil="true"></notes>
</client>

Updates an existing client with new details from the submitted XML.

Request

<?xml version="1.0" encoding="UTF-8"?>
<client>
  <address1>Villa Sivota</address1>
</client>

Response

Status: 200 OK

Destroys the client identified by its integer ID.

Response

Status: 200 OK