Organizations

xmlapi/organizations.xml
jsonapi/organizations.json

Parameter

Type

Description

[IN] Parameters described in Overview

View

Integer

[IN] View to use to filter organizations

Company

String

[IN] The company number(s)

Client-Code

String

[IN] (Optional) Organization primary key

Search

String

[IN] (Optional) Search string to use

Response

XML or JSON

[OUT] XML or JSON containing organizations the user has access to.

Description

The Organizations call retrieves a list of organizations within the specified view and company the user has access to.

Parameters

  • View – The numeric primary ID key of the view required (See Views)
  • Company – The company number(s) which contain the list required. If passing multiple company numbers, they should be delimited with a carriage return.
  • Client-Code – The primary key to return just 1 record
  • Search – String to use to search for records. This is a compound & fuzzy (phonetic) search.

Return Values

Response – XML or JSON containing the list of organizations.

The structure of the response is:

<Organizations  TotalRows=nnn TotalPages=nnn MorePages=True/False>
  <Organization uuid=`{UUID of record}`}>
    <Client-Code>    Alpha Primary key e.g. 1/P9887 or 1/ACME
    <Client-Name>    Organization name
    <Street>      Address line 1
    <Address1>    Address line 2
    <Address2>    Town
    <County>      County
    <Postcode>    Postcode
    <Country>     Country
    <Phone>       Telephone number
    <Fax>         Fax number
    <WebURL>      WWW address
    <Client-Desc>   Notes
    <Category-Name>   “Lead”, “Prospect” or “Client”
    <Inactive>    True/False
    <Client-Type>   Client type
    <Market-Sector>  Market Sector
    <Lead-Rating>    Lead Rating
    <Employees>    Number of employees
    <OP-Status>    Status/Grade
    <Custom-Fields>
      <Custom-Label-1>  Actual Field Label will be an attribute
      <Custom-Label-2>        ...