Skip to main content
GET
List all linked entities in a stored Situation

Authorizations

Authorization
string
header
required

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

Path Parameters

story_id
string
required

A stored Situation UID (sit_…). Published as story_id for path compatibility with /api/v2/situations/{story_id}, which accepts either; the member lists accept only the UID — a Story id is refused.

Query Parameters

scope_version
string

Optional version from the preceding page scope. A changed scope returns 409 instead of silently mixing pages. Note: validation is owned by the endpoint service because it depends on composed or cross-parameter state; the published error semantics above still apply.

date_start
string<date>

Optional earliest member reporting date. Omit both dates for the full servable membership. Note: validation is owned by the endpoint service because it depends on composed or cross-parameter state; the published error semantics above still apply.

date_end
string<date>

Optional latest member reporting date. No implicit first200-member truncation. Note: validation is owned by the endpoint service because it depends on composed or cross-parameter state; the published error semantics above still apply.

entity_type
string

Case-insensitive type from summary.by_type (person, organization, company, ministry, agency, regulator, party, ngo, union, campaign, armed_group, brand, place, location, other); unknown selects untyped entities. A value outside that set is refused with 400 INVALID_ENUM rather than answered as an empty page. Applied after identity folding and echoed in applied_filters. 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:25

Maximum linked entities returned per page. 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 <= 200
offset
integer
default:0

Entities to skip after canonical folding and type filtering. Stable order: distinct Story breadth, mentions, entity ID.

Required range: x >= 0

Response

Success

success
boolean
data
object[]