uddi_find_business — Retrieves a businessList message matching supplied criteria.


  [ maxRows ="nn" ]
  xmlns="urn:uddi-org:api" >
        <name/> | <identifierBag/> | <categoryBag/> | <tModelBag/> | <discoveryURLs>

Attributes & Children

All arguments listed here are mutually exclusive except findQualifiers .


This optional integer value allows the requesting program to limit the number of results returned.


This collection of findQualifier elements can be used to alter the default behavior of search functionality.


This string value is a partial name. The businessList return message contains businessInfo structures for businesses whose name matches the value passed (leftmost match).


This is a list of business identifier references. The returned businessList contains businessInfo structures matching any of the identifiers passed (logical OR).


This is a list of category references. The returned businessList contains businessInfo structures matching all of the categories passed (logical AND).


The registered businessEntity data contains bindingTemplates that in turn contain specific tModel references. The tModelBag argument lets you search for businesses that have bindings that are compatible with a specific tModel pattern. The returned businessList contains businessInfo structures that match all of the tModel keys passed (logical AND). tModelKey values must be formatted as URN qualified uuid values (e.g. prefixed with "uuid:")


This is a list of URLs to be matched against the data associated with the discoveryURLs contents of registered businessEntity information. To search for a URL without regard to useType attribute values, pass the useType component of the discoveryURL elements as empty attributes. If useType values are included, then the match will be made only on registered information that matches both the useType and URL value. The returned businessList contains businessInfo structures matching any of the URLs passed (logical OR).

Return Types

This function returns a businessList on success. In the event that no matches were located for the specified criteria, a businessList structure with zero businessInfo structures is returned.

In the event of a large number of matches, a UDDI-enabled server may truncate the result set. If this occurs, the businessList will contain the truncated attribute with the value set to true.

Searching using tModelBag will also return any businessEntity that contains bindingTemplate information that matches due to hostingRedirector references. In other words, the businessEntity that contains a bindingTemplate with a hostingRedirector value referencing a bindingTemplate that matches the tModel search requirements will be returned.


If an error occurs in processing this message, a dispositionReport structure will be returned to the caller in a SOAP Fault. The following error information will be relevant:

Table24.92.Errors signalled by get_authToken

Error Code Description
E_nameTooLong signifies that the partial name value passed exceeds the maximum name length designated by the UDDI-enabled server.
E_tooManyOptions signifies that more than one search argument was passed.
E_unsupported signifies that one of the findQualifier values passed was invalid.