Block user identifier (email, card, etc.)

post

https://api.centrobill.com/blacklist/block

Body Params

name

string

enum

required

Type of identifier to block

value

string

required

Identifier value (e.g., email). Must match the name parameter type (e.g., if name is 'email', provide an email address here)

expiredAt

Expiration time for the block. Accepts an ISO 8601 date-time string (e.g. 2025-12-31T23:59:59Z) or a Unix timestamp, either as an integer or as a numeric string (e.g. 1735689599). If omitted, the block is open-ended with no expiration

blockRelatedItems

boolean

Block all related data associated with the provided identifier under the value parameter

message

string

required

Note or reason for the block

author

string

required

Author of the block request

systemId

string

Merchant system ID

bin

string

Bank Identification Number (for card blocks)

last4

string

Last four card digits (for card blocks)

Responses

200OK

400Bad Request — one or more required fields are missing or invalid

500Internal Server Error