> 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/de/api-documentation/address-screening/screen-a-single-address.md).

# Eine einzelne Adresse prüfen

Prüfen Sie eine einzelne Adresse mit allen derzeit verfügbaren Risikomodulen und geben Sie die Prüfergebnisse zurück. Dauert die Prüfung länger als 10 Sekunden, wird sie zu einer asynchronen Aufgabe und es wird eine Task ID zurückgegeben.

## Screen a single address

> Screen one address synchronously or asynchronously, based on your account settings.

```json
{"openapi":"3.0.0","info":{"title":"Compliance API","version":"2.0.0"},"tags":[{"name":"Address Screen","description":"Address screening and retrieval 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":{"AddressScreen":{"type":"object","required":["address","chainId"],"properties":{"address":{"type":"string","description":"The address to be screened."},"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)."},"includeDetails":{"type":"boolean","deprecated":true,"description":"Deprecated. Whether to include the legacy riskDetail field on every alert. Defaults to false."}}},"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."}}},"AddressScreenResult":{"type":"object","properties":{"address":{"type":"string","description":"The target address that been screened."},"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)."},"chainName":{"type":"string","description":"The blockchain name."},"label":{"type":"string","description":"Label of the target address, if avaliable."},"entity":{"type":"string","description":"The entity associated with the address (e.g., \"Binance\")."},"category":{"type":"array","description":"Categories associated with the entity (e.g., [\"Exchange\", \"OTC Desk\"]).","items":{"type":"string"}},"systemTags":{"type":"array","description":"Predefined tags for the address from the address label database (e.g., \"Deposit Address\").","items":{"type":"string"}},"userTags":{"type":"array","description":"Custom tags added by the user for the address.","items":{"type":"string"}},"customerId":{"type":"string","description":"The customer ID associated with the address."},"riskLevel":{"type":"integer","description":"The assessment risk level of the screened address. Values: 1 = critical, 2 = high, 3 = medium, 4 = low, 5 = info, 6 = noRisk. A lower number means higher severity. 6 means screening completed and no alert was triggered.","enum":[1,2,3,4,5,6]},"riskLevelDescription":{"type":"string","description":"The description of the risk level."},"isBlacklisted":{"type":"boolean","deprecated":true,"description":"Deprecated. Whether the address is in your blacklist. Use `riskProfile.entityRisks` (type=blacklist) instead."},"blacklistedInfo":{"type":"string","deprecated":true,"description":"Deprecated. Details about the blacklist status. Use `riskProfile.entityRisks` (type=blacklist) instead."},"isWhitelisted":{"type":"boolean","deprecated":true,"description":"Deprecated. Whether the address is in your whitelist. Use `riskProfile.entityRisks` (type=whitelist) instead."},"whitelistedInfo":{"type":"string","deprecated":true,"description":"Deprecated. Details about the whitelist status. Use `riskProfile.entityRisks` (type=whitelist) instead."},"lastScreenAt":{"type":"integer","format":"int64","description":"UNIX timestamp of the most recent screening of the address, in seconds."},"screeningCount":{"type":"integer","description":"The total number of screenings for the address."},"unresolvedAlerts":{"type":"integer","description":"The number of unresolved alerts associated with the address."},"riskProfile":{"$ref":"#/components/schemas/RiskProfile","description":"The consolidated risk findings for the address, organized by category (entity risks, interaction risks, behavior risks). Always returned, independent of includeDetails. **Important: This field only reflects currently active alerts. Expired alerts are excluded, so it may not represent the full historical risk picture.**"},"alerts":{"type":"array","description":"The alerts associated with the address.","items":{"$ref":"#/components/schemas/AddressScreenAlert"}},"taskId":{"description":"The unique identifier for the screening task. Always returned for both synchronous and asynchronous results."}}},"RiskProfile":{"type":"object","description":"The consolidated risk findings, organized by category. Always returned. Expired alerts are excluded.","properties":{"entityRisks":{"type":"array","description":"Entity-level risks: risk indicators the address/participant is directly labeled with, plus blacklist/whitelist membership.","items":{"$ref":"#/components/schemas/EntityRisk"}},"interactionRisks":{"type":"array","description":"Risk exposure through fund flows to risky counterparties, grouped by indicator and direction.","items":{"$ref":"#/components/schemas/InteractionRisk"}},"behaviorRisks":{"type":"array","description":"Behavioral risks detected on the address/transaction.","items":{"$ref":"#/components/schemas/BehaviorRisk"}}}},"EntityRisk":{"type":"object","properties":{"type":{"type":"string","description":"The kind of entity risk.","enum":["riskIndicator","blacklist","whitelist"]},"riskLevel":{"type":"integer","nullable":true,"description":"The risk level. Null for list-membership entries (e.g. blacklist) that are not scored. Values: 1 = critical, 2 = high, 3 = medium, 4 = low, 5 = info. A lower number means higher severity.","enum":[1,2,3,4,5,null]},"riskLevelDescription":{"type":"string","description":"The description of the risk level."},"triggered":{"type":"boolean","description":"Whether this risk is triggered."},"alertIds":{"type":"array","description":"The alerts that contributed to this entity risk.","items":{"type":"string"}},"riskIndicator":{"type":"integer","description":"The risk indicator. Present when type is riskIndicator. Values: 1 = Sanctioned, 2 = Attack, 3 = Scam, 4 = Ransomware, 5 = Child Abuse Material, 6 = Laundering, 7 = Mixing, 8 = Dark Market, 9 = Darkweb Business, 10 = Blocked, 11 = Gambling, 12 = No KYC Exchange, 13 = Terrorist Financing, 14 = FATF Grey List Jurisdiction, 15 = FATF High Risk Jurisdiction, 16 = Human Trafficking, 17 = Drug Trafficking.","enum":[1,2,3,4,5,6,7,8,9,10,11,12,13,14,15,16,17]},"riskIndicatorDescription":{"type":"string","description":"The description of the risk indicator. Present when type is riskIndicator."},"detail":{"type":"array","description":"Supplementary information. Present when type is riskIndicator.","items":{"type":"string"}},"listName":{"type":"string","description":"The name of the list. Present when type is blacklist or whitelist."},"reason":{"type":"string","description":"The reason the address was added to the list. Present when type is blacklist or whitelist."},"operator":{"type":"string","description":"Who added the address to the list. Present when type is blacklist or whitelist."},"addedAt":{"type":"integer","format":"int64","description":"When the address was added to the list, as a UNIX timestamp in milliseconds. Present when type is blacklist or whitelist."},"address":{"type":"string","description":"The participating address this risk belongs to. Transaction API only."},"label":{"type":"string","description":"The label of the participating address, if available. Transaction API only."}}},"InteractionRisk":{"type":"object","properties":{"indicator":{"type":"integer","description":"The risk indicator of the exposure. 0 for user-blacklist exposure. Values: 0 = User Blacklist, 1 = Sanctioned, 2 = Attack, 3 = Scam, 4 = Ransomware, 5 = Child Abuse Material, 6 = Laundering, 7 = Mixing, 8 = Dark Market, 9 = Darkweb Business, 10 = Blocked, 11 = Gambling, 12 = No KYC Exchange, 13 = Terrorist Financing, 14 = FATF Grey List Jurisdiction, 15 = FATF High Risk Jurisdiction, 16 = Human Trafficking, 17 = Drug Trafficking.","enum":[0,1,2,3,4,5,6,7,8,9,10,11,12,13,14,15,16,17]},"indicatorDescription":{"type":"string","description":"The description of the indicator (e.g. \"User Blacklist\" for blacklist exposure)."},"direction":{"type":"integer","description":"The direction of the exposure. Values: 1 = Incoming, 2 = Outgoing.","enum":[1,2]},"riskLevel":{"type":"integer","description":"The risk level. Values: 1 = critical, 2 = high, 3 = medium, 4 = low, 5 = info. A lower number means higher severity.","enum":[1,2,3,4,5]},"riskLevelDescription":{"type":"string","description":"The description of the risk level."},"direct":{"$ref":"#/components/schemas/ExposurePart","description":"Direct exposure (hop 1)."},"indirect":{"$ref":"#/components/schemas/ExposurePart","description":"Indirect exposure (hop 2+)."},"total":{"$ref":"#/components/schemas/ExposureTotal","description":"Total exposure."},"minHop":{"type":"integer","description":"The minimum number of hops to reach the risk source. 1 if there is any direct exposure; otherwise the minimum hop of the indirect exposure."},"triggered":{"type":"boolean","description":"Whether this exposure is triggered."},"alertIds":{"type":"array","description":"The alerts that contributed to this exposure.","items":{"type":"string"}}}},"ExposurePart":{"type":"object","properties":{"exposureValue":{"type":"string","description":"The exposure value in USD."},"exposurePercent":{"type":"number","description":"The exposure as a decimal ratio (0 to 1, where 1 means 100%)."},"triggered":{"type":"boolean","description":"Whether this part of the exposure is triggered."},"minHop":{"type":"integer","description":"The minimum number of hops to reach the risk source. Only present for indirect exposure."}}},"ExposureTotal":{"type":"object","properties":{"exposureValue":{"type":"string","description":"The total exposure value in USD."},"exposurePercent":{"type":"number","description":"The total exposure as a decimal ratio (0 to 1, where 1 means 100%)."}}},"BehaviorRisk":{"type":"object","properties":{"behaviorType":{"type":"string","description":"The kind of behavior risk. RapidTransit is only produced by the transaction API.","enum":["LargeTransfer","HighFrequencyTransfer","TransitAddress","RapidTransit"]},"riskLevel":{"type":"integer","description":"The risk level. Values: 1 = critical, 2 = high, 3 = medium, 4 = low, 5 = info. A lower number means higher severity.","enum":[1,2,3,4,5]},"riskLevelDescription":{"type":"string","description":"The description of the risk level."},"triggered":{"type":"boolean","description":"Whether this behavior risk is triggered."},"alertIds":{"type":"array","description":"The alerts that contributed to this behavior risk.","items":{"type":"string"}},"fields":{"$ref":"#/components/schemas/BehaviorRiskFields","description":"Behavior-specific fields; the populated subset depends on behaviorType."}}},"BehaviorRiskFields":{"type":"object","description":"Behavior-specific fields. Address API (aggregated over events): LargeTransfer uses maxValue, matchedEvents; HighFrequencyTransfer uses transferCount, timeWindow, avgInterval, matchedEvents; TransitAddress uses maxValue, timeWindow, matchedEvents. Transaction API (single event): LargeTransfer uses value, amount, token; RapidTransit uses value, timeWindow.","properties":{"maxValue":{"type":"string","description":"The largest single-transfer USD value (address API)."},"matchedEvents":{"type":"integer","description":"The number of matched events (address API)."},"transferCount":{"type":"integer","description":"The number of transfers (HighFrequencyTransfer)."},"timeWindow":{"type":"integer","description":"The time window in seconds."},"avgInterval":{"type":"integer","description":"The average interval between transfers in seconds (HighFrequencyTransfer)."},"value":{"type":"string","description":"The USD value of the event (transaction API)."},"amount":{"type":"string","description":"The token amount transferred (transaction API, optional)."},"token":{"type":"string","description":"The token symbol (transaction API, optional)."}}},"AddressScreenAlert":{"type":"object","properties":{"alertId":{"type":"string","description":"The unique identifier for the alert."},"status":{"type":"integer","description":"The status of the alert. Values: 1 = unresolved, 2 = resolved, 3 = expired.","enum":[1,2,3]},"statusDescription":{"type":"string","description":"The description of the alert status."},"riskLevel":{"type":"integer","description":"The risk level of the alert. Values: 1 = critical, 2 = high, 3 = medium, 4 = low, 5 = info. A lower number means higher severity.","enum":[1,2,3,4,5]},"riskLevelDescription":{"type":"string","description":"The description of the risk level."},"description":{"type":"string","description":"The description of the alert."},"firstTriggeredAt":{"type":"integer","format":"int64","description":"The time the alert was first triggered, as a UNIX timestamp in seconds."},"lastUpdatedAt":{"type":"integer","format":"int64","description":"The time the alert was last updated, as a UNIX timestamp in seconds."},"riskActivityTime":{"type":"integer","format":"int64","description":"The time of the latest risk activity related to the alert, as a UNIX timestamp in seconds."},"riskEngineId":{"type":"string","description":"The unique identifier of the Risk Engine that generated the alert."},"riskEngineName":{"type":"string","description":"The name of the Risk Engine that generated the alert."},"riskDetail":{"type":"array","deprecated":true,"description":"Deprecated. The per-alert detail, returned only when includeDetails is set to true. Use the top-level `riskProfile` instead.","items":{"oneOf":[{"$ref":"#/components/schemas/EntityRiskData"},{"$ref":"#/components/schemas/InteractionRiskData"},{"$ref":"#/components/schemas/LargeTransferData"},{"$ref":"#/components/schemas/HighFrequencyData"},{"$ref":"#/components/schemas/TransitAddressData"},{"$ref":"#/components/schemas/BlacklistInteractionData"},{"$ref":"#/components/schemas/ParticipantRiskData"},{"$ref":"#/components/schemas/RapidTransitData"}]}}}},"EntityRiskData":{"type":"object","properties":{"riskIndicator":{"type":"integer","description":"The risk indicator of the alert. Values: 1 = Sanctioned, 2 = Attack, 3 = Scam, 4 = Ransomware, 5 = Child Abuse Material, 6 = Laundering, 7 = Mixing, 8 = Dark Market, 9 = Darkweb Business, 10 = Blocked, 11 = Gambling, 12 = No KYC Exchange, 13 = Terrorist Financing, 14 = FATF Grey List Jurisdiction, 15 = FATF High Risk Jurisdiction, 16 = Human Trafficking, 17 = Drug Trafficking.","enum":[1,2,3,4,5,6,7,8,9,10,11,12,13,14,15,16,17]},"riskIndicatorDescription":{"type":"string","description":"The description of the risk indicator."},"detail":{"type":"array","description":"The supplementary information.","items":{"type":"string"}}}},"InteractionRiskData":{"type":"object","properties":{"riskIndicator":{"type":"integer","description":"The risk indicator of the alert. Values: 1 = Sanctioned, 2 = Attack, 3 = Scam, 4 = Ransomware, 5 = Child Abuse Material, 6 = Laundering, 7 = Mixing, 8 = Dark Market, 9 = Darkweb Business, 10 = Blocked, 11 = Gambling, 12 = No KYC Exchange, 13 = Terrorist Financing, 14 = FATF Grey List Jurisdiction, 15 = FATF High Risk Jurisdiction, 16 = Human Trafficking, 17 = Drug Trafficking.","enum":[1,2,3,4,5,6,7,8,9,10,11,12,13,14,15,16,17]},"riskIndicatorDescription":{"type":"string","description":"The description of the risk indicator."},"direction":{"type":"integer","description":"The direction of the interaction. Values: 1 = Incoming, 2 = Outgoing.","enum":[1,2]},"hop":{"type":"integer","description":"The hop of the interaction."},"exposureValue":{"type":"string","description":"The exposure value of the interaction."},"exposurePercent":{"type":"string","description":"The exposure of the interaction as a decimal ratio (0 to 1, where 1 means 100%)."},"contributions":{"type":"array","description":"The contributions of the interaction.","items":{"type":"object","properties":{"detail":{"type":"string","description":"The detail of the contribution."},"address":{"type":"string","description":"The address of the contribution."},"label":{"type":"string","description":"The label of the address, if available."},"hop":{"type":"integer","description":"The hop of the contribution."},"exposureValue":{"type":"string","description":"The exposure value of the contribution."},"exposurePercent":{"type":"number","description":"The exposure of the contribution as a decimal ratio (0 to 1, where 1 means 100%)."},"chainId":{"description":"The chain ID of the contributing address."}}}}}},"LargeTransferData":{"type":"object","properties":{"transaction":{"type":"string","description":"The transaction hash."},"usdValue":{"type":"string","description":"The USD value of the transfer."},"direction":{"type":"integer","description":"The direction of the transfer. Values: 1 = Incoming, 2 = Outgoing.","enum":[1,2]},"timestamp":{"type":"integer","format":"int64","description":"The time of the transfer, as a UNIX timestamp in seconds."},"token":{"type":"string","description":"The token address."},"tokenSymbol":{"type":"string","description":"The symbol of the token."},"tokenAmount":{"type":"string","description":"The amount of the token transferred."}}},"HighFrequencyData":{"type":"object","properties":{"transactionCount":{"type":"integer","description":"The number of transactions in the high-frequency series."},"duration":{"type":"integer","description":"The duration of the high-frequency series."},"transactionList":{"type":"array","description":"The list of transactions in the high-frequency series.","items":{"$ref":"#/components/schemas/TransactionItem"}}}},"TransactionItem":{"$ref":"#/components/schemas/LargeTransferData"},"TransitAddressData":{"type":"object","properties":{"inTransaction":{"type":"string","description":"The transaction hash."},"inTimestamp":{"type":"string","description":"The time of the incoming transaction, as a UNIX timestamp in seconds."},"inUsdValue":{"type":"string","description":"The USD value of the transaction."},"outTransaction":{"type":"string","description":"The transaction hash."},"outTimestamp":{"type":"string","description":"The time of the outgoing transaction, as a UNIX timestamp in seconds."},"outUsdValue":{"type":"string","description":"The USD value of the transaction."},"transitPercent":{"type":"string","description":"The transit percent of the transaction."}}},"BlacklistInteractionData":{"type":"object","properties":{"transaction":{"type":"string","description":"The transaction hash."},"usdValue":{"type":"string","description":"The USD value of the transaction."},"timestamp":{"type":"string","description":"The time of the transaction, as a UNIX timestamp in seconds."},"direction":{"type":"integer","description":"The direction of the transaction. Values: 1 = Incoming, 2 = Outgoing.","enum":[1,2]},"fromAddress":{"type":"string","description":"The address of the sender."},"toAddress":{"type":"string","description":"The address of the receiver."},"token":{"type":"string","description":"The token address."},"tokenSymbol":{"type":"string","description":"The symbol of the token."},"tokenAmount":{"type":"string","description":"The amount of the token transferred."}}},"ParticipantRiskData":{"type":"object","properties":{"address":{"type":"string","description":"The address of the participant."},"riskIndicator":{"type":"integer","description":"The risk indicator of the participant."},"riskIndicatorDescription":{"type":"string","description":"The description of the risk indicator."},"detail":{"type":"array","description":"The supplementary information.","items":{"type":"string"}}}},"RapidTransitData":{"type":"object","properties":{"proceedTransaction":{"type":"object","description":"The transaction data.","$ref":"#/components/schemas/LargeTransferData"},"screenedTransaction":{"type":"object","description":"The transaction data.","$ref":"#/components/schemas/LargeTransferData"}}},"AddressScreenTaskResult":{"type":"object","properties":{"taskId":{"type":"string","description":"The unique identifier for the task."}}}}},"paths":{"/address/screen":{"post":{"tags":["Address Screen"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/AddressScreen"}}}},"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":{"oneOf":[{"$ref":"#/components/schemas/AddressScreenResult"},{"$ref":"#/components/schemas/AddressScreenTaskResult"}]}}}}}},"401":{"description":"Authentication failed. The `API-Key` header is missing or invalid."},"429":{"description":"Rate limit exceeded. Reduce the request rate and retry."}},"description":"Screen one address synchronously or asynchronously, based on your account settings.","summary":"Screen a single address"}}}}
```
