Update merchant's site inspection

Recent Requests
Log in to see full request history
TimeStatusUser Agent
Retrieving recent requests…
LoadingLoading…

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

FieldTypeRequiredDescription
idinteger (int32)YesMerchant profile ID to update (1–999999).
siteInspectionobjectNoSite inspection data to update.
siteInspection.inventoryMaintainedTypestringNoHow inventory is stored. Enum: OnSite, WarehouseOffSite, FulfillmentCenter.
siteInspection.fulfillmentCenterNameAndAddressstringNoName and address of fulfillment center, required if inventoryMaintainedType is FulfillmentCenter.
siteInspection.question1booleanNoAnswer to compliance question 1 (business operational status).
siteInspection.question1ExplanationstringNoExplanation if question1 is true.
siteInspection.question2booleanNoAnswer to compliance question 2 (prior merchant account terminations).
siteInspection.question2ExplanationstringNoExplanation if question2 is true.
siteInspection.question3booleanNoAnswer to compliance question 3 (bankruptcy or legal proceedings).
siteInspection.question3ExplanationstringNoExplanation if question3 is true.
siteInspection.question4booleanNoAnswer to compliance question 4 (prior felony convictions).
siteInspection.question4ExplanationstringNoExplanation if question4 is true.
siteInspection.zoningstringNoZoning classification of the business location. Enum: Comml, Industrial, Residential.
siteInspection.squareFootageTypestringNoApproximate business square footage range. Enum: From_0_To_500, From_501_To_1000, From_1001_To_2000, From_2001_To_4000, Other.
siteInspection.squareFootageTypeOtherintegerNoExact square footage if squareFootageType is Other.
siteInspection.merchantstringNoWhether the merchant owns or leases the location. Enum: Owns, Leases.
siteInspection.nameAddressLandlordstringNoName 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

FieldTypeDescription
dataobjectEmpty object on success.
statusstringHTTP status name (e.g., "OK").
errorstringError message if the update failed; otherwise null.
warningstringNon-fatal warning, if any.
validationResultsarrayField-level validation errors, if any.
requestIdintegerInternal request tracking ID.
{
  "data": {},
  "status": "OK",
  "error": null,
  "warning": null,
  "validationResults": [],
  "requestId": 47813
}

Error Codes

CodeWhen it happens
400id is missing or out of range; or an enum field receives an invalid value.
401Invalid or missing Basic Auth credentials.
403User does not have permission to update this merchant application.
404No merchant application found with the given ID.
500Internal 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"
    }
  }'
Body Params
siteInspection
object
int32
required
1 to 999999
Headers
string
enum
Defaults to application/json

Generated from available response content types

Allowed:
string
enum
Defaults to application/json

Generated from available request content types

Allowed:
Response

Language
Credentials
Basic
base64
:
LoadingLoading…
Response
Click Try It! to start a request and see the response here! Or choose an example:
application/json
text/json