Retrieve a List of User Upload Sessions

The GET /UserUploadSessions endpoint retrieves all document verification upload sessions associated with the authenticated user. Each session record includes status information, email notification tracking, and an array of individual document verification requests with their current states and linked file metadata.

This endpoint supports real-time monitoring of both ongoing and completed document upload workflows, giving partners and administrators full visibility into the document verification lifecycle.

Endpoint

GET /UserUploadSessions

Authentication

Bearer token required. Obtain via:

POST https://api.banking.netevia.dev/api/auth/v2

Include in header: Authorization: Bearer {token}
Token lifetime: 10 minutes. Refresh via POST /api/auth/refresh.

When to use

Use this endpoint when you need to display a user's document verification history or check the current state of a pending verification session. It is commonly called during onboarding flows to confirm that required documents have been uploaded and are being processed. Partners may also use it to trigger follow-up actions such as re-sending email prompts when a session has stalled.

Response

200 OK

Returns an array of documentverificationsession objects. Each object inherits base entity fields and audit fields.

Top-level session fields:

documentVerificationRequests item fields:

fileInfo object fields:

[
  {
    "id": 1042,
    "createdDate": "2025-11-03T09:15:00Z",
    "updatedDate": "2025-11-04T14:22:00Z",
    "createdBy": "system",
    "updatedBy": "admin",
    "userProfileId": 7381,
    "status": 1,
    "emailSentDate": "2025-11-03T09:16:00Z",
    "emailSentCount": 2,
    "documentVerificationRequests": [
      {
        "id": 3091,
        "createdDate": "2025-11-03T09:15:00Z",
        "updatedDate": "2025-11-04T10:05:00Z",
        "createdBy": "system",
        "updatedBy": null,
        "documentVerificationSessionId": 1042,
        "group": 1,
        "documentType": 3,
        "customDocumentType": null,
        "requirement": 1,
        "innerStatus": 1,
        "fileInfoId": 8820,
        "fileInfo": {
          "id": 8820,
          "filePath": "/uploads/7381/drivers_license.jpg",
          "userProfileId": 7381,
          "fileType": "DriverLicense",
          "contentType": "image/jpeg",
          "createdAt": "2025-11-04T10:05:00Z"
        }
      },
      {
        "id": 3092,
        "createdDate": "2025-11-03T09:15:00Z",
        "updatedDate": null,
        "createdBy": "system",
        "updatedBy": null,
        "documentVerificationSessionId": 1042,
        "group": 2,
        "documentType": 7,
        "customDocumentType": null,
        "requirement": 1,
        "innerStatus": 0,
        "fileInfoId": null,
        "fileInfo": null
      }
    ]
  }
]

Error Codes

Common Mistakes

• Forgetting to refresh the Bearer token before calling this endpoint — tokens expire after 10 minutes and will result in a 401 response.
• Assuming an empty array means an error — a 200 response with [] simply means no upload sessions have been created yet for this user.
• Treating status and innerStatus as the same field — status is the overall session state, while innerStatus belongs to each individual document request within the session.
• Not checking documentVerificationRequests for null before iterating — the field is nullable and must be null-checked in client code.

Related Endpoints

• POST /UserUploadSessions — Create a new document verification upload session
• GET /UserUploadSessions/{id} — Retrieve a specific upload session by ID
• POST /UserUploadSessions/{id}/documents — Upload a document file to an existing session

Example

curl -X GET https://api.banking.netevia.dev/UserUploadSessions \
  -H "Authorization: Bearer YOUR_TOKEN" \
  -H "Content-Type: application/json"