# Get polls by identifer

The max limit that can be used is 100, anything above it would be disregarded.

> We love our servers, like everyone else, which is why this API sends our paginated response. You can pass in **offset & limit** to fetch polls in bulk as pages. 
>
> There is a max limit of 100, so even if you pass *`?limit=150`  it will only send at max 100.*

## Get polls by identifier

<mark style="color:blue;">`GET`</mark> `https://api.pollsapi.com/v1/get/polls-with-identifier/{identifier}?offset=0&limit=25`

Fetch all the polls by the custom identifier property

#### Path Parameters

| Name       | Type   | Description                                       |
| ---------- | ------ | ------------------------------------------------- |
| identifier | string | Identifier for which all polls need to be fetched |

#### Query Parameters

| Name   | Type   | Description                                             |
| ------ | ------ | ------------------------------------------------------- |
| offset | number | Number of items to be skipped                           |
| limit  | number | Number of items to be fetched, default is 25 (Max: 100) |

#### Headers

| Name    | Type   | Description              |
| ------- | ------ | ------------------------ |
| api-key | string | API Key for your account |

{% tabs %}
{% tab title="200 Cake successfully retrieved." %}

```javascript
{
  "status": "success",
  "statusCode": 200,
  "data": {
    "docs": [],
    "totalDocs": 0,
    "offset": 0,
    "limit": 25,
    "totalPages": 1,
    "page": 1,
    "pagingCounter": 1,
    "hasPrevPage": false,
    "hasNextPage": false,
    "prevPage": null,
    "nextPage": null
  }
}

```

{% endtab %}
{% endtabs %}

### Example cURL Request

```bash
curl https://api.pollsapi.com/v1/get/polls-with-identifier \
  -H "content-type: application/json" \
  -H "api-key: $API_KEY"
```