> For the complete documentation index, see [llms.txt](https://docs.compliance.phalcon.blocksec.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.compliance.phalcon.blocksec.com/api-documentation/blacklist-whitelist-management/add-addresses-to-blacklist.md).

# Add Addresses to Blacklist

## Add addresses to blacklist

> Add one or more addresses to your blacklist.

```json
{"openapi":"3.0.0","info":{"title":"Compliance API","version":"2.0.0"},"tags":[{"name":"Blacklist","description":"Blacklist management APIs."}],"servers":[{"url":"https://api.blocksec.com/phalcon/compliance/v2","description":"Production server"}],"security":[{"API-Key":[]}],"components":{"securitySchemes":{"API-Key":{"type":"apiKey","in":"header","name":"API-Key"}},"schemas":{"BlacklistOrWhiteAddress":{"type":"object","required":["addresses"],"properties":{"addresses":{"type":"array","description":"The list of addresses to be added.","items":{"$ref":"#/components/schemas/BlacklistOrWhitelistAddressData"}}}},"BlacklistOrWhitelistAddressData":{"type":"object","properties":{"chainId":{"type":"integer","description":"The chain ID. For all supported chains and corresponding chain IDs, see [https://docs.compliance.phalcon.blocksec.com/api-documentation/introduction/supported-chains](https://docs.compliance.phalcon.blocksec.com/api-documentation/introduction/supported-chains)."},"address":{"type":"string","description":"The address to be added."},"reason":{"type":"string","description":"The reason for adding the address."}}},"ErrorCodeMsg":{"properties":{"code":{"type":"integer","description":"The business status code. `0` means the request succeeded; any other value means it failed. Business errors are returned with HTTP 200 and a non-zero code, so a 200 response is not by itself a success — always check this field. Authentication and rate-limiting failures use a non-200 HTTP status instead, so check both. For all codes and their messages, see [https://docs.compliance.phalcon.blocksec.com/api-documentation/introduction/error-messages](https://docs.compliance.phalcon.blocksec.com/api-documentation/introduction/error-messages)."},"msg":{"type":"string","description":"`\"Success\"` when `code` is 0, otherwise the error message for that code."}}},"BlacklistAddressAddResult":{"type":"object","properties":{"addedAddresses":{"type":"array","description":"The list of added addresses.","items":{"$ref":"#/components/schemas/BlacklistOrWhitelistAddressData"}},"failed":{"type":"array","description":"The list of addresses that failed to be added","items":{"$ref":"#/components/schemas/BlacklistOrWhitelistAddressFailedData"}}}},"BlacklistOrWhitelistAddressFailedData":{"type":"object","properties":{"chainId":{"type":"integer","description":"The chain ID. For all supported chains and corresponding chain IDs, see [https://docs.compliance.phalcon.blocksec.com/api-documentation/introduction/supported-chains](https://docs.compliance.phalcon.blocksec.com/api-documentation/introduction/supported-chains)."},"address":{"type":"string","description":"The address to be added."},"reason":{"type":"string","description":"The reason for adding the address."},"status":{"type":"integer","description":"The failed reason for adding the address. Values: 2 = The address is already in the whitelist; 3 = The address is already in the blacklist; 4 = The reason provided for the address is invalid; 5 = The address is not in the whitelist; 6 = The address is not in the blacklist.","enum":[2,3,4,5,6]}}}}},"paths":{"/blacklists/add":{"post":{"tags":["Blacklist"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/BlacklistOrWhiteAddress"}}}},"responses":{"200":{"description":"Response. A non-zero `code` indicates a business error even when the HTTP status is 200.","content":{"application/json":{"schema":{"type":"object","properties":{"code":{"$ref":"#/components/schemas/ErrorCodeMsg/properties/code","description":"The status code of this request. For all possible codes and corresponding errors/messages, see [https://docs.compliance.phalcon.blocksec.com/api-documentation/introduction/error-messages](https://docs.compliance.phalcon.blocksec.com/api-documentation/introduction/error-messages)."},"msg":{"$ref":"#/components/schemas/ErrorCodeMsg/properties/msg","description":"The message of this request. For all possible codes and corresponding errors/messages, see [https://docs.compliance.phalcon.blocksec.com/api-documentation/introduction/error-messages](https://docs.compliance.phalcon.blocksec.com/api-documentation/introduction/error-messages)."},"data":{"$ref":"#/components/schemas/BlacklistAddressAddResult"}}}}}},"401":{"description":"Authentication failed. The `API-Key` header is missing or invalid."},"429":{"description":"Rate limit exceeded. Reduce the request rate and retry."}},"description":"Add one or more addresses to your blacklist.","summary":"Add addresses to blacklist"}}}}
```
