sanction

Access the API

To start using Scorechain's Free Sanctions Screening API, use https://sanctions.api.scorechain.com as host URL.

GET /v1/addresses/{address}

Returns for the address given in path if the address has been listed in an official sanction list and if yes information relative to the sanction

Authorizations

To access this endpoint, you must obtain an API key:

1. Visit this link and fill out the form to request an API key.
2. Once you have the API key, include it in the request header using the key "x-api-key".

Rate limitation

The sanction endpoint is rate limited to 100 requests per hours. If you exceed this limit, the API will return a 429 Too Many Requests response. We recommend implementing exponential backoff or request queuing in your integration to stay within the allowed threshold.

Path Parameters

• address (string, required): The cryptocurrency address to check for sanctions. This could be an Ethereum, Bitcoin, or other blockchain address. Ensure the address is a valid format for the respective blockchain.

Response Parameters

Name	Type	Nullable	Description
isSanctioned	boolean	No	Boolean field indicating if the address provided has been sanctioned.
name	string	Yes	The name of the sanctioned organization or individual.
sanctionDate	number	Yes	Timestamp representing the date of the sanction.
prettySanctionDate	string	Yes	Human-readable date representing the date of the sanction.
blockchain	string	Yes	The blockchain protocol on which the sanction has been applied.

Response Example

Success

[
  {
    isSanctioned: true,
    details: {
      name: "Iranvisacart - Khorashadizadeh Ali - Mastercartaria (OFAC)",
      sanctionDate: 1587562485,
      prettySanctionDate: "2020-04-22T13:34:45.000Z",
      blockchain: "Bitcoin"
    }
  }
]