This service allows you to retrieve CLAIMS Direct IFI names and name variations. In addition, ultimate owners and subsidiary information are retrievable via separate endpoints. The Names service is available to Premium Plus subscribers. If you are interested in accessing this service, please contact your sales representative.

Response Members

The response for each of the following endpoints contains the same member-structure.

Member	Description

Member	Description
name	Either an IFI name or variation
country	Country of name
address	(optional) Address of name
ticker	(optional) Ticker structure represents the ticker symbol and market identifier code (MIC) the symbol is traded on.
name_type	Values include: N=IFI name V=name variation (currently not included)
parent_relationship	Values include: O=owner S=subsidiary F=former name M=merged
category	Values include: Cooperative Delisted Education Facility Government Healthcare Joint Venture Nonprofit Private Public Research Trust Undefined
updated	The last time the Name or Ownership hierarchy was reviewed by the editorial team
extract_status	Status. Values include: R=reviewed V=validated
entity_id	Entity identifier. Note: The presence of an entity_id indicates that a name is part of an entity hierarchy and is available in the Entities Pro API and the Entities Stream.

/names/name

This endpoint returns a list of the top 25 names structures ranked by name_type and parent_relationship in the following order:

name_type N
parent_relationship O, S, F, and then M
name_type V

It is important to use this endpoint prior to using the other names services to ensure that you are using the correct IFI standardized name format. Note that the results of this endpoint have no inherent relationship to each other.

Method	GET

Method	GET
Path	/names/name
Parameter		Values	Description
	@q	Search expression, e.g., waze*	Any standard un-fielded Solr search expression

Example

 wget -O- -q \
  --header 'x-user:x' \
  --header 'x-password:y' \
'https://cdws21.ificlaims.com/names/name?q=Eberhard'

Response

{
   "time" : "0.054",
   "status" : "success",
   "content" : {
   "numFound" : 24,
      "names" : [
         {
            "entity_id" : 414915,
            "name_type" : "N",
            "category" : "Education",
            "extract_status" : "V",
            "parent_relationship" : "O",
            "updated" : "2020-08-12T00:00:00Z",
            "country" : "DE",
            "name" : "Eberhard Karls Universitaet Tuebingen"
         },
         {
            "entity_id" : 89446,
            "country" : "CA",
            "parent_relationship" : "S",
            "category" : "Private",
            "extract_status" : "V",
            "name_type" : "N",
            "name" : "Eberhard Hardware Manufacturing Ltd"
         },
         {
            "name" : "Eberhard Hoesch and Soehne GmbH",
            "category" : "Private",
            "name_type" : "N",
            "extract_status" : "V",
            "parent_relationship" : "S",
            "country" : "DE",
            "entity_id" : 416989
         },
; etc...

         {
            "name" : "Eberhard Hoesch and Soehne GmbH Verfahrens und Anlagentechnik",
            "name_type" : "N",
            "extract_status" : "V",
            "country" : "DE"
         },
         {
            "country" : "DE",
            "name_type" : "N",
            "extract_status" : "V",
            "name" : "Eberhard Hoesch and Soehne GmbH Giesserei und Maschinenfabrik"
         },
         {
            "country" : "DE",
            "name" : "Eberhard Hoesch and Soehne Metall and Kunststoffwerk GmbH and Co",
            "extract_status" : "V",
            "name_type" : "N"
         }
      ],
      "QTime" : 23
   }
}

/names/ticker

This endpoint returns the name associated with a valid ticker symbol.

Method	GET

Method	GET
Path	/names/ticker
Parameter		Values	Description
	@q	Search expression, e.g., PFE	A valid ticker symbol

Example

 wget -O- -q \
  --header 'x-user:x' \
  --header 'x-password:y' \
'https://cdws21.ificlaims.com/names/ticker?q=PFE'

Response

{
   "status" : "success",
   "time" : "0.127",
   "content" : {
      "names" : [
         {
            "updated" : "2021-02-05",
            "country" : "US",
            "address" : "235 East 42nd Street, New York, US-NY, 10017, US",
            "name" : "Pfizer Inc",
            "ticker" : [
               {
                  "exchange" : "XMIL",
                  "symbol" : "4PFE"
               },
               {
                  "exchange" : "XNYS",
                  "symbol" : "PFE"
               }
            ],
            "entity_id" : 4999,
            "name_type" : "N",
            "extract_status" : "V",
            "parent_relationship" : "O"
         }
      ]
   }
}

/names/ultimate

This endpoint returns the ultimate corporate parent for a given subsidiary.

Method	GET

Method	GET
Path	/names/ultimate
Parameter		Values	Description
	@q	String, e.g., Waze Inc	Any IFI company name with `name_type` = N and `parent_relationship` = (S, F or M)

Example

 wget -O- -q \
  --header 'x-user:x' \
  --header 'x-password:y' \
'https://cdws21.ificlaims.com/names/ultimate?q=Waze Inc'

Response

{
   "time" : "0.019",
   "status" : "success",
   "content" : {
      "ultimate" : {
         "extract_status" : "V",
         "name" : "Alphabet Inc",
         "ticker" : [
            {
               "symbol" : "GOOGL",
               "exchange" : "XNAS"
            },
            {
               "exchange" : "XNAS",
               "symbol" : "GOOG"
            }
         ],
         "name_type" : "N",
         "entity_id" : 3898,
         "address" : "1600 Amphitheatre Parkway, Mountain View, US-CA, 94043, US",
         "updated" : "2020-11-16",
         "country" : "US",
         "parent_relationship" : "O"
      }
   }
}

/names/subsidiaries

This endpoint returns a list of subsidiaries for a given ultimate owner.

Method	GET

Method	GET
Path	/names/subsidiaries
Parameter		Values	Description
	@q	String, e.g., Alphabet Inc	Any IFI company name with `name_type` = N and `parent_relationship` = O

Example

wget -O- -q \
  --header 'x-user:x' \
  --header 'x-password:y' \
'https://cdws21.ificlaims.com/names/subsidiaries?q=Alphabet Inc'

Response (abbreviated)

{
   "status" : "success",
   "time" : "0.022",
   "content" : {
      "name" : "Alphabet Inc",
      "count" : 203,
      "subsidiaries" : [
         {
            "name" : "Actifio Inc",
            "country" : "US",
            "entity_id" : 487661,
            "extract_status" : "V",
            "name_type" : "N",
            "parent_relationship" : "S"
         },
         {
            "parent_relationship" : "S",
            "extract_status" : "V",
            "name_type" : "N",
            "entity_id" : 69201,
            "country" : "US",
            "name" : "Admob Inc"
         },
; etc...
         {
            "extract_status" : "V",
            "name_type" : "N",
            "parent_relationship" : "S",
            "entity_id" : 69468,
            "name" : "Waze Inc",
            "country" : "US"
         },
         {
            "name" : "Waze Mobile Ltd",
            "country" : "IL",
            "entity_id" : 424218,
            "extract_status" : "V",
            "name_type" : "N",
            "parent_relationship" : "S"
         },
         {
            "extract_status" : "V",
            "name_type" : "N",
            "parent_relationship" : "S",
            "entity_id" : 69471,
            "name" : "Widevine Technologies Inc",
            "country" : "US"
         },
; etc...
      ]
   }
}