# BlacklistItem

A blacklist (block list) rule. Payments whose attributes match `value` for the given `type` are rejected before authorization. Rules are scoped to the account that created them; MONEI also maintains a global list applied on top.

```
type BlacklistItem {

  value: String!

  type: BlacklistItemType!

  note: String

  accountId: ID

  matches: Int

  validUntil: AWSTimestamp

  createdAt: String!

  updatedAt: String

}
```

### Fields[​](#fields "Direct link to Fields")

#### [`BlacklistItem.value`](#value) ● [`String!`](https://docs.monei.com/apis/graphql/types/scalars/string/.md) non-null scalar[​](#value "Direct link to value")

Value matched against incoming payments. Format depends on `type` (email address, E.164 phone, IPv4, card fingerprint, session fingerprint, ISO 3166-1 alpha-2 country code).

#### [`BlacklistItem.type`](#type) ● [`BlacklistItemType!`](https://docs.monei.com/apis/graphql/types/enums/blacklist-item-type/.md) non-null enum[​](#type "Direct link to type")

Payment attribute this rule matches against.

#### [`BlacklistItem.note`](#note) ● [`String`](https://docs.monei.com/apis/graphql/types/scalars/string/.md) scalar[​](#note "Direct link to note")

Free-form note explaining why the rule was added.

#### [`BlacklistItem.accountId`](#account-id) ● [`ID`](https://docs.monei.com/apis/graphql/types/scalars/id/.md) scalar[​](#account-id "Direct link to account-id")

ID of the account that owns the rule.

#### [`BlacklistItem.matches`](#matches) ● [`Int`](https://docs.monei.com/apis/graphql/types/scalars/int/.md) scalar[​](#matches "Direct link to matches")

Number of payment attempts this rule has blocked.

#### [`BlacklistItem.validUntil`](#valid-until) ● [`AWSTimestamp`](https://docs.monei.com/apis/graphql/types/scalars/awstimestamp/.md) scalar[​](#valid-until "Direct link to valid-until")

Manual expiration as a unix timestamp (seconds). The rule stops applying after this time. `null` means the rule never expires.

#### [`BlacklistItem.createdAt`](#created-at) ● [`String!`](https://docs.monei.com/apis/graphql/types/scalars/string/.md) non-null scalar[​](#created-at "Direct link to created-at")

Creation date in ISO 8601 format.

#### [`BlacklistItem.updatedAt`](#updated-at) ● [`String`](https://docs.monei.com/apis/graphql/types/scalars/string/.md) scalar[​](#updated-at "Direct link to updated-at")

Last update date in ISO 8601 format.

### Returned By[​](#returned-by "Direct link to Returned By")

[`addBlacklistItem`](https://docs.monei.com/apis/graphql/operations/mutations/add-blacklist-item/.md) mutation ● [`blacklistItem`](https://docs.monei.com/apis/graphql/operations/queries/blacklist-item/.md) query

### Member Of[​](#member-of "Direct link to Member Of")

[`BlacklistItemsConnection`](https://docs.monei.com/apis/graphql/types/objects/blacklist-items-connection/.md) object