top

Subsidiaries

Search for subsidiaries or perform a lookup on a specific subsidiary.

Retrieve all subsidiaries

Retrieve a list of subsidiaries based on your query parameters.

Get/subsidiaries

Query Parameters

before_created_at
TYPEstring
Restrict the response to subsidiaries created_at before the set time.

after_created_at
TYPEstring
Restrict the response to subsidiaries created_at after the set time.

before_updated_at
TYPEstring
Restrict the response to subsidiaries updated_at before the set time.

after_updated_at
TYPEstring
Restrict the response to subsidiaries updated_at after the set time.

name
TYPEstring
Restrict the response to subsidiaries with the search phrase in the name field.

legal_name
TYPEstring
Restrict the response to subsidiaries with the search phrase in the legal_name field.

country
TYPEstring
Restrict the response to subsidiaries that match the specific country provided. See Countries for a list of all values.

region
TYPEstring
Restrict the response to subsidiaries that match the specific region provided. See Regions for a list of all values.

type
TYPEstring
Restrict the response to subsidiaries that match the specific type provided. See Entity Types for a list of all values.

parent_entity_id
TYPEstring
Restrict the response to subsidiaries that match a valid entity_id.

limit
TYPEinteger
The number of records to return. Default value is 10. Maximum value is 100.

offset
TYPEinteger
Used for pagination, this is the number of records from a collection to skip. Default value is 0.

sort_field
TYPEstring
Returns files sorted by the specified field. Possible values: "created_at", "updated_at", or "name". Default is "name".

sort_dir
TYPEstring
Determines the order direction for sorted results. Possible values: "ASC" or "DESC". Default is "ASC".
List Subsidiaries
curl -v -X GET https://api.swfi.com/v1/subsidiaries?before_created_at=2022-10-17&after_created_at=2022-10-12&before_updated_at=2022-10-17&after_updated_at=2022-10-12&name=Temasek&legal_name=investment%20management&country=Norway&region=North%20America&type=Company&parent_entity_id=undefined&limit=10&offset=0&sort_field=created_at&sort_dir=ASC \ 
-H "Accept: application/json" \ 
-H "Authorization: $API_KEY"

Success Response

HTTP Status 200
data
TYPEobject[]
An array of subsidiaries.

total_items
TYPEinteger
The total number of items matching the query regardless of pagination.
Example response
{
  "data": [
    {
      "_id": "621654e28326720292c3de2a",
      "parent_entity_id": "598cdaa60124e9fd2d05c04a",
      "name": "ISTARI",
      "legal_name": "ISTARI",
      "dba_name": "ISTARI",
      "type": "Asset Manager",
      "lei": "",
      "address": "8 Cavendish Square, Marylebone, London, W1G 0PD",
      "country": "United Kingdom",
      "region": "Europe",
      "phone": "44-20-8161-2972",
      "fax": "",
      "summary": "<p>Established in 2020 by Temasek, an investment company headquartered in Singapore, ISTARI has a unique model. It is an advisory practice, investor and educator through its Academy, developed and delivered in collaboration with Columbia University, School of International and Public Affairs. ISTARI harnesses the collective power of the world's leading cybersecurity companies, experts, and knowledge to work alongside clients on their journey to build cyber resilience. The ISTARI Collective includes Sygnia, Ensign InfoSecurity (EIS), BlueVoyant, Claroty, Armis, Prevalent AI, and VisibleRisk. Headquartered in London, ISTARI has a global presence in the US, Europe and Singapore.</p>\n<p>ISTARI - the Global Cybersecurity platform established by Temasek to help clients manage their digital risk in times of rapid digitalisation. It harnesses the collective power of the world&rsquo;s leading cybersecurity companies, people and knowledge to work alongside clients to secure their business growth and earn digital trust.</p>",
      "updated_at": "",
      "created_at": "2022-02-23T15:38:10.179Z"
    },
    {
      "_id": "6010bd8ef7c08f57cecfdf97",
      "parent_entity_id": "598cdaa60124e9fd2d05c04a",
      "name": "Affinidi",
      "legal_name": "Affinidi",
      "dba_name": "Affinidi",
      "type": "Company",
      "lei": "",
      "address": "83 Clemenceau Avenue #02-01 UE Square, Singapore, 239920, Singapore",
      "country": "Singapore",
      "region": "Asia",
      "phone": "",
      "fax": "",
      "summary": "<p>Affinidi is founded by Temasek, a global investment firm headquartered in Singapore<br />&zwj;<br />Affinidi is building technology solutions as well as two applications, GoodWorker and Trustana, to promote the growth of a Self-Sovereign Identity-enabled ecosystem<br />&zwj;<br />Trustana is a curated B2B marketplace and trade platform connecting verifiable, international partners for seamless cross-border trade<br />&zwj;<br />GoodWorker is a digital job matching platform for blue-collar workers and employers in India.</p>",
      "updated_at": "",
      "created_at": "2021-01-27T01:10:38.695Z"
    }
  ],
  "total_items": 6249
}

