---
title: List Investors by Status
slug: investor-onboarding-io/list-investors-by-status
description: Learn how to fetch investor details created by customers using the API request in this comprehensive document. Discover the recommended time gap of 2-3 minutes for pulling accurate investor data. Find detailed instructions on sending requests, including t
docTags: 
createdAt: 2023-06-07T07:50:38.000Z
---

After successful onboarding, we can fetch the investor’s details created by the customer. We can get the list of investors that are created by customers based on the criteria provided in the API request. Keep a time gap of 2-3 minutes before pulling the investor’s data.

# Sending Requests

For sending requests the hostname and protocol will be the same as given in the [Authentication](docId\:Eh9zZ1KpurWnfb-NNnIud) section.

Send a post request to: **/api/pullmerchants** with the data below.

# Headers

| **Property**  | **Value**                                     |
| ------------- | --------------------------------------------- |
| Content-type  | application/json                              |
| Authorization | Authorization header as per the login request |

# Request Body

```json
{
  "customerId": "...customerId...",
  "limitLength": 10,
  "skipLength": 0,
  "status" : "accepted"
}
```

**The below table describes all the properties available in the request body:**

| **Property** | **Accepted Values/Format** | **Description**                                                                   |
| ------------ | -------------------------- | --------------------------------------------------------------------------------- |
| customerId   | String                     | customerId of that customer                                                       |
| limitLength  | Integer                    | Limit to the number of investors that are returned (helpful in pagination)        |
| skipLength   | Integer                    | Skip these many investors before generating the list of investors                 |
| status       | string                     | Status of investor wanted to be pulled (all/pending/accepted/rejected/draft/redo) |

:::hint{type="info"}
### Getting help

Please feel free to contact us if you have any questions, require clarification, or have ideas for how to make the documents or any of our services better.


You can reach out to us at [help@signzy.com](#).
:::