PartyCategory
Version: 1.33
PartyCategory represents the Contact Category found at Setup >> Categories >> Contact Category. You can only query PartyCategory through the API. The most frequent use case for querying PartyCategory is to identify a category to use when creating a contact on an account.
Parameters
Extends: TractObject
Attribute | Required? | Datatype | Description |
name |
Y |
string |
Name of the party category. Examples: "Sales Contact" "Primary Contact" "Proprietor". |
description |
string |
Description of the party category. |
|
status |
PartyCategoryStatus |
ACTIVE CANCELED SUSPENDED |
Querying PartyCategory
For paged results, use the plural of the entity name (for example, billingAccounts, productCategories). For more information, refer to Understanding Queries.
Key | Type |
eid |
Long |
name |
String |
description |
String |
status |
ContactCategoryStatus |
REST Endpoints
getContactCategories |
GET |
https://my.tractbilling.com/t/s/r/1.33/partyCategories |
getContactCategory |
GET |
https://my.tractbilling.com/t/s/r/1.33/partyCategories/{eid: \d+} |
Sample Requests and Responses
SOAP
Query
<soap:Envelope xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/"> <soap:Body> <ns2:query xmlns="http://www.tractbilling.com/billing/1_31/domain" xmlns:ns2="http://www.tractbilling.com/billing/1_31/service"> <ns2:queryRequest> <simpleDataQuery startIndex="0" size="50"> <type>PartyCategory</type> </simpleDataQuery> </ns2:queryRequest> </ns2:query> </soap:Body> </soap:Envelope>
REST
Query
GET https://my.tractbilling.com/t/s/r/1.33/partycategories
GET https://my.tractbilling.com/t/s/r/1.33/partycategories/<eid>