> For the complete documentation index, see [llms.txt](https://docs.tracenable.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.tracenable.com/api/company.md).

# 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.\
> \
> \
> &#x20; Pricing (depending on the response received):\
> \- 200 : 1\
> \- Other responses (40x, 50x): Free of charge<br>

````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","XLAT",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.\
> \
> \
> &#x20; Pricing (depending on the response received):\
> \- 200 : 100\
> \- Other responses (40x, 50x): Free of charge<br>

````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","XLAT",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
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://docs.tracenable.com/api/company.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

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.
