Update Site Inspection

Updates the site inspection section of an existing merchant application. Site inspection data captures physical location details — including inventory storage type, zoning classification, square footage, lease or ownership status, and four compliance screening questions — used by underwriters to verify the legitimacy and operational status of the merchant's business location.

Endpoint

POST /api/v1/merchant/siteInspection

Authentication

Basic HTTP Authentication required. Encode username:password in Base64 and pass in the Authorization header:

Authorization: Basic {base64(username:password)}

When to use

Call this endpoint to correct or update site inspection information after the initial merchant submission. This is commonly needed when a merchant moves to a new location, when the original inspection details were incomplete, or when an underwriter requests clarification on location-specific compliance questions. Accurate site inspection data is required before the application can advance through underwriting.

Request Body

Field	Type	Required	Description
id	integer (int32)	Yes	Merchant profile ID to update (1–999999).
siteInspection	object	No	Site inspection data to update.
siteInspection.inventoryMaintainedType	string	No	How inventory is stored. Enum: `OnSite`, `WarehouseOffSite`, `FulfillmentCenter`.
siteInspection.fulfillmentCenterNameAndAddress	string	No	Name and address of fulfillment center, required if `inventoryMaintainedType` is `FulfillmentCenter`.
siteInspection.question1	boolean	No	Answer to compliance question 1 (business operational status).
siteInspection.question1Explanation	string	No	Explanation if `question1` is `true`.
siteInspection.question2	boolean	No	Answer to compliance question 2 (prior merchant account terminations).
siteInspection.question2Explanation	string	No	Explanation if `question2` is `true`.
siteInspection.question3	boolean	No	Answer to compliance question 3 (bankruptcy or legal proceedings).
siteInspection.question3Explanation	string	No	Explanation if `question3` is `true`.
siteInspection.question4	boolean	No	Answer to compliance question 4 (prior felony convictions).
siteInspection.question4Explanation	string	No	Explanation if `question4` is `true`.
siteInspection.zoning	string	No	Zoning classification of the business location. Enum: `Comml`, `Industrial`, `Residential`.
siteInspection.squareFootageType	string	No	Approximate business square footage range. Enum: `From_0_To_500`, `From_501_To_1000`, `From_1001_To_2000`, `From_2001_To_4000`, `Other`.
siteInspection.squareFootageTypeOther	integer	No	Exact square footage if `squareFootageType` is `Other`.
siteInspection.merchant	string	No	Whether the merchant owns or leases the location. Enum: `Owns`, `Leases`.
siteInspection.nameAddressLandlord	string	No	Name and address of the landlord, required if `merchant` is `Leases`.

{
  "id": 10482,
  "siteInspection": {
    "inventoryMaintainedType": "OnSite",
    "question1": false,
    "question2": false,
    "question3": false,
    "question4": false,
    "zoning": "Comml",
    "squareFootageType": "From_1001_To_2000",
    "merchant": "Leases",
    "nameAddressLandlord": "Peachtree Properties Inc, 800 Corporate Blvd, Atlanta GA 30303"
  }
}

Response

200 OK

Field	Type	Description
data	object	Empty object on success.
status	string	HTTP status name (e.g., `"OK"`).
error	string	Error message if the update failed; otherwise null.
warning	string	Non-fatal warning, if any.
validationResults	array	Field-level validation errors, if any.
requestId	integer	Internal request tracking ID.

{
  "data": {},
  "status": "OK",
  "error": null,
  "warning": null,
  "validationResults": [],
  "requestId": 47813
}

Error Codes

Code	When it happens
400	`id` is missing or out of range; or an enum field receives an invalid value.
401	Invalid or missing Basic Auth credentials.
403	User does not have permission to update this merchant application.
404	No merchant application found with the given ID.
500	Internal server error.

Common Mistakes

Setting inventoryMaintainedType to FulfillmentCenter without providing fulfillmentCenterNameAndAddress — underwriters will flag this as incomplete.
Setting merchant to Leases without providing nameAddressLandlord — this information is required for compliance.
Answering true to any compliance question without providing the corresponding explanation field — always supply questionNExplanation when questionN is true.
Using incorrect enum values (e.g., "Commercial" instead of "Comml") returns a 400 validation error.

Related Endpoints

POST /api/v1/merchant/parameters — Update business and owner information.
POST /api/v1/merchant/account — Update sales and business profile.
POST /api/v1/merchant/attachment — Upload site inspection validation documents.

Example

curl -X POST https://hq.staging.netevia.dev/api/v1/merchant/siteInspection \
  -H "Authorization: Basic $(echo -n 'username:password' | base64)" \
  -H "Content-Type: application/json" \
  -d '{
    "id": 10482,
    "siteInspection": {
      "inventoryMaintainedType": "OnSite",
      "question1": false,
      "question2": false,
      "question3": false,
      "question4": false,
      "zoning": "Comml",
      "squareFootageType": "From_1001_To_2000",
      "merchant": "Leases",
      "nameAddressLandlord": "Peachtree Properties Inc, 800 Corporate Blvd, Atlanta GA 30303"
    }
  }'

200OK