# Blacklist

Blacklist API basically allows you to manage email addresses and domains. You can add, update, delete or list receivers addresses or domains on your blacklist. Please be aware that this API can be used only in reference to transactional emails.

## Get blacklist domains

> Use this method to list all domains that are on your blacklist.

OpenAPI:

```json
{"openapi":"3.0.0","info":{"title":"MessageFlow API","version":"v2.1.1.0"},"tags":[{"name":"Blacklist","description":"Blacklist API basically allows you to manage email addresses and domains. You can add, update, delete or list receivers addresses or domains on your blacklist. Please be aware that this API can be used only in reference to transactional emails. "}],"servers":[{"url":"https://api.messageflow.com","description":"Production server"}],"security":[{"APIKeyHeader":[],"APPKeyHeader":[]}],"components":{"securitySchemes":{"APIKeyHeader":{"type":"apiKey","name":"Authorization","in":"header"}}},"paths":{"/v2.1/email/domain/blacklist/{smtp}":{"get":{"tags":["Blacklist"],"summary":"Get blacklist domains","description":"Use this method to list all domains that are on your blacklist.","operationId":"GetDomainsFromBlacklist","parameters":[{"name":"smtp","in":"path","description":"The name of your smtp account","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Request was successfully processed","content":{"application/json":{"schema":{"properties":{"meta":{"description":"Additional data","required":["numberOfErrors","numberOfData","status","uniqId"],"properties":{"numberOfErrors":{"description":"Number of items in errors section, 0 if section not exists","type":"integer"},"numberOfData":{"description":"Number of items in data section, 0 if section not exists","type":"integer"},"status":{"description":"Request HTTP status","type":"integer"},"uniqId":{"description":"Unique identifier of a request - it allows us to find your request in the case of any troubles","type":"string"}},"type":"object"},"data":{"description":"List of email addresses that should be deleted from blacklist","type":"array","items":{"type":"string"}}},"type":"object"}}}},"207":{"description":"Some of request body items were not processed due to validation errors","content":{"application/json":{"schema":{"properties":{"data":{"description":"Simple data object","type":"array","items":{}},"meta":{"description":"Additional data","required":["numberOfErrors","numberOfData","status","uniqId"],"properties":{"$ref":"#/paths/~1v2.1~1email~1domain~1blacklist~1{smtp}/get/responses/200/content/application~1json/schema/properties/meta/properties"},"type":"object"},"errors":{"type":"array","items":{"description":"Errors list","required":["title","message","code"],"properties":{"title":{"description":"General error name","type":"string"},"message":{"description":"Error details","type":"string"},"code":{"description":"Error code in our system","type":"string"}},"type":"object"}}},"type":"object"}}}},"400":{"description":"Bad Request - request was not processed due to validation errors","content":{"application/json":{"schema":{"properties":{"meta":{"description":"Additional data","required":["numberOfErrors","numberOfData","status","uniqId"],"properties":{"$ref":"#/paths/~1v2.1~1email~1domain~1blacklist~1{smtp}/get/responses/200/content/application~1json/schema/properties/meta/properties"},"type":"object"},"errors":{"type":"array","items":{"description":"Errors list","required":["title","message","code"],"properties":{"$ref":"#/paths/~1v2.1~1email~1domain~1blacklist~1{smtp}/get/responses/207/content/application~1json/schema/properties/errors/items/properties"},"type":"object"}}},"type":"object"}}}},"404":{"description":"Request was successfully processed but no results were returned","content":{"application/json":{"schema":{"description":"Additional data","required":["numberOfErrors","numberOfData","status","uniqId"],"properties":{"$ref":"#/paths/~1v2.1~1email~1domain~1blacklist~1{smtp}/get/responses/200/content/application~1json/schema/properties/meta/properties"},"type":"object"}}}},"500":{"description":"Request was not processed due to server error","content":{"application/json":{"schema":{"properties":{"meta":{"description":"Additional data","required":["numberOfErrors","numberOfData","status","uniqId"],"properties":{"$ref":"#/paths/~1v2.1~1email~1domain~1blacklist~1{smtp}/get/responses/200/content/application~1json/schema/properties/meta/properties"},"type":"object"}},"type":"object"}}}}}}}}}
```

