Returns an existing company.
Status: 200 OK
<company>
<id type="integer">1</id>
<name>Doe Inc.</name>
<background>A popular company for random data</background>
<created-at type="datetime">2007-02-27T03:11:52Z</created-at>
<updated-at type="datetime">2007-03-10T15:11:52Z</updated-at>
<visible-to>Everyone</visible-to>
<owner-id type="integer"></owner-id>
<group-id type="integer"></group-id>
<author-id type="integer">2</author-id>
<contact-data>
<email-addresses>
<email-address>
<id type="integer">1</id>
<address>corporate@example.com</address>
<location>Work</location>
</email-address>
</email-addresses>
<phone-numbers>
<phone-number>
<id type="integer">2</id>
<number>555-555-5555</number>
<location>Work</location>
</phone-number>
<phone-number>
<id type="integer">3</id>
<number>555-666-6667</number>
<location>Fax</location>
</phone-number>
</phone-numbers>
</contact-data>
</company>
Returns a collection of companies that are visible to the authenticated user. The list is paginated using offsets. If 50 elements are returned (the page limit), use ?n=50 to check for the next 50 and so on.
Status: 200 OK
<companies>
<company>
...
</company>
<company>
...
</company>
</companies>
Returns a collection of companies that has a specific tag. Uses pagination like List All. If no companies with that tag exist, an empty companies container will be returned.
Status: 200 OK
<companies>
<company>
...
</company>
<company>
...
</company>
</companies>
Returns a collection of companies that has a name matching the term passed in through the URL. Uses pagination like List All. If no companies with that tag exist, an empty companies container will be returned.
Status: 200 OK
<companies>
<company>
...
<name>Apple Inc</name>
</company>
<company>
...
<name>Apple Music</name>
</company>
</companies>
Returns a collection of companies that has been created or updated since the time passed in through the URL. The since parameter should be in the yyyymmddhhmmss format and in UTC. Uses pagination like List All.
Status: 200 OK
<companies>
<company>
...
<updated-at>2007-04-26T13:12:52Z</updated-at>
</company>
<company>
...
<updated-at>2007-04-25T17:11:52Z</updated-at>
</company>
</companies>
Creates a new company with the currently authenticated user as the author. The XML for the new company is returned on a successful request with the timestamps recorded and ids for the contact data associated. By default, a new company is assumed to be visible to Everyone. You can also chose to make the company only visible to the creator using "Owner" as the value for the visible-to tag. Or "NamedGroup" and pass in a group-id tag too. As always, the URL for the newly-created company is passed back in the Location header.
<company>
<name>Doe Inc.</name>
<background>A popular company for random data</background>
<visible-to>Owner</visible-to>
<contact-data>
<email-addresses>
<email-address>
<id type="integer">1</id>
<address>corporate@example.com</address>
<location>Work</location>
</email-address>
</email-addresses>
<phone-numbers>
<phone-number>
<id type="integer">2</id>
<number>555-555-5555</number>
<location>Work</location>
</phone-number>
<phone-number>
<id type="integer">3</id>
<number>555-666-6667</number>
<location>Fax</location>
</phone-number>
</phone-numbers>
</contact-data>
</company>
Status: 201 Created
Location: http://example.highrisehq.com/companies/#{new-company-id}.xml
<company>
...
</company>
Updates an existing company with new details from the submitted XML. Contact data that includes an id will be updated, contact data that doesn't will be assumed to be new and created from scratch.
<company>
<id type="integer">1</id>
<name>Doe Inc.</name>
<background>A popular company for random data</background>
<contact-data>
<email-addresses>
<email-address>
<id type="integer">1</id>
<address>corporate@example.com</address>
<location>Work</location>
</email-address>
</email-addresses>
<phone-numbers>
<phone-number>
<id type="integer">2</id>
<number>555-555-5555</number>
<location>Work</location>
</phone-number>
<phone-number>
<id type="integer">3</id>
<number>555-666-6667</number>
<location>Fax</location>
</phone-number>
<phone-number>
<number>555-666-6668</number>
<location>Home</location>
</phone-number>
</phone-numbers>
</contact-data>
</company>
Status: 200 OK
Destroys the company at the referenced URL.
Status: 200 OK