Search for Business Account Holders

The Search for Business Account Holders endpoint allows partners and administrators to query the Netevia banking system for business account holders using a variety of search parameters. It returns a list of matching business accounts with their identifiers and doing-business-as (DBA) names. This endpoint is essential for customer support workflows, account administration, and partner-level account management operations.

Endpoint

POST /api/AccountsSearch/BusinesAccountHolder

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 you need to locate one or more business account holders by name (DBA), ISO relationship, or a set of agent IDs. It is suited for customer service lookups, administrative dashboards, and partner reporting tools that need to surface business account records quickly without knowing the exact account ID. The count parameter allows callers to limit result set size for performance-sensitive queries.

Request Body

{
  "agentIds": [101, 102],
  "isoId": 55,
  "dba": "Acme Supplies",
  "count": 25
}

Response

200 OK

Returns an array of business account holder search results matching the provided criteria.

[
  {
    "id": 1042,
    "dba": "Acme Supplies LLC"
  },
  {
    "id": 1078,
    "dba": "Acme Supplies East"
  }
]

Error Codes

Common Mistakes

• Sending an empty request body without any filter fields — at least one search parameter (agentIds, isoId, or dba) should be provided to produce meaningful results rather than returning all accounts or an empty set.
• Omitting the count field on large data sets — without a limit, the response may return a very large number of records, impacting performance; always specify a reasonable count value.
• Using an expired Bearer token — tokens are valid for only 10 minutes; refresh via POST /api/auth/refresh before making calls if the token may have expired.
• Providing an exact full legal name when the field represents the DBA (doing-business-as) name — ensure search strings match the DBA name, not the registered legal entity name.

Related Endpoints

• POST /api/AccountsSearch/PersonalAccountHolder — Search for personal (consumer) account holders using similar criteria.
• POST /api/auth/v2 — Obtain a Bearer token required for authentication.
• POST /api/auth/refresh — Refresh an existing Bearer token before it expires.

Example

curl -X POST https://api.banking.netevia.dev/api/AccountsSearch/BusinesAccountHolder \
  -H "Authorization: Bearer YOUR_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "agentIds": [101, 102],
    "isoId": 55,
    "dba": "Acme Supplies",
    "count": 25
  }'