## Add domains to blacklist

> Use this method to add domains to the blacklist. Each email address with blacklisted domain will be omitted in future transactional email sending.

OpenAPI:

```json
{"openapi":"3.0.0","info":{"title":"MessageFlow API","version":"v2.1.1.0"},"tags":[{"name":"Blacklist","description":"Blacklist API basically allows you to manage email addresses and domains. You can add, update, delete or list receivers addresses or domains on your blacklist. Please be aware that this API can be used only in reference to transactional emails. "}],"servers":[{"url":"https://api.messageflow.com","description":"Production server"}],"security":[{"APIKeyHeader":[],"APPKeyHeader":[]}],"components":{"securitySchemes":{"APIKeyHeader":{"type":"apiKey","name":"Authorization","in":"header"}}},"paths":{"/v2.1/email/domain/blacklist/{smtp}":{"post":{"tags":["Blacklist"],"summary":"Add domains to blacklist","description":"Use this method to add domains to the blacklist. Each email address with blacklisted domain will be omitted in future transactional email sending.","operationId":"AddDomainToBlacklist","parameters":[{"name":"smtp","in":"path","description":"The name of your smtp account","required":true,"schema":{"type":"string"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"description":"The domain you want to use in action.","properties":{"domain":{"description":"Domain to add to blacklist.","type":"string"}},"type":"object"}}}},"responses":{"200":{"description":"Request was successfully processed","content":{"application/json":{"schema":{"properties":{"meta":{"description":"Additional data","required":["numberOfErrors","numberOfData","status","uniqId"],"properties":{"numberOfErrors":{"description":"Number of items in errors section, 0 if section not exists","type":"integer"},"numberOfData":{"description":"Number of items in data section, 0 if section not exists","type":"integer"},"status":{"description":"Request HTTP status","type":"integer"},"uniqId":{"description":"Unique identifier of a request - it allows us to find your request in the case of any troubles","type":"string"}},"type":"object"}},"type":"object"}}}},"207":{"description":"Some of request body items were not processed due to validation errors","content":{"application/json":{"schema":{"properties":{"data":{"description":"Simple data object","type":"array","items":{}},"meta":{"description":"Additional data","required":["numberOfErrors","numberOfData","status","uniqId"],"properties":{"$ref":"#/paths/~1v2.1~1email~1domain~1blacklist~1{smtp}/post/responses/200/content/application~1json/schema/properties/meta/properties"},"type":"object"},"errors":{"type":"array","items":{"description":"Errors list","required":["title","message","code"],"properties":{"title":{"description":"General error name","type":"string"},"message":{"description":"Error details","type":"string"},"code":{"description":"Error code in our system","type":"string"}},"type":"object"}}},"type":"object"}}}},"400":{"description":"Bad Request - request was not processed due to validation errors","content":{"application/json":{"schema":{"properties":{"meta":{"description":"Additional data","required":["numberOfErrors","numberOfData","status","uniqId"],"properties":{"$ref":"#/paths/~1v2.1~1email~1domain~1blacklist~1{smtp}/post/responses/200/content/application~1json/schema/properties/meta/properties"},"type":"object"},"errors":{"type":"array","items":{"description":"Errors list","required":["title","message","code"],"properties":{"$ref":"#/paths/~1v2.1~1email~1domain~1blacklist~1{smtp}/post/responses/207/content/application~1json/schema/properties/errors/items/properties"},"type":"object"}}},"type":"object"}}}},"404":{"description":"Request was successfully processed but no results were returned","content":{"application/json":{"schema":{"description":"Additional data","required":["numberOfErrors","numberOfData","status","uniqId"],"properties":{"$ref":"#/paths/~1v2.1~1email~1domain~1blacklist~1{smtp}/post/responses/200/content/application~1json/schema/properties/meta/properties"},"type":"object"}}}},"500":{"description":"Request was not processed due to server error","content":{"application/json":{"schema":{"properties":{"meta":{"description":"Additional data","required":["numberOfErrors","numberOfData","status","uniqId"],"properties":{"$ref":"#/paths/~1v2.1~1email~1domain~1blacklist~1{smtp}/post/responses/200/content/application~1json/schema/properties/meta/properties"},"type":"object"}},"type":"object"}}}}}}}}}
```

