# Company
Company information and metadata
## Search Companies
> Search for companies by name or ticker symbol. Returns a list of companies matching the search query.\
> A maximum of 10 results will be returned. The most relevant results are returned first.\
> \
> \
> Pricing (depending on the response received):\
> \- 200 : 1\
> \- Other responses (40x, 50x): Free of charge
````json
{"openapi":"3.0.0","info":{"title":"Tracenable API","version":"1.0.0"},"tags":[{"name":"company","description":"Company information and metadata"}],"servers":[{"url":"https://tracenable.com","description":"Tracenable Production Server"}],"security":[{"BearerAuth":[]}],"components":{"securitySchemes":{"BearerAuth":{"type":"http","scheme":"bearer","bearerFormat":"JWT","description":"JWT bearer token used for authentication.\n\n**Test token (no charges apply; responses contain mock data):**\n```\nBearer sk_test_tracenable\n```"}}},"paths":{"/api/v1/companies/search":{"get":{"summary":"Search Companies","description":"Search for companies by name or ticker symbol. Returns a list of companies matching the search query.\nA maximum of 10 results will be returned. The most relevant results are returned first.\n\n\n Pricing (depending on the response received):\n- 200 : 1\n- Other responses (40x, 50x): Free of charge\n","tags":["company"],"operationId":"searchCompanies","parameters":[{"schema":{"type":"string","minLength":1,"maxLength":100,"description":"Search query for company name or ticker symbol"},"required":true,"description":"Search query for company name or ticker symbol","name":"query","in":"query"}],"responses":{"200":{"description":"List of companies matching the search query","headers":{"X-Credit-Cost":{"description":"Number of credits consumed for this request.","schema":{"type":"integer"}},"X-Credit-Balance":{"description":"Number of remaining credits after this request.","schema":{"type":"integer"}}},"content":{"application/json":{"schema":{"type":"array","items":{"type":"object","properties":{"company_id":{"type":"string","format":"uuid","description":"Unique identifier for the company"},"company_name":{"type":"string","description":"Full name of the company"},"ticker":{"type":"string","nullable":true,"description":"Ticker symbol of the company"},"mic_code":{"type":"string","nullable":true,"enum":["XAMM","XMLI","ALXP","XDUB","XNCO","XMAU","VPXB","FNLT","AQSG","XKUW","XWAR","XTRN","XAMS","XDHA","XZAG","XPRM","XKRX","NOTC","FSME","MTAA","XSHG","XSAU","XLUX","XBOG","SCLE","XSES","XJSE","XXXX","GROW","XNSE","OTCM","XTAI","BJSE","RUSX","XFRA","XHEL","MISX","XNCM","XEQY","XRIS","ZBUL","XDFM","HAMN","XMAI","XNSA","WBDM","XMAE","XBER","XLJM","XCAI","XBUE","XHKG","XNYS","MERK","AIXK","XOAS","ENAX","XADS","XLJU","XTKS","XBOM","XKLS","ARCX","XKAZ","XBRN","XPHS","XKAR","NSME","XSAT","XZIM","XTSE","XNMS","XBIL","XMUN","XIDX","BATS","XNGS","ALXB","ENXL","XSHE","XBAR","XNZE","XBSE","XLIS","XHAM","XLIT","AQST","XCSE","XSGO","XSTO","XNAI","XSTC","SSME","XCNQ","XLIM","DSME","XBKK","XCOL","XGUA","XMAL","DSMD","XASE","ROCO","XDUS","XBAH","HSTC","XBUD","FNIS","XSTU","XCYS","XMAD","XLON","XBRA","XKOS","EXGM","XCAN","XICE","XBRU","ABUL","XTAE","XTSX","XCAS","BVMF","XMEX","XSWX","XHNX","FNLV","XATH","XETR","XPRA","XPAR","HMOD","XNGM","XBEL","XOSL","XMUS","XTAL","XASX","WBAH","NEOE",null],"description":"Market Identifier Code (MIC) of the company"},"country":{"type":"string","nullable":true,"enum":["Afghanistan","Åland","Albania","Algeria","American Samoa","Andorra","Angola","Anguilla","Antarctica","Antigua and Barbuda","Argentina","Armenia","Aruba","Australia","Austria","Azerbaijan","Bahamas","Bahrain","Bangladesh","Barbados","Belarus","Belgium","Belize","Benin","Bermuda","Bhutan","Bolivia","Bonaire, Sint Eustatius, and Saba","Bosnia and Herzegovina","Botswana","Bouvet Island","Brazil","British Indian Ocean Territory","British Virgin Islands","Brunei","Bulgaria","Burkina Faso","Burundi","Cabo Verde","Cambodia","Cameroon","Canada","Cayman Islands","Central African Republic","Chad","Chile","China","China (Mainland)","Christmas Island","Cocos (Keeling) Islands","Colombia","Comoros","Congo Republic","Cook Islands","Costa Rica","Croatia","Cuba","Curacao","Cyprus","Czechia","Denmark","Djibouti","Dominica","Dominican Republic","DR Congo","Ecuador","Egypt","El Salvador","Equatorial Guinea","Eritrea","Estonia","Eswatini","Ethiopia","Falkland Islands","Faroe Islands","Fiji","Finland","France","French Guiana","French Polynesia","French Southern Territories","Gabon","Georgia","Germany","Ghana","Gibraltar","Greece","Greenland","Grenada","Guadeloupe","Guam","Guatemala","Guernsey","Guinea-Bissau","Guinea","Guyana","Haiti","Heard and McDonald Islands","Honduras","Hong Kong","Hungary","Iceland","India","Indonesia","Iran","Iraq","Ireland","Isle of Man","Israel","Italy","Ivory Coast","Jamaica","Japan","Jersey","Jordan","Kazakhstan","Kenya","Kiribati","Kosovo","Kuwait","Kyrgyzstan","Laos","Latvia","Lebanon","Lesotho","Liberia","Libya","Liechtenstein","Lithuania","Luxembourg","Macau","Macedonia (the former Yugoslav Republic of)","Madagascar","Malawi","Malaysia","Maldives","Mali","Malta","Marshall Islands","Martinique","Mauritania","Mauritius","Mayotte","Mexico","Micronesia","Moldova","Monaco","Mongolia","Montenegro","Montserrat","Morocco","Mozambique","Myanmar","Namibia","Nauru","Nepal","New Caledonia","New Zealand","Nicaragua","Niger","Nigeria","Niue","Norfolk Island","North Korea","North Macedonia","Northern Mariana Islands","Norway","Oman","Pakistan","Palau","Palestine","Panama","Papua New Guinea","Paraguay","Peru","Philippines","Pitcairn Islands","Poland","Portugal","Puerto Rico","Qatar","Reunion","Romania","Russia","Rwanda","Saint Barthélemy","Saint Helena","Saint Lucia","Saint Martin","Saint Pierre and Miquelon","Samoa","San Marino","São Tomé and Príncipe","Saudi Arabia","Senegal","Serbia","Seychelles","Sierra Leone","Singapore","Sint Maarten","Slovakia","Slovenia","Solomon Islands","Somalia","South Africa","South Georgia and South Sandwich Islands","South Korea","South Sudan","Spain","Sri Lanka","St Kitts and Nevis","St Vincent and Grenadines","Sudan","Suriname","Svalbard and Jan Mayen","Sweden","Switzerland","Syria","Taiwan","Tajikistan","Tanzania","Thailand","Gambia","Netherlands","Timor-Leste","Togo","Tokelau","Tonga","Trinidad and Tobago","Tunisia","Turkey","Turkmenistan","Turks and Caicos Islands","Tuvalu","U.S. Outlying Islands","U.S. Virgin Islands","Uganda","Ukraine","United Arab Emirates","United Kingdom","United States","Uruguay","Uzbekistan","Vanuatu","Vatican City","Venezuela","Vietnam","Wallis and Futuna","Western Sahara","Yemen","Zambia","Zimbabwe",null],"description":"Country where the company is headquartered"}},"required":["company_id","company_name","ticker","mic_code","country"]}}}}},"400":{"description":"Bad Request","content":{"text/plain":{"schema":{"type":"string"}}}},"401":{"description":"Unauthorized","content":{"text/plain":{"schema":{"type":"string"}}}},"402":{"description":"Insufficient credits","headers":{"X-Credit-Cost":{"description":"Number of credits consumed for this request.","schema":{"type":"integer"}},"X-Credit-Balance":{"description":"Number of remaining credits after this request.","schema":{"type":"integer"}}},"content":{"text/plain":{"schema":{"type":"string"}}}},"403":{"description":"Subscription required - the user does not have an active subscription.","content":{}},"500":{"description":"Internal Server Error","content":{"text/plain":{"schema":{"type":"string"}}}}}}}}}
````
## List Companies
> Retrieve a list of all available companies.\
> \
> \
> Pricing (depending on the response received):\
> \- 200 : 100\
> \- Other responses (40x, 50x): Free of charge
````json
{"openapi":"3.0.0","info":{"title":"Tracenable API","version":"1.0.0"},"tags":[{"name":"company","description":"Company information and metadata"}],"servers":[{"url":"https://tracenable.com","description":"Tracenable Production Server"}],"security":[{"BearerAuth":[]}],"components":{"securitySchemes":{"BearerAuth":{"type":"http","scheme":"bearer","bearerFormat":"JWT","description":"JWT bearer token used for authentication.\n\n**Test token (no charges apply; responses contain mock data):**\n```\nBearer sk_test_tracenable\n```"}}},"paths":{"/api/v1/companies/list":{"get":{"summary":"List Companies","description":"Retrieve a list of all available companies.\n\n\n Pricing (depending on the response received):\n- 200 : 100\n- Other responses (40x, 50x): Free of charge\n","tags":["company"],"operationId":"listCompanies","responses":{"200":{"description":"List of available companies","headers":{"X-Credit-Cost":{"description":"Number of credits consumed for this request.","schema":{"type":"integer"}},"X-Credit-Balance":{"description":"Number of remaining credits after this request.","schema":{"type":"integer"}}},"content":{"application/json":{"schema":{"type":"array","items":{"type":"object","properties":{"company_id":{"type":"string","format":"uuid","description":"Unique identifier for the company"},"company_name":{"type":"string","description":"Full name of the company"},"ticker":{"type":"string","nullable":true,"description":"Ticker symbol of the company"},"mic_code":{"type":"string","nullable":true,"enum":["XAMM","XMLI","ALXP","XDUB","XNCO","XMAU","VPXB","FNLT","AQSG","XKUW","XWAR","XTRN","XAMS","XDHA","XZAG","XPRM","XKRX","NOTC","FSME","MTAA","XSHG","XSAU","XLUX","XBOG","SCLE","XSES","XJSE","XXXX","GROW","XNSE","OTCM","XTAI","BJSE","RUSX","XFRA","XHEL","MISX","XNCM","XEQY","XRIS","ZBUL","XDFM","HAMN","XMAI","XNSA","WBDM","XMAE","XBER","XLJM","XCAI","XBUE","XHKG","XNYS","MERK","AIXK","XOAS","ENAX","XADS","XLJU","XTKS","XBOM","XKLS","ARCX","XKAZ","XBRN","XPHS","XKAR","NSME","XSAT","XZIM","XTSE","XNMS","XBIL","XMUN","XIDX","BATS","XNGS","ALXB","ENXL","XSHE","XBAR","XNZE","XBSE","XLIS","XHAM","XLIT","AQST","XCSE","XSGO","XSTO","XNAI","XSTC","SSME","XCNQ","XLIM","DSME","XBKK","XCOL","XGUA","XMAL","DSMD","XASE","ROCO","XDUS","XBAH","HSTC","XBUD","FNIS","XSTU","XCYS","XMAD","XLON","XBRA","XKOS","EXGM","XCAN","XICE","XBRU","ABUL","XTAE","XTSX","XCAS","BVMF","XMEX","XSWX","XHNX","FNLV","XATH","XETR","XPRA","XPAR","HMOD","XNGM","XBEL","XOSL","XMUS","XTAL","XASX","WBAH","NEOE",null],"description":"Market Identifier Code (MIC) of the company"},"country":{"type":"string","nullable":true,"enum":["Afghanistan","Åland","Albania","Algeria","American Samoa","Andorra","Angola","Anguilla","Antarctica","Antigua and Barbuda","Argentina","Armenia","Aruba","Australia","Austria","Azerbaijan","Bahamas","Bahrain","Bangladesh","Barbados","Belarus","Belgium","Belize","Benin","Bermuda","Bhutan","Bolivia","Bonaire, Sint Eustatius, and Saba","Bosnia and Herzegovina","Botswana","Bouvet Island","Brazil","British Indian Ocean Territory","British Virgin Islands","Brunei","Bulgaria","Burkina Faso","Burundi","Cabo Verde","Cambodia","Cameroon","Canada","Cayman Islands","Central African Republic","Chad","Chile","China","China (Mainland)","Christmas Island","Cocos (Keeling) Islands","Colombia","Comoros","Congo Republic","Cook Islands","Costa Rica","Croatia","Cuba","Curacao","Cyprus","Czechia","Denmark","Djibouti","Dominica","Dominican Republic","DR Congo","Ecuador","Egypt","El Salvador","Equatorial Guinea","Eritrea","Estonia","Eswatini","Ethiopia","Falkland Islands","Faroe Islands","Fiji","Finland","France","French Guiana","French Polynesia","French Southern Territories","Gabon","Georgia","Germany","Ghana","Gibraltar","Greece","Greenland","Grenada","Guadeloupe","Guam","Guatemala","Guernsey","Guinea-Bissau","Guinea","Guyana","Haiti","Heard and McDonald Islands","Honduras","Hong Kong","Hungary","Iceland","India","Indonesia","Iran","Iraq","Ireland","Isle of Man","Israel","Italy","Ivory Coast","Jamaica","Japan","Jersey","Jordan","Kazakhstan","Kenya","Kiribati","Kosovo","Kuwait","Kyrgyzstan","Laos","Latvia","Lebanon","Lesotho","Liberia","Libya","Liechtenstein","Lithuania","Luxembourg","Macau","Macedonia (the former Yugoslav Republic of)","Madagascar","Malawi","Malaysia","Maldives","Mali","Malta","Marshall Islands","Martinique","Mauritania","Mauritius","Mayotte","Mexico","Micronesia","Moldova","Monaco","Mongolia","Montenegro","Montserrat","Morocco","Mozambique","Myanmar","Namibia","Nauru","Nepal","New Caledonia","New Zealand","Nicaragua","Niger","Nigeria","Niue","Norfolk Island","North Korea","North Macedonia","Northern Mariana Islands","Norway","Oman","Pakistan","Palau","Palestine","Panama","Papua New Guinea","Paraguay","Peru","Philippines","Pitcairn Islands","Poland","Portugal","Puerto Rico","Qatar","Reunion","Romania","Russia","Rwanda","Saint Barthélemy","Saint Helena","Saint Lucia","Saint Martin","Saint Pierre and Miquelon","Samoa","San Marino","São Tomé and Príncipe","Saudi Arabia","Senegal","Serbia","Seychelles","Sierra Leone","Singapore","Sint Maarten","Slovakia","Slovenia","Solomon Islands","Somalia","South Africa","South Georgia and South Sandwich Islands","South Korea","South Sudan","Spain","Sri Lanka","St Kitts and Nevis","St Vincent and Grenadines","Sudan","Suriname","Svalbard and Jan Mayen","Sweden","Switzerland","Syria","Taiwan","Tajikistan","Tanzania","Thailand","Gambia","Netherlands","Timor-Leste","Togo","Tokelau","Tonga","Trinidad and Tobago","Tunisia","Turkey","Turkmenistan","Turks and Caicos Islands","Tuvalu","U.S. Outlying Islands","U.S. Virgin Islands","Uganda","Ukraine","United Arab Emirates","United Kingdom","United States","Uruguay","Uzbekistan","Vanuatu","Vatican City","Venezuela","Vietnam","Wallis and Futuna","Western Sahara","Yemen","Zambia","Zimbabwe",null],"description":"Country where the company is headquartered"}},"required":["company_id","company_name","ticker","mic_code","country"]}}}}},"400":{"description":"Bad Request","content":{"text/plain":{"schema":{"type":"string"}}}},"401":{"description":"Unauthorized","content":{"text/plain":{"schema":{"type":"string"}}}},"402":{"description":"Insufficient credits","headers":{"X-Credit-Cost":{"description":"Number of credits consumed for this request.","schema":{"type":"integer"}},"X-Credit-Balance":{"description":"Number of remaining credits after this request.","schema":{"type":"integer"}}},"content":{"text/plain":{"schema":{"type":"string"}}}},"403":{"description":"Subscription required - the user does not have an active subscription.","content":{}},"500":{"description":"Internal Server Error","content":{"text/plain":{"schema":{"type":"string"}}}}}}}}}
````
---
# Agent Instructions: Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.
Perform an HTTP GET request on the current page URL with the `ask` query parameter:
```
GET https://docs.tracenable.com/api/company.md?ask=
```
The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.
Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.