PermID search API cannot find some available organizations
I find that PermID search API cannot find some organizations that can be found by the search UI on PermID.org website. Here are 2 examples. Do you know the reason?
- Kidsland International Holdings Ltd, https://permid.org/1-5056412074. The API returns empty result.
- Wah Sun Handbags International Holdings Ltd, https://permid.org/1-5056414599. The API returns as follow but the correct entity is not in the return result.
{"result":{"organizations":{"entityType":"organizations","total":10,"start":1,"num":5,"entities":[{"@id":"https:\/\/permid.org\/1-5001102230","organizationName":"Sun Wah Group","orgSubtype":"Unknown","hasURL":"http:\/\/www.sunwahgroup.com\/"},{"@id":"https:\/\/permid.org\/1-5040194820","organizationName":"Wah Sun Investments Ltd","orgSubtype":"Unknown"},{"@id":"https:\/\/permid.org\/1-5065315137","organizationName":"H SUN HOLDING ApS","orgSubtype":"Unknown"},{"@id":"https:\/\/permid.org\/1-5050308375","organizationName":"Sun Wah Capital Ltd","orgSubtype":"Unknown"},{"@id":"https:\/\/permid.org\/1-5050272689","organizationName":"Sun Wah Education Laboratories Inc","orgSubtype":"Unknown"}]}}}
I got a response from the Open PermID team.
Few organization entities are configured with the name parameter. In this case, "Kidsland" is not configured with the name parameter. Therefore, you are unable to search it with the name parameter.
To search organizations by name, you can use search without the name parameter.
Could you please share the query (q) used in the search API?
From my test, it returns data properly.
The above query is Kidsland and it returns.
{
"result": {
"organizations": {
"entityType": "organizations",
"total": 2,
"start": 1,
"num": 2,
"entities": [
{
"@id": "https://permid.org/1-5056412074",
"organizationName": "Kidsland International Holdings Ltd",
"primaryTicker": "2122",
"orgSubtype": "Investment Company",
"hasHoldingClassification": "publiclyHeld",
"hasURL": "https://www.kidslandholdings.com/"
},
{
"@id": "https://permid.org/1-5074089229",
"organizationName": "Kidsland Manufacturing Co Ltd",
"orgSubtype": "Unknown"
}
]
}
}
}
For the second question, you need to specify the num parameter to get more results.
The Open PermID swagger is avaiable at https://developers.refinitiv.com/open-permid/permid-entity-search/dev-tools.
I use the Search API with name parameter only. And the input name is full name instead of just a "kidsland". Here is the full query, {'format': 'JSON', 'entityType': 'organization', 'q': 'name:Kidsland International Holdings Ltd'}. So the issue is "cannot find the entity by searching with full name as the name parameter"
Yes, you are correct. It doesn't work when using the name parameter with "Kidsland". However, it works if I search for "Kidsland" without any parameter.
Next, I will contact the Open PermID team to verify this problem.