## Delete domains from blacklist

> Use this method to delete domains from the blacklist so addresses email with such domain won’t be omitted in the future transactional email sending.

OpenAPI:

```json
{"openapi":"3.0.0","info":{"title":"MessageFlow API","version":"v2.1.1.0"},"tags":[{"name":"Blacklist","description":"Blacklist API basically allows you to manage email addresses and domains. You can add, update, delete or list receivers addresses or domains on your blacklist. Please be aware that this API can be used only in reference to transactional emails. "}],"servers":[{"url":"https://api.messageflow.com","description":"Production server"}],"security":[{"APIKeyHeader":[],"APPKeyHeader":[]}],"components":{"securitySchemes":{"APIKeyHeader":{"type":"apiKey","name":"Authorization","in":"header"}}},"paths":{"/v2.1/email/domain/blacklist/{smtp}":{"delete":{"tags":["Blacklist"],"summary":"Delete domains from blacklist","description":"Use this method to delete domains from the blacklist so addresses email with such domain won’t be omitted in the future transactional email sending.","operationId":"DeleteBlacklistDomain","parameters":[{"name":"smtp","in":"path","description":"SMTP account","required":true,"schema":{"type":"string"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"id":{"description":"List of domains that should be deleted from blacklist","type":"array","items":{"description":"Domain","type":"string"}}},"type":"object"}}}},"responses":{"200":{"description":"Request was successfully processed","content":{"application/json":{"schema":{"properties":{"meta":{"description":"Additional data","required":["numberOfErrors","numberOfData","status","uniqId"],"properties":{"numberOfErrors":{"description":"Number of items in errors section, 0 if section not exists","type":"integer"},"numberOfData":{"description":"Number of items in data section, 0 if section not exists","type":"integer"},"status":{"description":"Request HTTP status","type":"integer"},"uniqId":{"description":"Unique identifier of a request - it allows us to find your request in the case of any troubles","type":"string"}},"type":"object"}},"type":"object"}}}},"207":{"description":"Some of request body items were not processed due to validation errors","content":{"application/json":{"schema":{"properties":{"data":{"description":"Simple data object","type":"array","items":{}},"meta":{"description":"Additional data","required":["numberOfErrors","numberOfData","status","uniqId"],"properties":{"$ref":"#/paths/~1v2.1~1email~1domain~1blacklist~1{smtp}/delete/responses/200/content/application~1json/schema/properties/meta/properties"},"type":"object"},"errors":{"type":"array","items":{"description":"Errors list","required":["title","message","code"],"properties":{"title":{"description":"General error name","type":"string"},"message":{"description":"Error details","type":"string"},"code":{"description":"Error code in our system","type":"string"}},"type":"object"}}},"type":"object"}}}},"400":{"description":"Bad Request - request was not processed due to validation errors","content":{"application/json":{"schema":{"properties":{"meta":{"description":"Additional data","required":["numberOfErrors","numberOfData","status","uniqId"],"properties":{"$ref":"#/paths/~1v2.1~1email~1domain~1blacklist~1{smtp}/delete/responses/200/content/application~1json/schema/properties/meta/properties"},"type":"object"},"errors":{"type":"array","items":{"description":"Errors list","required":["title","message","code"],"properties":{"$ref":"#/paths/~1v2.1~1email~1domain~1blacklist~1{smtp}/delete/responses/207/content/application~1json/schema/properties/errors/items/properties"},"type":"object"}}},"type":"object"}}}},"404":{"description":"Request was successfully processed but no results were returned","content":{"application/json":{"schema":{"description":"Additional data","required":["numberOfErrors","numberOfData","status","uniqId"],"properties":{"$ref":"#/paths/~1v2.1~1email~1domain~1blacklist~1{smtp}/delete/responses/200/content/application~1json/schema/properties/meta/properties"},"type":"object"}}}},"500":{"description":"Request was not processed due to server error","content":{"application/json":{"schema":{"properties":{"meta":{"description":"Additional data","required":["numberOfErrors","numberOfData","status","uniqId"],"properties":{"$ref":"#/paths/~1v2.1~1email~1domain~1blacklist~1{smtp}/delete/responses/200/content/application~1json/schema/properties/meta/properties"},"type":"object"}},"type":"object"}}}}}}}}}
```

