Locations API Endpoint

Write Call

Using POST Calls

POST requests will ignore parameters supplied as a query string and need any additional parameters in the request Body.
To configure the number of Pages/Results returned by the API (this is most useful for the SQL Endpoint), you can send these as additional Parameter's in the Body.
Parameter
Data Type
Default
Description
limit
Interger
20
Number of listings to show.
page
Interger
1
Page number to show.
API fields are not case sensitive, and will always be returned in the lower case format.

UDF parameters are all lower case when processed by PCR-360. Since Organizations can create their own UDF fields, the generic use of IDENTIFIER is used as a placeholder for actual UDF Identifiers.

Location Fields

Name	Type	Available Values	Default Value	Required
location_recid	integer		ADD_NEW	UPDATE
status	boolean	1, 0	1
parent_location_recid	integer		NULL
location_type_recid	integer	LOCATION_TYPE LIST RECID		INSERT
location_type	text	LOCATION_TYPE LIST CODE		INSERT
latitude	float		NULL
longitude	float		NULL
warehouse	boolean	1, 0	0
report_911	boolean	1, 0	0
default_warehouse_recid	integer		NULL
default_return_warehouse_recid	integer		NULL

Location Address Fields

Per the form, these will NOT be required.

Name	Type	Available Values	Default Value	Required
type *Type is required but all location field may also be provided.	text	ADDRESS		YES
building_id	text		NULL
community_name	text		NULL

street_address	text		NULL
address2	text		NULL
city	text		NULL
state	text	*Country Dependent State abbreviation or name	NULL
zip_code	text	*Country Dependent	NULL
country	text	ADDRESS_COUNTIES LIST CODE	NULL
E911 Fields
house_number	text		NULL
house_suffix	text		NULL
prefix_directional	text		NULL
street_name	text		NULL
street_suffix	text		NULL
post_directional	text		NULL

Location Contact Fields

Name	Type	Available Values	Required
type	text	CONTACT	YES
location_recid	integer		INSERT
contact_recid	integer		INSERT

Location Servicing Equipment Fields

Name	Type	Available Values	Required
type	text	SERVICING_EQUIPMENT	YES
location_recid	integer		INSERT, UPDATE
service_catalog_recid	integer		INSERT
equipment_recid	integer		INSERT

Location Service Host Permission Fields

Name	Type	Available Values	Required
type	text	SERVICE_HOST	YES
location_recid	integer		INSERT
service_host_recid	integer		INSERT

Location Worker Permission Fields

Name	Type	Available Values	Required
type	text	WORKER	YES
location_recid	integer		INSERT
contact_recid	integer		INSERT

Location Remark Fields

Name	Type	Available Values	Required
type	text	REMARK	YES
location_recid	integer		INSERT
remark	text		INSERT
author_contact_recid	integer		NON-AUTH-KEYS

Location UDF Fields

Name	Type	Available Values	Required
type	text	UDF	YES
location_recid	integer		YES
udf_UDF-RECID	custom
udf_UDF-IDENTIFIER	custom

Location Attachment Fields

Name	Type	Available Values	Required
type	text	ATTACHMENT	YES
location_recid	integer		INSERT
filename	text		INSERT
data	base64 encoded		INSERT

Parameter	Data Type	Default	Description
limit	Interger	20	Number of listings to show.
page	Interger	1	Page number to show.