Equity Lookup

Search companies

Sign

GET /v1/instruments/get_instruments

Example request

POST {{baseUrl}}/{{version}}/instruments/get_instruments
Content-Type: application/json
X-API-Key: <token>

{
  "name": "apple"
}

Search entities or companies by name, perm_id, isin or ticker.

Headers

Name	Value
Content-Type	application/json
X-API-KEY	<token>

Body

Name	Type	Description
name	string	Name of the company
perm_id	string	Perm_id of the company
isin	string	Isin code of the company's equity
ticker	string	Ticker of the company's equity

Response

200

{
  "status_code": 200,
  "data": [
    {
      "perm_id": "1-4295905573",
      "name": "Apple Inc",
      "equities": [
        {
          "isin": "US0378331005",
          "ticker": "AAPL"
        }
      ]
    },
    {
      "perm_id": "1-5039730211",
      "name": "Applegreen Ltd",
      "equities": [
        {
          "isin": "IE00BXC8D038",
          "ticker": "APGN"
        }
      ]
    },
    ...
  ],
  "detail": null,
  "message": "success"
}

400

{
  "error": "Invalid request"
}

Good to know: These API methods were auto-generated from an example OpenAPI file. You'll see that it's not editable – that's because the contents are synced to a URL! Any time the linked file changes, the documentation will change too.