Field Squared API Services

Contact

Represents a DTO for a contact in a workspace. Calls without an ObjectId will retrieve an array of all active contact objects for the workspace.
A call to /{Workspace}/ContactTasks/{ObjectId} will return a List<DomainItem> for the list of tasks associated to the contact.
A core or custom sort field can be specified by using sort=fieldname&sortorder=ascending/descending.
To filter for contacts based on full text search, use fulltext
Custom contact field 'contains' filters can also be specified by using the binding/key as the query parameter. i.e. Comments=Quick Brown Fox.
To filter and return all contacts modified since a date and time, use the query parameter modifiedsince = X where X = YYYY-MM-DDTHH:MM:SSZ
To filter and return all contacts deleted since a date and time, use the query parameter deletedsince = X where X = YYYY-MM-DDTHH:MM:SSZ. Note only Object ID, Workspace and Version is populated.
Spatial extents can be passed in using: bottomleft=Lat,Lon&topright=Lat,Lon.
To filter on tasks inside a boundary, use boundary=Lat,Lon,Lat,Lon etc.
Pagination - /{0}/ContactList?recstart=0&reccount=1
/{Workspace}/ContactList/Count returns a count, not the actual object list

The following routes are available for this service:
GET,POST,PUT,DELETE	/{Workspace}/Contact/{ObjectId}
GET	/{Workspace}/Contact
GET	/{Workspace}/ContactList
GET	/{Workspace}/ContactList/Count
GET	/{Workspace}/ContactTasks/{ObjectId}

**Contact** Parameters:
Name	Parameter	Data Type	Required
Workspace	path	string	No
ObjectId	path	string	No
TimeZone	body	string	No
VersionId	body	string	No
BasedOn	body	string	No
ExternalId	body	string	No
ContactName	body	string	No
Company	body	string	No
MobilePhone	body	string	No
WorkPhone	body	string	No
HomePhone	body	string	No
Email	body	string	No
SMS	body	bool	No
Address	body	Address	No
Enabled	body	bool	No
POI	body	bool	No
EmailSiteDriving	body	bool	No
ServiceAddresses	body	List<Address>	No
Documents	body	List<DomainItem>	No
Data	body	Dictionary<string, string>	No
Owner	body	ClassedItem	No
Tasks	body	List<string>	No
Assets	body	List<string>	No
Contacts	body	List<string>	No
Events	body	List<EventItem>	No
Teams	body	List<string>	No
Created	body	string	No
LastUpdated	body	string	No
CreatedBy	body	string	No
ActiveLaborTypes	body	Dictionary<string, Object>	No

**Address** Parameters:
Name	Parameter	Data Type	Required
Street	form	string	No
Unit	form	string	No
City	form	string	No
State	form	string	No
Zip	form	string	No
ContactTitle	form	string	No
ContactName	form	string	No
ContactPhone	form	string	No
ContactEmail	form	string	No
Location	form	Location	No
SiteName	form	string	No
GeocodeFailed	form	bool	No
Country	form	string	No

**Location** Parameters:
Name	Parameter	Data Type	Required	Description
y	form	double	No
x	form	double	No

**DomainItem** Parameters:
Name	Parameter	Data Type	Required
Workspace	form	string	No
ObjectId	form	string	No
VersionId	form	string	No
LastUpdated	form	string	No

**ClassedItem** Parameters:
Name	Parameter	Data Type	Required
ObjectId	form	string	No
Class	form	string	No
VersionId	form	string	No
Ancestors	form	List<string>	No
Type	form	string	No

**EventItem** Parameters:
Name	Parameter	Data Type	Required
ObjectId	form	string	No
Date	form	string	No
Location	form	Location	No
Barcode	form	string	No
Details	form	string	No
Type	form	string	No
IsScan	form	bool	No
User	form	string	No
SelectedBy	form	string	No
Status	form	string	No
StatusType	form	string	No
DateCreated	form	string	No
Automatic	form	bool	No

To override the Content-type in your clients, use the HTTP Accept Header, append the .jsv suffix or ?format=jsv

HTTP + JSV

The following are sample HTTP requests and responses. The placeholders shown need to be replaced with actual values.

POST /{Workspace}/Contact/{ObjectId} HTTP/1.1 
Host: dev.fieldsquared.com 
Accept: text/jsv
Content-Type: text/jsv
Content-Length: length

{
	Workspace: String,
	ObjectId: String,
	TimeZone: String,
	VersionId: String,
	BasedOn: String,
	ExternalId: String,
	ContactName: String,
	Company: String,
	MobilePhone: String,
	WorkPhone: String,
	HomePhone: String,
	Email: String,
	SMS: False,
	Address: 
	{
		Street: String,
		Unit: String,
		City: String,
		State: String,
		Zip: String,
		ContactTitle: String,
		ContactName: String,
		ContactPhone: String,
		ContactEmail: String,
		Location: 
		{
			y: 0,
			x: 0
		},
		SiteName: String,
		GeocodeFailed: False,
		Country: String
	},
	Enabled: False,
	POI: False,
	EmailSiteDriving: False,
	ServiceAddresses: 
	[
		{
			Street: String,
			Unit: String,
			City: String,
			State: String,
			Zip: String,
			ContactTitle: String,
			ContactName: String,
			ContactPhone: String,
			ContactEmail: String,
			Location: 
			{
				y: 0,
				x: 0
			},
			SiteName: String,
			GeocodeFailed: False,
			Country: String
		}
	],
	Documents: 
	[
		{
			Workspace: String,
			ObjectId: String,
			VersionId: String,
			LastUpdated: String
		}
	],
	Data: 
	{
		String: String
	},
	Owner: 
	{
		ObjectId: String,
		Class: String,
		VersionId: String,
		Ancestors: 
		[
			String
		],
		Type: String
	},
	Tasks: 
	[
		String
	],
	Assets: 
	[
		String
	],
	Contacts: 
	[
		String
	],
	Events: 
	[
		{
			ObjectId: String,
			Date: String,
			Location: 
			{
				y: 0,
				x: 0
			},
			Barcode: String,
			Details: String,
			Type: String,
			IsScan: False,
			User: String,
			SelectedBy: String,
			Status: String,
			StatusType: String,
			DateCreated: String,
			Automatic: False
		}
	],
	Teams: 
	[
		String
	],
	Created: String,
	LastUpdated: String,
	CreatedBy: String,
	ActiveLaborTypes: 
	{
		String: {}
	}
}