## Get blacklisted email addresses

> Use this method to list all email addresses that are on your blacklist.

OpenAPI:

```json
{"openapi":"3.0.0","info":{"title":"MessageFlow API","version":"v2.1.1.0"},"tags":[{"name":"Blacklist","description":"Blacklist API basically allows you to manage email addresses and domains. You can add, update, delete or list receivers addresses or domains on your blacklist. Please be aware that this API can be used only in reference to transactional emails. "}],"servers":[{"url":"https://api.messageflow.com","description":"Production server"}],"security":[{"APIKeyHeader":[],"APPKeyHeader":[]}],"components":{"securitySchemes":{"APIKeyHeader":{"type":"apiKey","name":"Authorization","in":"header"}}},"paths":{"/v2.1/email/blacklist":{"get":{"tags":["Blacklist"],"summary":"Get blacklisted email addresses","description":"Use this method to list all email addresses that are on your blacklist.","operationId":"BlacklistListing","parameters":[{"name":"offset","in":"query","description":"The number of items omitted from the beginning of the list. Default ‘0’.","required":false,"schema":{"type":"integer","default":"0"}},{"name":"limit","in":"query","description":"The maximum number of items returned by request. Default ‘100’. Maximum ‘1000’.","required":false,"schema":{"type":"integer","default":100,"maximum":1000}},{"name":"smtpAccount","in":"query","description":"The smtp account name.","required":false,"schema":{"type":"string"}}],"responses":{"200":{"description":"Request was successfully processed","content":{"application/json":{"schema":{"properties":{"meta":{"description":"Additional data","required":["numberOfErrors","numberOfData","status","uniqId"],"properties":{"numberOfErrors":{"description":"Number of items in errors section, 0 if section not exists","type":"integer"},"numberOfData":{"description":"Number of items in data section, 0 if section not exists","type":"integer"},"status":{"description":"Request HTTP status","type":"integer"},"uniqId":{"description":"Unique identifier of a request - it allows us to find your request in the case of any troubles","type":"string"}},"type":"object"},"data":{"type":"array","items":{"properties":{"email":{"description":"Email address","type":"string"},"smtpAccount":{"description":"SMTP account","type":"string"},"reason":{"description":"Reason for adding to the blacklist ( from: /email/blacklist/reason )","type":"string"},"comment":{"description":"Comment on the entry","type":"string"},"counter":{"description":"Number of bounces","type":"string"},"createdAt":{"description":"Date of creation","type":"integer"},"updatedAt":{"description":"Last update date","type":"integer"}},"type":"object"}}},"type":"object"}}}},"400":{"description":"Bad Request - request was not processed due to validation errors","content":{"application/json":{"schema":{"properties":{"meta":{"description":"Additional data","required":["numberOfErrors","numberOfData","status","uniqId"],"properties":{"$ref":"#/paths/~1v2.1~1email~1blacklist/get/responses/200/content/application~1json/schema/properties/meta/properties"},"type":"object"},"errors":{"type":"array","items":{"description":"Errors list","required":["title","message","code"],"properties":{"title":{"description":"General error name","type":"string"},"message":{"description":"Error details","type":"string"},"code":{"description":"Error code in our system","type":"string"}},"type":"object"}}},"type":"object"}}}},"404":{"description":"Request was successfully processed but no results were returned","content":{"application/json":{"schema":{"description":"Additional data","required":["numberOfErrors","numberOfData","status","uniqId"],"properties":{"$ref":"#/paths/~1v2.1~1email~1blacklist/get/responses/200/content/application~1json/schema/properties/meta/properties"},"type":"object"}}}},"500":{"description":"Request was not processed due to server error","content":{"application/json":{"schema":{"properties":{"meta":{"description":"Additional data","required":["numberOfErrors","numberOfData","status","uniqId"],"properties":{"$ref":"#/paths/~1v2.1~1email~1blacklist/get/responses/200/content/application~1json/schema/properties/meta/properties"},"type":"object"}},"type":"object"}}}}}}}}}
```

