- style
Affiliations
Introduction
An affiliation connects a contact to a company. A contact and company can have multiple affiliations. i.e, a contact has a many-to-many relationship company- affiliation maps this relationship.
Endpoints
METHOD | ENDPOINT | DESCRIPTION |
|---|---|---|
GET | Returns a list of Affiliations.. | |
GET | Returns the total number of affiliations. | |
GET | Returns a list of affiliations ordered by date_modified descending | |
GET | Returns an affiliation identified by its id. | |
GET | Returns an affiliation's status | |
DELETE | Removes an affiliation identified by its id. | |
POST | Creates a new affiliation. | |
PUT | Updates an affiliation identified by its id. | |
GET | Returns an array of profile values for the affiliation | |
PUT | Update an existing profile value for the affiliation | |
GET | Returns an array of available progressions for the affiliation. | |
[PUT|POST] | Runs a status update for the given progression on the given affiliation. | |
GET | Returns an array of profile fields for affiliation. | |
POST | /affiliations/:affiliation_id/profiles/fields/:profile_field_id | Creates a profile value for an affiliation. |
Filters
These values can be used to filter through lists of affiliations. You can define filters in the _filters parameter.
standing | Array of standing status strings. For example standing(inactive,active)- filter out affiliation that do not have the supplied standing. |
|---|---|
mobile | Only return affiliations matching the supplied mobile number(s). |
fax | Only return affiliations matching the supplied fax number(s). |
phone | Only return affiliations matching the supplied phone number(s). |
contact_number | Only return affiliations having a mobile, phone or fax matching one of the supplied phone numbers. |
NEW order_by_asc(<type>), order_by_desc(<type>)
| Accepts: fullname, status, standing, date_modified and date_last_interacted |
NEW <field_name>_greater_than(<value>), <field_name>_less_than(<value>), <field_name>_greater_than_or_equal(<value>), <field_name>_less_than_or_equal(<value>) | Available fields: id |
NOTE: filters will ignore whitespace and are generally whitelists.
Using the _not suffix (e.g, id_not) on standard in filters will returns results not in.