MIC — Market Identification Code

GET/v0/mic

Validates a Market Identification Code (MIC) as defined in ISO 10383. MIC codes are 4-character uppercase alphabetic identifiers assigned to exchanges, trading platforms, and other organised markets worldwide. When the code is recognised, the response includes the exchange name, country, city, operating MIC, market type, and operational status.

Try it

Query Parameters

Parameter	Type	Required	Description
value	string	Yes	The MIC code to validate (e.g. `XNYS`, `XLON`). Input is case-insensitive.

Example Request

curl -H "Authorization: Bearer YOUR_API_KEY" \
  "https://api.isvalid.dev/v0/mic?value=XNYS"

Response Fields

Field	Type	Description
valid	boolean	Whether the value matches the MIC format (4 uppercase letters)
found	boolean	Whether the MIC is present in the built-in directory. Absent when `valid` is `false`
mic	string	Normalised (uppercase) MIC code. Present only when `found` is `true`
operatingMic	string	The operating MIC. Equal to `mic` for operating venues; points to the parent venue for market segments
name	string	Full name of the exchange or trading venue
type	string	Market type: `OPRT` (operating venue) or `SGMT` (market segment)
status	string	Operational status: `ACTV` (active), `TERM` (terminated), `EXPI` (expired), `MODI` (modified/renamed)
countryCode	string	ISO 3166-1 alpha-2 country code of the exchange
countryName	string \| null	Full English name of the country
city	string	City where the exchange is located
website	string \| null	Exchange website, or `null` if not available

Example Response — known MIC

{
  "valid": true,
  "found": true,
  "mic": "XNYS",
  "operatingMic": "XNYS",
  "name": "New York Stock Exchange",
  "type": "OPRT",
  "status": "ACTV",
  "countryCode": "US",
  "countryName": "United States",
  "city": "New York",
  "website": "www.nyse.com"
}

Example Response — segment MIC

{
  "valid": true,
  "found": true,
  "mic": "XETR",
  "operatingMic": "XFRA",
  "name": "XETRA",
  "type": "SGMT",
  "status": "ACTV",
  "countryCode": "DE",
  "countryName": "Germany",
  "city": "Frankfurt",
  "website": "www.xetra.com"
}

Example Response — unknown MIC

{
  "valid": true,
  "found": false
}

Example Response — invalid format

{
  "valid": false
}