Get Merchant Underwriting Status History

Returns the complete history of underwriting status changes for a specific merchant, ordered chronologically. Each entry in the history represents a single status transition, including the application status, the UW pipeline status, the timestamp, comments recorded at the time, and the underwriter responsible. This provides a full audit trail of the merchant's progress through the underwriting process.

Endpoint

GET /api/v1/underwriting/status-history

Authentication

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

Authorization: Basic {base64(username:password)}

When to use

Use this endpoint when you need a detailed timeline of a merchant's underwriting journey — for example, to understand why an application was declined, to confirm when a particular status change occurred for compliance purposes, or to troubleshoot a merchant application that has stalled. Unlike GET /api/v1/underwriting/statuses which returns only the current state, this endpoint returns every historical transition.

Query Parameters

Response

200 OK

Returns an array of UnderwritingStatusModel objects in chronological order (earliest first).

[
  {
    "merchantProfileId": 48201,
    "merchantId": "MID-887241",
    "status": "New",
    "underwritingStatus": "Initialized",
    "lastUpdate": "2026-04-01T08:00:00Z",
    "comment": "Application created.",
    "underwriter": null
  },
  {
    "merchantProfileId": 48201,
    "merchantId": "MID-887241",
    "status": "Pending",
    "underwritingStatus": "Pending",
    "lastUpdate": "2026-04-15T11:30:00Z",
    "comment": "Submitted to TSYS. Awaiting UW review.",
    "underwriter": "Sarah Thompson"
  },
  {
    "merchantProfileId": 48201,
    "merchantId": "MID-887241",
    "status": "UnderReview",
    "underwritingStatus": "Pending",
    "lastUpdate": "2026-05-10T09:15:00Z",
    "comment": "Driver's license and bank statements required.",
    "underwriter": "Sarah Thompson"
  },
  {
    "merchantProfileId": 48201,
    "merchantId": "MID-887241",
    "status": "PendingReview",
    "underwritingStatus": "PendingReview",
    "lastUpdate": "2026-05-20T14:45:00Z",
    "comment": "Uploaded driver's license and 3 months of bank statements.",
    "underwriter": "Sarah Thompson"
  }
]

Error Codes

Common Mistakes

• Using this endpoint to get the current status when GET /api/v1/underwriting/statuses is more appropriate for portfolio-wide monitoring.
• Assuming entries are always returned newest-first — parse the lastUpdate field to determine order rather than relying on array position.
• Expecting this to show UW task ticket activity — this endpoint tracks merchant-level status changes only, not the granular ticket-level history.

Related Endpoints

• GET /api/v1/underwriting/statuses — get the current status for all merchants (no id required)
• POST /api/v1/underwriting/pending-review — trigger a PendingReview status transition
• GET /api/v1/merchant/getAutoUwResults — see automated check results that may have influenced status changes

Example

curl -X GET "https://hq.staging.netevia.dev/api/v1/underwriting/status-history?id=48201" \
  -H "Authorization: Basic $(echo -n 'username:password' | base64)"