# Search for Delegated Mandate
source: https://developer.mastercard.com/bs-creditor-api/documentation/use-cases/use-cases-2/index.md

The Search for Delegated Mandate API endpoint allows creditors to retrieve the status of a previously submitted delegate mandate creation request. This is a POST request that requires the creditor to include the necessary OAuth 1.0a [authentication](https://developer.mastercard.com/bs-creditor-api/documentation/api-basics/index.md#Authentication) properties, along with a payload containing a list of UUIDs representing the delegated mandates.

After the Create Delegated Mandate use case has occurred, the creditor can submit a POST request to the BS Creditor API to check the status of a previously created delegated mandate. The creditor must provide the UUIDs in the request according to the provided OpenAPI specification.
Note: At any given time, the BS Creditor API holds the current status of a mandate. It only reflects what the Betalingsservice last shared.

One of the following scenarios can happen:

* **Delegated Mandate is approved by the debtor's bank** - The creation of the delegated mandate has been processed and approved by the debtor's bank. Therefore, the BS Creditor API responds with the UUIDs, VALIDATED status code, and the ID of the created mandate.

  Diagram use_case2
* **Delegated Mandate is awaiting approval from the debtor's bank** - The creation of the delegated mandate is yet to be processed. Therefore, the BS Creditor API responds with a 200 status code, returns the UUIDs, and RECEIVED status code.

  Diagram use_case3
* **Delegated Mandate has been rejected by the debtor's bank** - The bank has rejected the creation of the delegated mandate. Therefore, the BS Creditor API responds with the UUIDs, the FAILED status code, an error code, and an error description. For example, if the debtor's account information is incorrect, the response will include the DEBTOR_ACCOUNT_INFORMATION_IS_NOT_CORRECT error code and a description of the error. For a comprehensive list of potential error codes, see the [Business Error Codes](https://developer.mastercard.com/bs-creditor-api/documentation/code-and-formats/index.md#business-error-codes) section.

  Diagram use_case4

Because the creditor provides a list of UUIDs in the request, the response includes a list of statuses, each corresponding to one of the provided UUIDs. The status for a UUID can be RECEIVED, VALIDATED, or FAILED. Also, any UUIDs not found are ignored.
Note: Use the optional **completedOnly** boolean property in the request body to filter the response by completion status. If **completedOnly** is set to true, the response includes delegated mandates only with the VALIDATED or FAILED status codes. By default, this property is set to false, implying that the response includes delegated mandates with VALIDATED, FAILED, and RECEIVED status codes.