Error Response

message
TYPEstring
A short, human-readable summary of the problem type.

status
TYPEinteger
The HTTP status code (RFC2616, Section 6) generated by the origin server for this occurance of the problem.
Example response
{
  "errors": [
      {
          "query_parameter": "sort_field",
          "message": "Value not in available options."
      }
  ],
  "status": 400
}

Retrieve one subsidiary

Retrieve one subsidiary with links to associated resources.

Get/subsidiaries/:_id

Path Parameters

_id
REQUIRED
TYPEstring
Get information about a specific subsidiary.
Get Subsidiary info
curl -v -X GET https://api.swfi.com/v1/subsidiaries/:_id \ 
-H "Accept: application/json" \ 
-H "Authorization: $API_KEY"

Success Response

HTTP Status 200
data._id
TYPEstring
Unique identifier for the subsidiary.

data.parent_entity_id
TYPEstring
Unique identifier for the subsidiary parent entity.

data.name
TYPEstring
Familiar name of the subsidiary.

data.legal_name
TYPEstring
Formal name of the subsidiary.

data.dba_name
TYPEstring
Doing Business As name of the subsidiary. Field can be an empty string

data.type
TYPEstring
The SWFI classification for the subsidiary. See Entity Types for a list of all values.

data.lei
TYPEstring
The Legal Entity Identifier. Field can be an empty string.

data.address
TYPEstring
The physical or mailing address of the subsidiary. Field can be an empty string.

data.country
TYPEstring
The specific country where the subsidiary resides. See Countries for a list of all values.

data.region
TYPEstring
The specific region where the subsidiary resides. See Regions for a list of all values.

data.phone
TYPEstring
General phone number for the subsidiary. Field can be an empty string.

data.fax
TYPEstring
General fax number for the subsidiary. Field can be an empty string

data.background
TYPEstring
Description of the entities origin and history in HTML markup. Field can be an empty string.

data.summary
TYPEstring
General summary about the subsidiary in HTML markup. Field can be an empty string.

data.updated_at
TYPEstring
The last time the subsidiary received one or more updates. Field can be an empty string.

data.created_at
TYPEstring
When the subsidiary was created.
Example response
{
  "data": {
    "_id": "621654e28326720292c3de2a",
    "parent_entity_id": "598cdaa60124e9fd2d05c04a",
    "name": "ISTARI",
    "legal_name": "ISTARI",
    "dba_name": "ISTARI",
    "type": "Asset Manager",
    "lei": "",
    "address": "8 Cavendish Square, Marylebone, London, W1G 0PD",
    "country": "United Kingdom",
    "region": "Europe",
    "phone": "44-20-8161-2972",
    "fax": "",
    "summary": "<p>Established in 2020 by Temasek, an investment company headquartered in Singapore, ISTARI has a unique model. It is an advisory practice, investor and educator through its Academy, developed and delivered in collaboration with Columbia University, School of International and Public Affairs. ISTARI harnesses the collective power of the world's leading cybersecurity companies, experts, and knowledge to work alongside clients on their journey to build cyber resilience. The ISTARI Collective includes Sygnia, Ensign InfoSecurity (EIS), BlueVoyant, Claroty, Armis, Prevalent AI, and VisibleRisk. Headquartered in London, ISTARI has a global presence in the US, Europe and Singapore.</p>\n<p>ISTARI - the Global Cybersecurity platform established by Temasek to help clients manage their digital risk in times of rapid digitalisation. It harnesses the collective power of the world&rsquo;s leading cybersecurity companies, people and knowledge to work alongside clients to secure their business growth and earn digital trust.</p>",
    "updated_at": "",
    "created_at": "2022-02-23T15:38:10.179Z"
  }
}

Error Response

message
TYPEstring
A short, human-readable summary of the problem type.

status
TYPEinteger
The HTTP status code (RFC2616, Section 6) generated by the origin server for this occurance of the problem.
Example response
{
  "errors": [
      {
          "path": "/v1/aum/:_id",
          "message": "Not Found"
      }
  ],
  "status": 404
}
Documentation as of 10/19/2022