RetailHardHat Developer docs

REST API documentation

Sites

Physical site locations being developed or managed

Supported operations

MethodPathDescription
GET/api/v1/sitesList all sites
GET/api/v1/sites/:idGet a site by ID
POST/api/v1/sitesCreate a new site
PATCH/api/v1/sites/:idUpdate a site
DELETE/api/v1/sites/:idDelete a site

Example request

Replace YOUR_API_KEY with a private key stored in your environment. Replace path parameters with records from your organization.

curl --request GET "/api/v1/sites" \
  --header "Authorization: Bearer YOUR_API_KEY" \
  --header "Accept: application/json"

Field reference

Required means required by the underlying data model, not necessarily caller-supplied. The server derives protected identity and ownership fields; endpoint validation controls which fields are accepted. Sensitive credential fields are omitted here.

FieldTypeModel requirementDescription
idstringOptionalUnique identifier (auto-generated)
namestringRequiredname
siteNumberstringOptionalsite Number
addressstringRequiredaddress
citystringOptionalcity
statestringOptionalstate
zipCodestringOptionalzip Code
regionstringOptionalregion
latitudenumberOptionallatitude
longitudenumberOptionallongitude
phaseIduuidOptionalphase Id

Related resource: phases

statusenumOptionalstatus

Values: active, under_review, on_hold, completed, cancelled

scorenumberOptionalscore
acquisitionTypeenumOptionalacquisition Type

Values: lease, purchase

projectTypestringOptionalproject Type
projectStartDatedatetimeOptionalproject Start Date
targetOpeningDatedatetimeOptionaltarget Opening Date
demographicsjsonOptionaldemographics
financialsjsonOptionalfinancials
detailsjsonOptionaldetails
landlordContactIduuidOptionallandlord Contact Id
sourceDealIduuidOptionalsource Deal Id

Related resource: deals

dealTransferNotesstringOptionaldeal Transfer Notes
dealTransferredAtdatetimeOptionaldeal Transferred At
credentialcampLocationIduuidOptionalcredentialcamp Location Id
smartshiftsLocationIduuidOptionalsmartshifts Location Id
quipassistLocationIduuidOptionalquipassist Location Id
incidentvaultLocationIduuidOptionalincidentvault Location Id
policytrakLocationIduuidOptionalpolicytrak Location Id
leasecommandLocationIduuidOptionalleasecommand Location Id
lastAppliedPurchaseTemplateIduuidOptionallast Applied Purchase Template Id
lastAppliedPurchaseTemplateAtdatetimeOptionallast Applied Purchase Template At
projectLeadIduuidOptionalproject Lead Id
classificationenumOptionalclassification

Values: public, internal, confidential, restricted

createdAtdatetimeOptionalCreation timestamp (auto)
updatedAtdatetimeOptionalLast update timestamp (auto)