Get Statement V2 Links

This endpoint retrieves statement download links associated with a financial account. It returns a structured response containing the download URL, the financial account identifiers covered by the statement, the statement period, and the content type of the downloadable file. Use this endpoint when you need to provide customers with access to their account statements.

Endpoint

GET /api/Statement/V2/links

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 a customer needs to download a statement for one of their financial accounts. It is suitable for building statement history views in partner portals, triggering statement downloads on demand, or automating statement retrieval for record-keeping purposes.

Response

200 OK

{
  "url": "https://statements.banking.netevia.com/documents/statement-2024-05.pdf",
  "financialAccounts": [
    "XXXXXXXXXX"
  ],
  "period": "2024-05-31T00:00:00Z",
  "contentType": "application/pdf"
}

Error Codes

Common Mistakes

• Forgetting to include the Authorization: Bearer header will result in a 401 response.
• The contentType field is read-only and is returned by the server; do not attempt to set it in a request.
• Tokens expire after 10 minutes — refresh via POST /api/auth/refresh before making this call if the token may have expired.

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/Statement/V2/links \
  -H "Authorization: Bearer YOUR_TOKEN" \
  -H "Content-Type: application/json"