Retrieve Notes for the Merchant Application

Fetches all notes that have been recorded against a merchant's application during the onboarding or review process. Each note includes the author, the note text, and the date it was created. Notes provide an audit trail of interactions, observations, or decisions made by the ISO or underwriting team throughout the merchant lifecycle.

Endpoint

GET /api/v1/merchant/notes

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 to display the history of internal comments and updates attached to a merchant application. This is particularly useful during underwriting review or when a support agent needs to understand prior decisions or context for a merchant record.

Query Parameters

Response

200 OK

{
  "data": [
    {
      "text": "Application received and initial review completed. Missing bank statement — contacted merchant.",
      "author": "jsmith",
      "date": "2026-04-15T10:23:00Z"
    },
    {
      "text": "Bank statement uploaded by merchant. Forwarding to underwriting.",
      "author": "alopez",
      "date": "2026-04-17T14:05:00Z"
    }
  ],
  "status": "OK",
  "error": null,
  "warning": null,
  "validationResults": [],
  "requestId": 55102
}

Error Codes

Common Mistakes

• Providing a non-integer value for id — this parameter must be a numeric merchant application ID.
• Expecting paginated results — this endpoint returns all notes at once; there is no page or limit parameter.
• Confusing this endpoint with the underwriting notes endpoint (/api/v1/merchant/getUnderwritingNotes), which is specific to underwriting-related observations.

Related Endpoints

• POST /api/v1/merchant/addNote — add a new note to a merchant application
• GET /api/v1/merchant/getUnderwritingNotes — retrieve underwriting-specific notes
• GET /api/v1/merchant/status — check the current status of the merchant application

Example

curl -X GET "https://hq.staging.netevia.dev/api/v1/merchant/notes?id=10045" \
  -H "Authorization: Basic $(echo -n 'username:password' | base64)" \
  -H "Accept: application/json"