Hide Business Funding Data
The /api/loans/dismiss endpoint allows partners to manage the visibility of business funding screens and information for customers. It is particularly useful when a funding application has been declined or a funding offer has expired, enabling partners to remove stale or irrelevant funding data from the customer's interface. Although not mandatory, using this endpoint is recommended to maintain a clean and relevant user experience.
Endpoint
POST /api/loans/dismiss
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 triggers a "Dismiss" action after a business funding application is declined or a business funding offer expires. This signals to the system that the specified funding information should no longer be shown to that customer. Calling this endpoint ensures customers are only presented with up-to-date and pertinent funding information.
Response
200 OK
Returns a boolean value indicating whether the dismiss operation was successful.
| Field | Type | Description |
|---|---|---|
| (root) | boolean | true if the funding data was successfully dismissed; false otherwise |
trueError Codes
| Code | When it happens |
|---|---|
| 400 | Missing required fields or validation error |
| 401 | Token missing, expired, or invalid |
| 403 | Insufficient permissions |
| 404 | Resource not found |
| 500 | Internal server error |
Common Mistakes
- Calling this endpoint without a valid Bearer token, causing a 401 Unauthorized response.
- Treating this endpoint as mandatory — it is recommended but optional; skipping it will not block other operations, but may result in outdated funding information remaining visible to the customer.
Related Endpoints
POST /api/loans— Submit a business funding applicationGET /api/loans— Retrieve current business funding offers and application status
Example
curl -X POST https://api.banking.netevia.dev/api/loans/dismiss \
-H "Authorization: Bearer YOUR_TOKEN" \
-H "Content-Type: application/json"