## Add emails to blacklist

> Use this method to add email addresses to the blacklist. Each email address in the blacklist will be omitted in future transactional email sending.

OpenAPI:

```json
{"openapi":"3.0.0","info":{"title":"MessageFlow API","version":"v2.1.1.0"},"tags":[{"name":"Blacklist","description":"Blacklist API basically allows you to manage email addresses and domains. You can add, update, delete or list receivers addresses or domains on your blacklist. Please be aware that this API can be used only in reference to transactional emails. "}],"servers":[{"url":"https://api.messageflow.com","description":"Production server"}],"security":[{"APIKeyHeader":[],"APPKeyHeader":[]}],"components":{"securitySchemes":{"APIKeyHeader":{"type":"apiKey","name":"Authorization","in":"header"}}},"paths":{"/v2.1/email/blacklist":{"post":{"tags":["Blacklist"],"summary":"Add emails to blacklist","description":"Use this method to add email addresses to the blacklist. Each email address in the blacklist will be omitted in future transactional email sending.","operationId":"AddToBlacklist","parameters":[{"name":"email","in":"query","description":"The email address you want to add to the blacklist.","required":true,"schema":{"type":"string"}},{"name":"smtpAccount","in":"query","description":"The name of your smtp account.","required":true,"schema":{"type":"string"}},{"name":"reason","in":"query","description":"The reason for adding the email address to the blacklist. Check all the available reason in List blacklist reasons method.","required":true,"schema":{"type":"string"}},{"name":"comment","in":"query","description":" The additional information on the entry.","schema":{"type":"string"}}],"responses":{"200":{"description":"Request was successfully processed","content":{"application/json":{"schema":{"properties":{"meta":{"description":"Additional data","required":["numberOfErrors","numberOfData","status","uniqId"],"properties":{"numberOfErrors":{"description":"Number of items in errors section, 0 if section not exists","type":"integer"},"numberOfData":{"description":"Number of items in data section, 0 if section not exists","type":"integer"},"status":{"description":"Request HTTP status","type":"integer"},"uniqId":{"description":"Unique identifier of a request - it allows us to find your request in the case of any troubles","type":"string"}},"type":"object"},"data":{"type":"array","items":{"properties":{"email":{"description":"Email address","type":"string"},"smtpAccount":{"description":"SMTP account","type":"string"},"reason":{"description":"Reason for adding to the blacklist ( from: /email/blacklist/reason )","type":"string"},"comment":{"description":"Comment on the entry","type":"string"},"counter":{"description":"Number of bounces","type":"string"},"createdAt":{"description":"Date of creation","type":"integer"},"updatedAt":{"description":"Last update date","type":"integer"}},"type":"object"}}},"type":"object"}}}},"207":{"description":"Some of request body items were not processed due to validation errors","content":{"application/json":{"schema":{"properties":{"data":{"description":"Simple data object","type":"array","items":{}},"meta":{"description":"Additional data","required":["numberOfErrors","numberOfData","status","uniqId"],"properties":{"$ref":"#/paths/~1v2.1~1email~1blacklist/post/responses/200/content/application~1json/schema/properties/meta/properties"},"type":"object"},"errors":{"type":"array","items":{"description":"Errors list","required":["title","message","code"],"properties":{"title":{"description":"General error name","type":"string"},"message":{"description":"Error details","type":"string"},"code":{"description":"Error code in our system","type":"string"}},"type":"object"}}},"type":"object"}}}},"400":{"description":"Bad Request - request was not processed due to validation errors","content":{"application/json":{"schema":{"properties":{"meta":{"description":"Additional data","required":["numberOfErrors","numberOfData","status","uniqId"],"properties":{"$ref":"#/paths/~1v2.1~1email~1blacklist/post/responses/200/content/application~1json/schema/properties/meta/properties"},"type":"object"},"errors":{"type":"array","items":{"description":"Errors list","required":["title","message","code"],"properties":{"$ref":"#/paths/~1v2.1~1email~1blacklist/post/responses/207/content/application~1json/schema/properties/errors/items/properties"},"type":"object"}}},"type":"object"}}}},"404":{"description":"Request was successfully processed but no results were returned","content":{"application/json":{"schema":{"description":"Additional data","required":["numberOfErrors","numberOfData","status","uniqId"],"properties":{"$ref":"#/paths/~1v2.1~1email~1blacklist/post/responses/200/content/application~1json/schema/properties/meta/properties"},"type":"object"}}}},"500":{"description":"Request was not processed due to server error","content":{"application/json":{"schema":{"properties":{"meta":{"description":"Additional data","required":["numberOfErrors","numberOfData","status","uniqId"],"properties":{"$ref":"#/paths/~1v2.1~1email~1blacklist/post/responses/200/content/application~1json/schema/properties/meta/properties"},"type":"object"}},"type":"object"}}}}}}}}}
```

