GDELT Cloud Docs — Global Event Data API & MCP

Resolve to CIK

curl --request GET \
  --url https://gdeltcloud.com/api/v2/filings/resolve \
  --header 'Authorization: Bearer <token>'

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": {}
}

GET

api

filings

resolve

Resolve to CIK

curl --request GET \
  --url https://gdeltcloud.com/api/v2/filings/resolve \
  --header 'Authorization: Bearer <token>'

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

Authorization

string

header

required

GDELT Cloud API key. Send as Authorization: Bearer gdelt_sk_....

Query Parameters

string

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.

ticker

string

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.

cik

string

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.

limit

integer

default:10

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.

Required range: 1 <= x <= 100

min_score

number

Minimum 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.

Required range: 0 <= x <= 1

Response

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 }.

success

boolean

query

object

Show child attributes

resolved

object

Show child attributes

Events

Stories

Situations

Entities

Unified Search

Media Intelligence

Facilities

Monitors

Geography

Government

Political Offices

Filings

Reference Data

Energy

AI Compute

Macro Finance

Screening and Reference

China

Maritime

Atlas Intelligence

Briefs

Meta

Resolve to CIK

Authorizations

Query Parameters

Response