Get API Current Version
This endpoint returns the current version string of the Netevia Banking API. It is a lightweight diagnostic call that confirms the API is reachable and reveals the deployed assembly version. Partners can use it during integration setup or health checks to verify connectivity and version alignment.
Endpoint
GET /api/welcome/assembly
Authentication
Bearer token required. Obtain via:
POST https://api.banking.netevia.dev/api/auth/v2Include in header: Authorization: Bearer {token}
Token lifetime: 10 minutes. Refresh via POST /api/auth/refresh.
When to use
Use this endpoint to verify that your integration is connecting to the correct API environment and to confirm the deployed version of the Netevia Banking API. It is useful during onboarding, after deployments, or as part of automated health-check routines to ensure the API is responsive.
Response
200 OK
Returns a plain string containing the current API assembly version.
| Field | Type | Description |
|---|---|---|
| (response body) | string | The current version identifier of the deployed API assembly |
"v1.4.2.0"Error Codes
| Code | When it happens |
|---|---|
| 401 | Token missing, expired, or invalid |
| 403 | Insufficient permissions |
| 500 | Internal server error |
Common Mistakes
- Omitting the
Authorization: Bearerheader will result in a 401 even though this is a read-only informational endpoint. - Comparing the returned version string against a hard-coded expected value in automated tests may cause false failures after API updates; treat this as a liveness check rather than a version-pin assertion.
Related Endpoints
POST /api/auth/v2— Obtain a Bearer token for authenticating API requestsPOST /api/auth/refresh— Refresh an existing Bearer token before it expires
Example
curl -X GET https://api.banking.netevia.dev/api/welcome/assembly \
-H "Authorization: Bearer YOUR_TOKEN" \
-H "Accept: application/json"