## Delete email addresses from blacklist

> Use this method to delete email addresses from the blacklist so they won’t be omitted in the future transactional email sending.

OpenAPI:

```json
{"openapi":"3.0.0","info":{"title":"MessageFlow API","version":"v2.1.1.0"},"tags":[{"name":"Blacklist","description":"Blacklist API basically allows you to manage email addresses and domains. You can add, update, delete or list receivers addresses or domains on your blacklist. Please be aware that this API can be used only in reference to transactional emails. "}],"servers":[{"url":"https://api.messageflow.com","description":"Production server"}],"security":[{"APIKeyHeader":[],"APPKeyHeader":[]}],"components":{"securitySchemes":{"APIKeyHeader":{"type":"apiKey","name":"Authorization","in":"header"}}},"paths":{"/v2.1/email/blacklist/{smtp}":{"delete":{"tags":["Blacklist"],"summary":"Delete email addresses from blacklist","description":"Use this method to delete email addresses from the blacklist so they won’t be omitted in the future transactional email sending.","operationId":"DeleteBlacklist","parameters":[{"name":"smtp","in":"path","description":"The name of your smtp account.","required":true,"schema":{"type":"string"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"required":["id"],"properties":{"id":{"description":"List of emails that should be deleted from blacklist","type":"array","items":{"type":"string"}}},"type":"object"}}}},"responses":{"200":{"description":"Request was successfully processed","content":{"application/json":{"schema":{"properties":{"meta":{"description":"Additional data","required":["numberOfErrors","numberOfData","status","uniqId"],"properties":{"numberOfErrors":{"description":"Number of items in errors section, 0 if section not exists","type":"integer"},"numberOfData":{"description":"Number of items in data section, 0 if section not exists","type":"integer"},"status":{"description":"Request HTTP status","type":"integer"},"uniqId":{"description":"Unique identifier of a request - it allows us to find your request in the case of any troubles","type":"string"}},"type":"object"}},"type":"object"}}}},"207":{"description":"Some of request body items were not processed due to validation errors","content":{"application/json":{"schema":{"properties":{"data":{"description":"Simple data object","type":"array","items":{}},"meta":{"description":"Additional data","required":["numberOfErrors","numberOfData","status","uniqId"],"properties":{"$ref":"#/paths/~1v2.1~1email~1blacklist~1{smtp}/delete/responses/200/content/application~1json/schema/properties/meta/properties"},"type":"object"},"errors":{"type":"array","items":{"description":"Errors list","required":["title","message","code"],"properties":{"title":{"description":"General error name","type":"string"},"message":{"description":"Error details","type":"string"},"code":{"description":"Error code in our system","type":"string"}},"type":"object"}}},"type":"object"}}}},"400":{"description":"Bad Request - request was not processed due to validation errors","content":{"application/json":{"schema":{"properties":{"meta":{"description":"Additional data","required":["numberOfErrors","numberOfData","status","uniqId"],"properties":{"$ref":"#/paths/~1v2.1~1email~1blacklist~1{smtp}/delete/responses/200/content/application~1json/schema/properties/meta/properties"},"type":"object"},"errors":{"type":"array","items":{"description":"Errors list","required":["title","message","code"],"properties":{"$ref":"#/paths/~1v2.1~1email~1blacklist~1{smtp}/delete/responses/207/content/application~1json/schema/properties/errors/items/properties"},"type":"object"}}},"type":"object"}}}},"404":{"description":"Request was successfully processed but no results were returned","content":{"application/json":{"schema":{"description":"Additional data","required":["numberOfErrors","numberOfData","status","uniqId"],"properties":{"$ref":"#/paths/~1v2.1~1email~1blacklist~1{smtp}/delete/responses/200/content/application~1json/schema/properties/meta/properties"},"type":"object"}}}},"500":{"description":"Request was not processed due to server error","content":{"application/json":{"schema":{"properties":{"meta":{"description":"Additional data","required":["numberOfErrors","numberOfData","status","uniqId"],"properties":{"$ref":"#/paths/~1v2.1~1email~1blacklist~1{smtp}/delete/responses/200/content/application~1json/schema/properties/meta/properties"},"type":"object"}},"type":"object"}}}}}}}}}
```

