--- updatedAt: 2026-06-09T17:02:17.000Z --- Fetch the complete documentation index at: https://hq.docs.netevia.com/llms.txt. Use this file to discover all available pages before exploring further. # Update merchant's site inspection ## 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`. | ```json { "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. | ```json { "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 ```bash 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" } }' ``` # OpenAPI definition ```json { "openapi": "3.0.0", "info": { "version": "v1", "title": "Netevia HQ | API Documentation", "description": "Netevia HQ | API Documentation" }, "paths": { "/api/v1/merchant/siteInspection": { "post": { "tags": [ "Merchant applications/Merchants data management" ], "summary": "Update merchant's site inspection", "operationId": "Boarding_UpdateSiteInspection", "requestBody": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/UpdateTsysSiteInspection" } }, "text/json": { "schema": { "$ref": "#/components/schemas/UpdateTsysSiteInspection" } }, "application/xml": { "schema": { "$ref": "#/components/schemas/UpdateTsysSiteInspection" } }, "text/xml": { "schema": { "$ref": "#/components/schemas/UpdateTsysSiteInspection" } }, "application/x-www-form-urlencoded": { "schema": { "$ref": "#/components/schemas/UpdateTsysSiteInspection" } } }, "required": true }, "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiResponse1_UpdateMerchantResponse" } }, "text/json": { "schema": { "$ref": "#/components/schemas/ApiResponse1_UpdateMerchantResponse" } }, "application/xml": { "schema": { "$ref": "#/components/schemas/ApiResponse1_UpdateMerchantResponse" } }, "text/xml": { "schema": { "$ref": "#/components/schemas/ApiResponse1_UpdateMerchantResponse" } } } } } } } }, "security": [ { "Basic": [] } ], "servers": [ { "url": "https://hq.staging.netevia.dev" } ], "components": { "securitySchemes": { "Basic": { "type": "http", "description": "Basic HTTP Authentication", "scheme": "basic" } }, "schemas": { "ValidationResult": { "type": "object", "properties": { "memberNames": { "type": "array", "items": { "type": "string" }, "readOnly": true }, "errorMessage": { "type": "string" } } }, "TsysSiteInspection": { "type": "object", "properties": { "inventoryMaintainedType": { "enum": [ "OnSite", "WarehouseOffSite", "FulfillmentCenter" ], "type": "string" }, "fulfillmentCenterNameAndAddress": { "type": "string" }, "question1": { "type": "boolean" }, "question1Explanation": { "type": "string" }, "question2": { "type": "boolean" }, "question2Explanation": { "type": "string" }, "question3": { "type": "boolean" }, "question3Explanation": { "type": "string" }, "question4": { "type": "boolean" }, "question4Explanation": { "type": "string" }, "zoning": { "enum": [ "Comml", "Industrial", "Residential" ], "type": "string" }, "squareFootageType": { "enum": [ "From_0_To_500", "From_501_To_1000", "From_1001_To_2000", "From_2001_To_4000", "Other" ], "type": "string" }, "squareFootageTypeOther": { "format": "int32", "type": "integer" }, "merchant": { "enum": [ "Owns", "Leases" ], "type": "string" }, "nameAddressLandlord": { "type": "string" } } }, "ApiResponse1_UpdateMerchantResponse": { "type": "object", "properties": { "data": { "$ref": "#/components/schemas/UpdateMerchantResponse" }, "status": { "enum": [ "Continue", "SwitchingProtocols", "OK", "Created", "Accepted", "NonAuthoritativeInformation", "NoContent", "ResetContent", "PartialContent", "MultipleChoices", "Ambiguous", "MovedPermanently", "Moved", "Found", "Redirect", "SeeOther", "RedirectMethod", "NotModified", "UseProxy", "Unused", "TemporaryRedirect", "RedirectKeepVerb", "BadRequest", "Unauthorized", "PaymentRequired", "Forbidden", "NotFound", "MethodNotAllowed", "NotAcceptable", "ProxyAuthenticationRequired", "RequestTimeout", "Conflict", "Gone", "LengthRequired", "PreconditionFailed", "RequestEntityTooLarge", "RequestUriTooLong", "UnsupportedMediaType", "RequestedRangeNotSatisfiable", "ExpectationFailed", "UpgradeRequired", "InternalServerError", "NotImplemented", "BadGateway", "ServiceUnavailable", "GatewayTimeout", "HttpVersionNotSupported" ], "type": "string" }, "error": { "type": "string" }, "warning": { "type": "string" }, "validationResults": { "type": "array", "items": { "$ref": "#/components/schemas/ValidationResult" } }, "requestId": { "format": "int32", "type": "integer" } } }, "UpdateMerchantResponse": { "type": "object", "properties": {} }, "UpdateTsysSiteInspection": { "required": [ "id" ], "type": "object", "properties": { "siteInspection": { "$ref": "#/components/schemas/TsysSiteInspection" }, "id": { "format": "int32", "maximum": 999999, "minimum": 1, "type": "integer" } } } } } } ```