Hide Business Funding data

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.

FieldTypeDescription
(root)booleantrue if the funding data was successfully dismissed; false otherwise
true

Error Codes

CodeWhen it happens
400Missing required fields or validation error
401Token missing, expired, or invalid
403Insufficient permissions
404Resource not found
500Internal 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 application
  • GET /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"
Headers
string
enum
Defaults to application/json

Generated from available response content types

Allowed:
Response

Language
Credentials
Bearer
JWT
LoadingLoading…
Response
Click Try It! to start a request and see the response here! Or choose an example:
text/plain
application/json
text/json