Get Topics for Tickets

This endpoint retrieves a complete list of predefined support ticket topics available in the Netevia Banking platform. Partners use this list to present topic choices to customers when they submit a support request. Each topic entry includes an identifier, display name, and expected response time.

Endpoint

GET /api/support/topics

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

Call this endpoint before rendering a support ticket creation form so that the customer can select the most relevant topic for their issue. The returned list is curated and maintained by Netevia, so fetching it dynamically ensures your integration always shows the current set of available categories. Pass the lang query parameter to return topic names localized to the customer's preferred language.

Query Parameters

Response

200 OK

Returns an array of support topic objects.

[
  {
    "id": 1,
    "name": "Account Access",
    "responseTime": "24 hours",
    "isDeleted": false,
    "isHidden": false
  },
  {
    "id": 2,
    "name": "Card Issue",
    "responseTime": "12 hours",
    "isDeleted": false,
    "isHidden": false
  },
  {
    "id": 3,
    "name": "Transaction Dispute",
    "responseTime": "48 hours",
    "isDeleted": false,
    "isHidden": false
  }
]

Error Codes

Common Mistakes

• Displaying topics where isDeleted or isHidden is true — filter these out before presenting choices to the customer.
• Hardcoding topic IDs in your integration — topic IDs are managed server-side and may change; always call this endpoint at runtime rather than caching IDs permanently.
• Omitting the lang parameter when your platform serves non-English customers — pass the appropriate language code to ensure topic names are localized correctly.

Related Endpoints

• POST /api/support/tickets — Create a new support ticket using a topic ID returned by this endpoint
• GET /api/support/tickets — Retrieve the list of support tickets submitted by the customer

Example

curl -X GET "https://api.banking.netevia.dev/api/support/topics?lang=En" \
  -H "Authorization: Bearer YOUR_TOKEN" \
  -H "Accept: application/json"