# Create a bulk search
source: https://developer.mastercard.com/track-search/documentation/tutorials-and-guides/bulk-search-tutorial/index.md

## Overview {#overview}

Issuers, payment service providers, Business Payment Service agents, and corporates can leverage the Search endpoints to request data on their trading partners.
Diagram oauth
>
> #### What you will learn {#what-you-will-learn}
>
> * Initiate the bulk Search request
> * Check the status of a request, and
> * Retrieve the Search results.

## What you will achieve {#what-you-will-achieve}

You will receive valuable insights on your trading partners.

## Create the bulk search request {#create-the-bulk-search-request}

Complete these steps to initiate a Search request.

## 1. Create the Search request using the POST Search endpoint. {#1-create-the-search-request-using-the-post-search-endpoint}


API Reference: `POST /bulk-searches`

Note: With the April 2023 release, the response payload includes the Supplier profile ID, which can be used to retrieve the Supplier's payment preference information and Supplier profile status. Only payment agents receive the Supplier profile ID in the response payload.

## 2. Verify the request was submitted successfully. {#2-verify-the-request-was-submitted-successfully}

You should receive a 202 OK response and the `bulkSearchId`.
Tip: You will need the Search-generated `bulkSearchId` in order to check the status of the request.

## 3. Click Next to proceed to check the status of the request. {#3-click-next-to-proceed-to-check-the-status-of-the-request}

## Check the status of the Search request {#check-the-status-of-the-search-request}

Complete these steps to retrieve the results of the Search request.

## 1. Send the Search status request using the GET Search endpoint. {#1-send-the-search-status-request-using-the-get-search-endpoint}

Tip: You will need the Search-generated `bulkSearchId` you received in the POST response payload.
API Reference: `GET /bulk-searches/{bulk_search_id}`

## 2. Verify the request was submitted successfully. {#2-verify-the-request-was-submitted-successfully-1}

You should receive a 200 OK response and the status of the request.

## 3. Click Next to proceed to retrieving the Search results. {#3-click-next-to-proceed-to-retrieving-the-search-results}

## Check the status of the Search request {#check-the-status-of-the-search-request-1}

Complete these steps to check the results of a Search request.

## 1. Send the Search results request using the GET Search endpoint. {#1-send-the-search-results-request-using-the-get-search-endpoint}

Tip: You will need the Search-generated `bulkSearchId` you received in the POST response payload.
API Reference: `GET /bulk-searches/{bulk_search_id}/results`

## 2. Verify the request was submitted successfully. {#2-verify-the-request-was-submitted-successfully-2}

You should receive a 200 OK response and the trading partner data.