The get_assertionStatusReport API call provides administrative support for determining the status of current and outstanding publisher assertions that involve any of the business registrations managed by the individual publisher account. Using this message, a publisher can see the status of assertions that they have made, as well as see assertions that others have made that involve businessEntity structures controlled by the calling publisher account.
Upon successful completion, an assertionStatusReport message is returned containing assertion status information.
<get_assertionStatusReport generic = "2.0" xmlns = "urn:uddi-org:api_v2" > <authInfo/> [<completionStatus/>] </get_assertionStatusReport>
authInfo − This required argument is an element that contains an authentication token. Authentication tokens are obtained using the get_authToken API call.
completionStatus − These are one of the following values.
status:complete − Passing this value causes only the publisher assertions that are complete to be returned. Each businessEntity listed in assertions that are complete has a visible relationship that directly reflects the data in a complete assertion.
status:toKey_incomplete − Passing this value causes only those publisher assertions where the party who controls the businessEntity referenced by the toKey value in an assertion has not made a matching assertion to be listed.
status:fromKey_incomplete − Passing this value causes only those publisher assertions where the party who controls the businessEntity referenced by the fromKey value in an assertion has not made a matching assertion to be listed.
If any error occurs in processing this API call, a dispositionReport element is returned to the caller within a SOAP Fault. The following error number information will be relevant −
E_invalidCompletionStatus − It signifies that the completionStatus value passed is unrecognized. The completion status that caused the problem will be clearly indicated in the error text.
E_authTokenExpired − It signifies that the authentication token value passed in the authInfo argument is no longer valid because the token has expired.
E_authTokenRequired − It signifies that the authentication token value passed in the authInfo argument is either missing or is not valid.