## List blacklist reasons

> This method allows you to get list of blacklist reasons. At this moment we have provided 4 reasons which are hardbounce, unsubscribe, spam\_complaint and other. Run this method once in a while to check if there are new reasons added.

OpenAPI:

```json
{"openapi":"3.0.0","info":{"title":"MessageFlow API","version":"v2.1.1.0"},"tags":[{"name":"Blacklist","description":"Blacklist API basically allows you to manage email addresses and domains. You can add, update, delete or list receivers addresses or domains on your blacklist. Please be aware that this API can be used only in reference to transactional emails. "}],"servers":[{"url":"https://api.messageflow.com","description":"Production server"}],"security":[{"APIKeyHeader":[],"APPKeyHeader":[]}],"components":{"securitySchemes":{"APIKeyHeader":{"type":"apiKey","name":"Authorization","in":"header"}}},"paths":{"/v2.1/email/blacklist/reason":{"options":{"tags":["Blacklist"],"summary":"List blacklist reasons","description":"This method allows you to get list of blacklist reasons. At this moment we have provided 4 reasons which are hardbounce, unsubscribe, spam_complaint and other. Run this method once in a while to check if there are new reasons added.","operationId":"BlacklistReasonsListing","responses":{"200":{"description":"Request was successfully processed","content":{"application/json":{"schema":{"properties":{"meta":{"description":"Additional data","required":["numberOfErrors","numberOfData","status","uniqId"],"properties":{"numberOfErrors":{"description":"Number of items in errors section, 0 if section not exists","type":"integer"},"numberOfData":{"description":"Number of items in data section, 0 if section not exists","type":"integer"},"status":{"description":"Request HTTP status","type":"integer"},"uniqId":{"description":"Unique identifier of a request - it allows us to find your request in the case of any troubles","type":"string"}},"type":"object"},"data":{"type":"array","items":{"type":"string"}}},"type":"object"}}}},"400":{"description":"Bad Request - request was not processed due to validation errors","content":{"application/json":{"schema":{"properties":{"meta":{"description":"Additional data","required":["numberOfErrors","numberOfData","status","uniqId"],"properties":{"$ref":"#/paths/~1v2.1~1email~1blacklist~1reason/options/responses/200/content/application~1json/schema/properties/meta/properties"},"type":"object"},"errors":{"type":"array","items":{"description":"Errors list","required":["title","message","code"],"properties":{"title":{"description":"General error name","type":"string"},"message":{"description":"Error details","type":"string"},"code":{"description":"Error code in our system","type":"string"}},"type":"object"}}},"type":"object"}}}},"404":{"description":"Request was successfully processed but no results were returned","content":{"application/json":{"schema":{"description":"Additional data","required":["numberOfErrors","numberOfData","status","uniqId"],"properties":{"$ref":"#/paths/~1v2.1~1email~1blacklist~1reason/options/responses/200/content/application~1json/schema/properties/meta/properties"},"type":"object"}}}},"500":{"description":"Request was not processed due to server error","content":{"application/json":{"schema":{"properties":{"meta":{"description":"Additional data","required":["numberOfErrors","numberOfData","status","uniqId"],"properties":{"$ref":"#/paths/~1v2.1~1email~1blacklist~1reason/options/responses/200/content/application~1json/schema/properties/meta/properties"},"type":"object"}},"type":"object"}}}}}}}}}
```
