# Claims

Handles all Claims related functionality

## Hierarchy

* **Claims**

## Index

### Properties

* [addClaims](#addclaims)
* [addInvestorUniquenessClaim](#addinvestoruniquenessclaim)
* [editClaims](#editclaims)
* [revokeClaims](#revokeclaims)

### Methods

* [getCddClaims](#getcddclaims)
* [getClaimScopes](#getclaimscopes)
* [getIdentitiesWithClaims](#getidentitieswithclaims)
* [getInvestorUniquenessClaims](#getinvestoruniquenessclaims)
* [getIssuedClaims](#getissuedclaims)
* [getTargetingClaims](#gettargetingclaims)

## Properties

### addClaims

• **addClaims**: *ProcedureMethod‹Pick‹*[*ModifyClaimsParams*](https://developers.polymath.network/polymesh-sdk-api-reference/docs-v4/globals#modifyclaimsparams)*, "claims"›, void›*

*Defined in* [*src/Claims.ts:112*](https://github.com/PolymathNetwork/polymesh-sdk/blob/a0872cf4/src/Claims.ts#L112)

Add claims to Identities

**`param`** array of claims to be added

**`note`** required role if at least one claim is CDD type:

* Customer Due Diligence Provider

### addInvestorUniquenessClaim

• **addInvestorUniquenessClaim**: *ProcedureMethod‹*[*AddInvestorUniquenessClaimParams*](https://developers.polymath.network/polymesh-sdk-api-reference/docs-v4/interfaces/addinvestoruniquenessclaimparams)*, void›*

*Defined in* [*src/Claims.ts:102*](https://github.com/PolymathNetwork/polymesh-sdk/blob/a0872cf4/src/Claims.ts#L102)

Add an Investor Uniqueness Claim to the current Identity

**`param`**

### editClaims

• **editClaims**: *ProcedureMethod‹Pick‹*[*ModifyClaimsParams*](https://developers.polymath.network/polymesh-sdk-api-reference/docs-v4/globals#modifyclaimsparams)*, "claims"›, void›*

*Defined in* [*src/Claims.ts:123*](https://github.com/PolymathNetwork/polymesh-sdk/blob/a0872cf4/src/Claims.ts#L123)

Edit claims associated to Identities (only the expiry date can be modified)

**`param`** array of claims to be edited

**`note`** required role if at least one claim is CDD type:

* Customer Due Diligence Provider

### revokeClaims

• **revokeClaims**: *ProcedureMethod‹Pick‹*[*ModifyClaimsParams*](https://developers.polymath.network/polymesh-sdk-api-reference/docs-v4/globals#modifyclaimsparams)*, "claims"›, void›*

*Defined in* [*src/Claims.ts:133*](https://github.com/PolymathNetwork/polymesh-sdk/blob/a0872cf4/src/Claims.ts#L133)

Revoke claims from Identities

**`param`** array of claims to be revoked

**`note`** required role if at least one claim is CDD type:

* Customer Due Diligence Provider

## Methods

### getCddClaims

▸ **getCddClaims**(`opts`: object): *Promise‹*[*ClaimData*](https://developers.polymath.network/polymesh-sdk-api-reference/docs-v4/interfaces/claimdata)*‹*[*CddClaim*](https://developers.polymath.network/polymesh-sdk-api-reference/docs-v4/globals#cddclaim)*›\[]›*

*Defined in* [*src/Claims.ts:288*](https://github.com/PolymathNetwork/polymesh-sdk/blob/a0872cf4/src/Claims.ts#L288)

Retrieve the list of CDD claims for a target Identity

**Parameters:**

▪`Default value` **opts**: *object*= {}

| Name              | Type                                                                                                          | Description                                                                         |
| ----------------- | ------------------------------------------------------------------------------------------------------------- | ----------------------------------------------------------------------------------- |
| `includeExpired?` | undefined \| false \| true                                                                                    | whether to include expired claims. Defaults to true                                 |
| `target?`         | string \| [Identity](https://developers.polymath.network/polymesh-sdk-api-reference/docs-v4/classes/identity) | identity for which to fetch CDD claims (optional, defaults to the current Identity) |

**Returns:** *Promise‹*[*ClaimData*](https://developers.polymath.network/polymesh-sdk-api-reference/docs-v4/interfaces/claimdata)*‹*[*CddClaim*](https://developers.polymath.network/polymesh-sdk-api-reference/docs-v4/globals#cddclaim)*›\[]›*

### getClaimScopes

▸ **getClaimScopes**(`opts`: object): *Promise‹*[*ClaimScope*](https://developers.polymath.network/polymesh-sdk-api-reference/docs-v4/interfaces/claimscope)*\[]›*

*Defined in* [*src/Claims.ts:238*](https://github.com/PolymathNetwork/polymesh-sdk/blob/a0872cf4/src/Claims.ts#L238)

Retrieve all scopes in which claims have been made for the target Identity. If the scope is an asset DID, the corresponding ticker is returned as well

**Parameters:**

▪`Default value` **opts**: *object*= {}

| Name      | Type                                                                                                          | Description                                                                           |
| --------- | ------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------- |
| `target?` | string \| [Identity](https://developers.polymath.network/polymesh-sdk-api-reference/docs-v4/classes/identity) | identity for which to fetch claim scopes (optional, defaults to the current Identity) |

**Returns:** *Promise‹*[*ClaimScope*](https://developers.polymath.network/polymesh-sdk-api-reference/docs-v4/interfaces/claimscope)*\[]›*

### getIdentitiesWithClaims

▸ **getIdentitiesWithClaims**(`opts`: object): *Promise‹*[*ResultSet*](https://developers.polymath.network/polymesh-sdk-api-reference/docs-v4/interfaces/resultset)*‹*[*IdentityWithClaims*](https://developers.polymath.network/polymesh-sdk-api-reference/docs-v4/interfaces/identitywithclaims)*››*

*Defined in* [*src/Claims.ts:179*](https://github.com/PolymathNetwork/polymesh-sdk/blob/a0872cf4/src/Claims.ts#L179)

Retrieve a list of Identities with claims associated to them. Can be filtered using parameters

**`note`** supports pagination

**`note`** uses the middleware

**Parameters:**

▪`Default value` **opts**: *object*= {}

| Name                   | Type                                                                                                                 | Description                                                                               |
| ---------------------- | -------------------------------------------------------------------------------------------------------------------- | ----------------------------------------------------------------------------------------- |
| `claimTypes?`          | [ClaimType](https://developers.polymath.network/polymesh-sdk-api-reference/docs-v4/enums/claimtype)\[]               | types of the claims to fetch. Defaults to any type                                        |
| `includeExpired?`      | undefined \| false \| true                                                                                           | whether to include expired claims. Defaults to true                                       |
| `scope?`               | [Scope](https://developers.polymath.network/polymesh-sdk-api-reference/docs-v4/interfaces/scope)                     | scope of the claims to fetch. Defaults to any scope                                       |
| `size?`                | undefined \| number                                                                                                  | page size                                                                                 |
| `start?`               | undefined \| number                                                                                                  | page offset                                                                               |
| `targets?`             | (string \| [Identity](https://developers.polymath.network/polymesh-sdk-api-reference/docs-v4/classes/identity)‹›)\[] | identities (or Identity IDs) for which to fetch claims (targets). Defaults to all targets |
| `trustedClaimIssuers?` | (string \| [Identity](https://developers.polymath.network/polymesh-sdk-api-reference/docs-v4/classes/identity)‹›)\[] | identity IDs of claim issuers. Defaults to all claim issuers                              |

**Returns:** *Promise‹*[*ResultSet*](https://developers.polymath.network/polymesh-sdk-api-reference/docs-v4/interfaces/resultset)*‹*[*IdentityWithClaims*](https://developers.polymath.network/polymesh-sdk-api-reference/docs-v4/interfaces/identitywithclaims)*››*

### getInvestorUniquenessClaims

▸ **getInvestorUniquenessClaims**(`opts`: object): *Promise‹*[*ClaimData*](https://developers.polymath.network/polymesh-sdk-api-reference/docs-v4/interfaces/claimdata)*‹*[*InvestorUniquenessClaim*](https://developers.polymath.network/polymesh-sdk-api-reference/docs-v4/globals#investoruniquenessclaim)*›\[]›*

*Defined in* [*src/Claims.ts:312*](https://github.com/PolymathNetwork/polymesh-sdk/blob/a0872cf4/src/Claims.ts#L312)

Retrieve the list of InvestorUniqueness claims for a target Identity

**Parameters:**

▪`Default value` **opts**: *object*= {}

| Name              | Type                                                                                                          | Description                                                                         |
| ----------------- | ------------------------------------------------------------------------------------------------------------- | ----------------------------------------------------------------------------------- |
| `includeExpired?` | undefined \| false \| true                                                                                    | whether to include expired claims. Defaults to true                                 |
| `target?`         | string \| [Identity](https://developers.polymath.network/polymesh-sdk-api-reference/docs-v4/classes/identity) | identity for which to fetch CDD claims (optional, defaults to the current Identity) |

**Returns:** *Promise‹*[*ClaimData*](https://developers.polymath.network/polymesh-sdk-api-reference/docs-v4/interfaces/claimdata)*‹*[*InvestorUniquenessClaim*](https://developers.polymath.network/polymesh-sdk-api-reference/docs-v4/globals#investoruniquenessclaim)*›\[]›*

### getIssuedClaims

▸ **getIssuedClaims**(`opts`: object): *Promise‹*[*ResultSet*](https://developers.polymath.network/polymesh-sdk-api-reference/docs-v4/interfaces/resultset)*‹*[*ClaimData*](https://developers.polymath.network/polymesh-sdk-api-reference/docs-v4/interfaces/claimdata)*››*

*Defined in* [*src/Claims.ts:144*](https://github.com/PolymathNetwork/polymesh-sdk/blob/a0872cf4/src/Claims.ts#L144)

Retrieve all claims issued by an Identity

**`note`** supports pagination

**`note`** uses the middleware

**Parameters:**

▪`Default value` **opts**: *object*= {}

| Name              | Type                                                                                                          | Description                                           |
| ----------------- | ------------------------------------------------------------------------------------------------------------- | ----------------------------------------------------- |
| `includeExpired?` | undefined \| false \| true                                                                                    | whether to include expired claims. Defaults to true   |
| `size?`           | undefined \| number                                                                                           | -                                                     |
| `start?`          | undefined \| number                                                                                           | -                                                     |
| `target?`         | string \| [Identity](https://developers.polymath.network/polymesh-sdk-api-reference/docs-v4/classes/identity) | identity (optional, defaults to the current Identity) |

**Returns:** *Promise‹*[*ResultSet*](https://developers.polymath.network/polymesh-sdk-api-reference/docs-v4/interfaces/resultset)*‹*[*ClaimData*](https://developers.polymath.network/polymesh-sdk-api-reference/docs-v4/interfaces/claimdata)*››*

### getTargetingClaims

▸ **getTargetingClaims**(`opts`: object): *Promise‹*[*ResultSet*](https://developers.polymath.network/polymesh-sdk-api-reference/docs-v4/interfaces/resultset)*‹*[*IdentityWithClaims*](https://developers.polymath.network/polymesh-sdk-api-reference/docs-v4/interfaces/identitywithclaims)*››*

*Defined in* [*src/Claims.ts:339*](https://github.com/PolymathNetwork/polymesh-sdk/blob/a0872cf4/src/Claims.ts#L339)

Retrieve all claims issued about an Identity, grouped by claim issuer

**`note`** supports pagination

**`note`** uses the middleware (optional)

**Parameters:**

▪`Default value` **opts**: *object*= {}

| Name                   | Type                                                                                                                 | Description                                                                               |
| ---------------------- | -------------------------------------------------------------------------------------------------------------------- | ----------------------------------------------------------------------------------------- |
| `includeExpired?`      | undefined \| false \| true                                                                                           | whether to include expired claims. Defaults to true                                       |
| `scope?`               | [Scope](https://developers.polymath.network/polymesh-sdk-api-reference/docs-v4/interfaces/scope)                     | -                                                                                         |
| `size?`                | undefined \| number                                                                                                  | -                                                                                         |
| `start?`               | undefined \| number                                                                                                  | -                                                                                         |
| `target?`              | string \| [Identity](https://developers.polymath.network/polymesh-sdk-api-reference/docs-v4/classes/identity)        | identity for which to fetch targeting claims (optional, defaults to the current Identity) |
| `trustedClaimIssuers?` | (string \| [Identity](https://developers.polymath.network/polymesh-sdk-api-reference/docs-v4/classes/identity)‹›)\[] | -                                                                                         |

**Returns:** *Promise‹*[*ResultSet*](https://developers.polymath.network/polymesh-sdk-api-reference/docs-v4/interfaces/resultset)*‹*[*IdentityWithClaims*](https://developers.polymath.network/polymesh-sdk-api-reference/docs-v4/interfaces/identitywithclaims)*››*