{"uid":"cap_eGXf9d7e2oZwe1k518Tg9","slug":"2s-io-isin-validator-c6a7a24f","name":"2s.io ISIN Validator","description":"Validate an ISIN (International Securities Identification Number, ISO 6166): 2-letter country prefix + 9-char NSIN + Luhn check digit. Returns {valid, isin, country, nsin, embeddedCusip (for US/CA), checkDigit, reason}. Catches transposed characters in security master data that a regex misses. Structure + checksum only.","url":"https://2s.io/api/validate/isin","method":"GET","headers":{},"bodySchema":{"type":"object","$schema":"https://json-schema.org/draft/2020-12/schema","required":["input"],"properties":{"input":{"type":"object","required":["type","method","queryParams"],"properties":{"type":{"const":"http"},"method":{"const":"GET"},"queryParams":{"required":["isin"],"properties":{"isin":{"type":"string","description":"12-character ISIN (case-insensitive)."}}}}}}},"responseSchema":null,"example":{"request":{"input":{"type":"http","method":"GET","queryParams":{"isin":"US0378331005"}}},"response":{"data":{"ok":true,"items":[{"isin":"US0378331005","nsin":"037833100","input":"US0378331005","valid":true,"reason":null,"country":"US","checkDigit":"5","embeddedCusip":"037833100"}],"total":1,"source":{"url":"https://2s.io","license":"No upstream license — computed by 2s.io","provider":"2s.io ISIN validator"}},"meta":{"cost":{"usd":0.001,"tier":0},"caller":"x402","version":null,"endpoint":"validate.isin","settlement":{"txHash":"0x097ea205090ab2b461d31b34e4cd6ef338859c61035e2a07209a120839aa77ce","network":"eip155:8453","success":true}}}},"exampleRequest":{"isin":"US0378331005"},"tags":["x402"],"displayCostAmount":"0.001","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"settled","requiresHandshake":false,"reviewCount":0,"rating":{"score":"0.00","successRate":"0.00","reviews":0,"stars":null,"state":"unrated"},"availabilityStatus":"unknown","priceObserved":null,"sessionDeposit":null,"pricing":{"kind":"static","summary":"$0.001/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.0025","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.0025","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_13E2-GRqbaAY3vjQTx-7L","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.0025","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Validates a 12-character ISIN (ISO 6166) by checking structure, country prefix, NSIN format, Luhn check digit, and optionally extracts embedded CUSIP for US/CA securities.","exampleAgentPrompt":"Can you check whether US0378331005 is a valid ISIN — I want to know if the structure and checksum are correct and what the embedded CUSIP is?","exampleUseCases":null,"resultDescription":"Returns a JSON object with: valid (boolean), isin (normalized string), country (2-letter ISO code), nsin (9-character national security identifier), embeddedCusip (extracted CUSIP for US/CA ISINs), checkDigit, and reason (human-readable explanation if invalid, e.g. bad checksum or transposed characters).","failureModes":["ISIN not exactly 12 characters — returns valid:false with reason explaining length mismatch","Invalid country prefix (not a recognized ISO 3166 alpha-2 code) — returns valid:false","Luhn check digit mismatch — returns valid:false with reason indicating checksum failure","Non-alphanumeric characters in NSIN segment — returns valid:false","Missing or empty isin query parameter — likely returns 400 or error response","Case-insensitive input accepted but malformed strings still rejected"],"whenToPreferThis":"Use this endpoint when you need to validate ISINs beyond a simple regex — specifically when you need to catch transposed-digit errors in security master data, extract embedded CUSIP identifiers from US or Canadian ISINs, or confirm ISO 6166 Luhn checksum compliance. Prefer this over a regex check whenever data quality or compliance accuracy matters.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-14T00:44:59.038Z","isFirstParty":false}