Connection to April Tax service

Connection to April Tax Service

This endpoint returns a URL that connects the authenticated user to the April Tax service integration. The response contains a single string value representing the April Tax redirect or session URL. This endpoint is deprecated and should not be used for new integrations.

Endpoint

GET /api/users/v2/aprilUrl

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

This endpoint was used to initiate a session with the April Tax filing service on behalf of an authenticated customer. It is now deprecated and no longer recommended for new integrations. Partners previously used this to deep-link customers into the April Tax experience directly from the Netevia platform.

Response

200 OK

Field	Type	Description
value	string (nullable)	The April Tax service URL or session token string

{
  "value": "https://app.apriltax.com/session?token=abc123xyz"
}

Error Codes

Code	When it happens
401	Token missing, expired, or invalid
403	Insufficient permissions
500	Internal server error

Common Mistakes

Using this endpoint in new integrations — it is deprecated and may be removed in a future API version; avoid building new features that depend on it.
Not refreshing the Bearer token before calling — the token lifetime is 10 minutes and an expired token will result in a 401 error.

Related Endpoints

POST /api/auth/v2 — Obtain a Bearer token for authentication
POST /api/auth/refresh — Refresh an existing Bearer token

Example

curl -X GET https://api.banking.netevia.dev/api/users/v2/aprilUrl \
  -H "Authorization: Bearer YOUR_TOKEN" \
  -H "Accept: application/json"