| Time | Status | User Agent | |
|---|---|---|---|
Retrieving recent requests… | |||
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
inventoryMaintainedTypetoFulfillmentCenterwithout providingfulfillmentCenterNameAndAddress— underwriters will flag this as incomplete. - Setting
merchanttoLeaseswithout providingnameAddressLandlord— this information is required for compliance. - Answering
trueto any compliance question without providing the corresponding explanation field — always supplyquestionNExplanationwhenquestionNistrue. - 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"
}
}'