ISIN check API
Check the structure and check digit of an ISIN (ISO 6166) and split it into prefix, national number and check digit.
POST https://api.curatedapi.com/v1/calc/check/isin
- Version 1
- MCP tool
calc_check_isin - Try it in the browser
Checks an International Securities Identification Number as ISO 6166 defines it: a two-letter prefix, a nine-character national securities number and a check digit worked out with the Luhn rule after the letters are turned into numbers.
Formula
turn each letter into two digits (A = 10 … Z = 35), then apply the Luhn rule: double every second digit from the right, add all digits, and the total must be a multiple of 10
- The number is checked by arithmetic alone. Nothing is looked up, so a valid result means the number is well formed, not that the account, company or security exists.
Inputs
Send numbers as strings to keep every digit. options sets precision and rounding (see numbers and rounding).
| Input | Type | Description |
|---|---|---|
number required |
string | The 12-character ISIN. Spaces, dots, hyphens and slashes are ignored, and lower-case letters are read as upper case. At most 64 characters. |
Result
Under result in the answer, next to exactness, precision, inputs, formula, references and warnings.
| Result | Type | Description |
|---|---|---|
valid | boolean | Whether the ISIN passes every check. |
normalized | string | The number as it was checked: separators removed, letters in upper case. |
problem | string | What is wrong, when valid is false: CHARACTERS: a character that cannot appear in this kind of number; LENGTH: the wrong number of characters; COUNTRY: an unknown or unsupported country code; FORMAT: the right length but the wrong structure; CHECK_DIGIT: the check digit or check characters do not match the rest of the number. |
message | string | The result in a sentence, naming the rule that failed. |
prefix | string | The first two letters. |
prefix_country | string | The country the prefix stands for, when it is an ISO 3166 code. Prefixes such as XS (international securities) are not countries. |
nsin | string | The national securities number. |
check_digit | string | The last character. |
expected_check_digit | string | The check digit the first eleven characters give. |
Examples
Apple Inc. common stock
curl https://api.curatedapi.com/v1/calc/check/isin \
-H "Authorization: Bearer $CURATEDAPI_KEY" \
-H "Content-Type: application/json" \
-d '{
"number": "US0378331005"
}'
{
"calculator": "check/isin@1",
"result": {
"valid": true,
"normalized": "US0378331005",
"message": "A well-formed ISIN with the prefix of United States.",
"prefix": "US",
"prefix_country": "United States",
"nsin": "037833100",
"check_digit": "5",
"expected_check_digit": "5"
},
"exactness": {},
"precision": null,
"inputs": {
"number": "US0378331005"
},
"formula": "turn each letter into two digits (A = 10 … Z = 35), then apply the Luhn rule: double every second digit from the right, add all digits, and the total must be a multiple of 10",
"references": [
{
"title": "ISO 6166:2021 International securities identification number (ISIN)",
"url": "https://www.iso.org/standard/78502.html"
},
{
"title": "ANNA: ISIN, structure and check digit",
"url": "https://www.anna-web.org/standards/isin-iso-6166/"
}
],
"warnings": []
}
Wrong check digit
curl https://api.curatedapi.com/v1/calc/check/isin \
-H "Authorization: Bearer $CURATEDAPI_KEY" \
-H "Content-Type: application/json" \
-d '{
"number": "US0378331004"
}'
{
"calculator": "check/isin@1",
"result": {
"valid": false,
"normalized": "US0378331004",
"problem": "CHECK_DIGIT",
"message": "The check digit is 4, but the first eleven characters give 5.",
"prefix": "US",
"prefix_country": "United States",
"nsin": "037833100",
"check_digit": "4",
"expected_check_digit": "5"
},
"exactness": {},
"precision": null,
"inputs": {
"number": "US0378331004"
},
"formula": "turn each letter into two digits (A = 10 … Z = 35), then apply the Luhn rule: double every second digit from the right, add all digits, and the total must be a multiple of 10",
"references": [
{
"title": "ISO 6166:2021 International securities identification number (ISIN)",
"url": "https://www.iso.org/standard/78502.html"
},
{
"title": "ANNA: ISIN, structure and check digit",
"url": "https://www.anna-web.org/standards/isin-iso-6166/"
}
],
"warnings": []
}
References
- ISO 6166:2021 International securities identification number (ISIN)
- ANNA: ISIN, structure and check digit
Results follow each calculator's documented rules and the sources listed. They are not financial, tax or legal advice. Check that the rules fit your case before you rely on a result. See the terms.
Errors share one format; see errors. Billing, retries and batches work the same for every endpoint.