Get User Document by File Type

This endpoint retrieves a previously uploaded document associated with the authenticated user, identified by its file type. The document is returned in base64-encoded format along with its MIME content type, enabling downstream applications to decode and render it appropriately. Supported document types span identity documents, business records, financial statements, insurance documents, and card icons.

Endpoint

GET /Files/document

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 your application needs to display or process a document that a user previously uploaded to their Netevia account — for example, showing a driver's license on file, retrieving a tax document, or accessing a business registration record. This is also useful for compliance workflows that require programmatic access to identity verification documents stored against a profile.

Query Parameters

Allowed fileType values:

Response

200 OK

The document is returned as a base64-encoded payload along with its content type. The exact response structure depends on the document retrieved.

{
  "fileContent": "JVBERi0xLjQKJcOkw7zDtsOfCjIgMCBvYmoKPDwvTGVuZ3RoIDMgMCBSL0ZpbHRlci9GbGF0ZURlY29kZT4+CnN0cmVhbQp4...",
  "contentType": "application/pdf"
}

Error Codes

Common Mistakes

• Passing a fileType value that is not an exact case-sensitive match to the enum (e.g., driverLicense instead of DriverLicense) will result in a 400 error.
• Attempting to retrieve a document type that was never uploaded for the user returns a 404 — ensure the upload step completed successfully before calling this endpoint.
• Forgetting to decode the base64 fileContent before attempting to display or process the document.
• Using the wrong MIME type for rendering — always use the returned contentType field to determine how to handle the file, rather than assuming a fixed format.

Related Endpoints

• POST /Files/document — Upload a new document for the authenticated user by file type
• DELETE /Files/document — Remove a previously uploaded document by file type
• GET /Files — List all documents on file for the authenticated user

Example

curl -X GET "https://api.banking.netevia.dev/Files/document?fileType=DriverLicense" \
  -H "Authorization: Bearer YOUR_TOKEN" \
  -H "Accept: application/json"