curl --request GET \
--url https://gdeltcloud.com/api/v2/filings/resolve \
--header 'Authorization: Bearer <token>'import requests
url = "https://gdeltcloud.com/api/v2/filings/resolve"
headers = {"Authorization": "Bearer <token>"}
response = requests.get(url, headers=headers)
print(response.text)const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};
fetch('https://gdeltcloud.com/api/v2/filings/resolve', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));{
"success": true,
"query": {
"ticker": "MEI",
"cik": null,
"name": null
},
"resolved": {
"cik": 65270,
"company_name": "METHODE ELECTRONICS INC",
"ticker": "MEI",
"entity_id": "ent_8f2c1a7d9b4e"
}
}{
"success": false,
"error": "<string>",
"code": "<string>",
"details": {}
}{
"success": false,
"error": "<string>",
"code": "<string>",
"details": {}
}{
"success": false,
"error": "<string>",
"code": "<string>",
"details": {}
}Resolve to CIK
Resolve a company name, ticker, or CIK to SEC filing identities and terminal spine entities.
curl --request GET \
--url https://gdeltcloud.com/api/v2/filings/resolve \
--header 'Authorization: Bearer <token>'import requests
url = "https://gdeltcloud.com/api/v2/filings/resolve"
headers = {"Authorization": "Bearer <token>"}
response = requests.get(url, headers=headers)
print(response.text)const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};
fetch('https://gdeltcloud.com/api/v2/filings/resolve', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));{
"success": true,
"query": {
"ticker": "MEI",
"cik": null,
"name": null
},
"resolved": {
"cik": 65270,
"company_name": "METHODE ELECTRONICS INC",
"ticker": "MEI",
"entity_id": "ent_8f2c1a7d9b4e"
}
}{
"success": false,
"error": "<string>",
"code": "<string>",
"details": {}
}{
"success": false,
"error": "<string>",
"code": "<string>",
"details": {}
}{
"success": false,
"error": "<string>",
"code": "<string>",
"details": {}
}Authorizations
GDELT Cloud API key. Send as Authorization: Bearer gdelt_sk_....
Query Parameters
Company-name query. name and search are aliases. Also accepts: name, search. Note: validation is owned by the endpoint service because it depends on composed or cross-parameter state; the published error semantics above still apply.
Exact ticker symbol. Note: validation is owned by the endpoint service because it depends on composed or cross-parameter state; the published error semantics above still apply.
SEC CIK, with or without zero padding. Note: validation is owned by the endpoint service because it depends on composed or cross-parameter state; the published error semantics above still apply.
Maximum candidates returned. Note: validation is owned by the endpoint service because it depends on composed or cross-parameter state; the published error semantics above still apply.
1 <= x <= 100Minimum fuzzy-name candidate score. Note: validation is owned by the endpoint service because it depends on composed or cross-parameter state; the published error semantics above still apply.
0 <= x <= 1Response
Resolution result. query echoes the { ticker, cik, name } you passed; resolved is { cik, entity_id } (entity_id may be null when the filer is not yet on the entity spine) or null when nothing matched. Envelope: { success, query, resolved }.