---
title: grantedShares()
slug: grantedshares
docTags: 
createdAt: 2021-09-14T17:47:57.000Z
---

Returns all of the shares that were granted between two specified dates.

### Syntax

`grantedShares(fromDate, untilDate[, filters])`

- `fromDate` - the date from which counting begins.
- `untilDate` - the date at which counting ceases.
- `filters` - optional modifiers.
- **Return type**: [Number](docId\:ucI5tCTfVBhonEJ6ZQijg)&#x20;

### Sample usage

`grantedShares('2000-01-01', '2020-03-02')` returns the number of shares that were granted between `2000-01-01` and `2020-03-02`.

### Supported data types

| **Input type**                                 | **Return type**                         | **Logic**                                                                                                    |
| ---------------------------------------------- | --------------------------------------- | ------------------------------------------------------------------------------------------------------------ |
| ****[Date](docId\:xTAQdzvLBTAKjxRnpFwe9)  (x2) | [Number](docId\:ucI5tCTfVBhonEJ6ZQijg)  | The function will count the number of granted shares beginning with `fromDate`, and ending with `untilDate`. |
| *Unsupported data types*                       | **[Null](docId\:N9trVqonnBknqL9DrNBP6)  | Unsupported data types return `Null`.                                                                        |

