> ## Documentation Index > Fetch the complete documentation index at: https://docs.gdeltcloud.com/llms.txt > Use this file to discover all available pages before exploring further. # Get Energy Asset > Fetch one Energy asset by tracker and GEM ID. The response includes the canonical asset card plus a raw source record containing tracker-specific fields. ## OpenAPI ````yaml /api-reference/openapi-v2.json get /api/v2/energy/assets/{tracker}/{gem_id} openapi: 3.0.3 info: title: GDELT Cloud API v2 version: 2.0.0 description: >- Clean v2 REST API for generated GDELT Cloud structured Events, clustered Stories, linked Entities, summaries, admin1 discovery, significance ranking, and paginated article evidence. Event significance is a family-scoped weighted blend, renormalized so every event family spans a true 0-1: each event's raw total is divided by the maximum its own family can reach (Conflict 1.00, CAMEO+ POLITICAL 0.90, other CAMEO+ domains 0.65). All events: Goldstein severity 0.25, article evidence 0.05, confidence 0.05. Conflict only: fatalities 0.55 (log-scaled by body count) and civilian targeting 0.10. CAMEO+ only: magnitude 0.20, systemic importance 0.15, propagation potential 0.10, market sensitivity 0.10. When magnitude is unmeasured its term AND its 0.20 weight are both dropped. The four CAMEO+ metrics are rubric scores produced by published formulas - ordinal ranking signals, not measurements, probabilities, or predicted price moves. goldstein_scale is one canonical public metric, populated for Conflict Events and CAMEO+ POLITICAL Events where meaningful. Story linked_event_count is a Story-to-Event link aggregate, not a distinct Event total. servers: - url: https://gdeltcloud.com description: Production - url: http://localhost:3000 description: Local development security: - ApiKeyAuth: [] tags: - name: Events description: Coded CAMEO+ / conflict events — search, fetch, and summarize. - name: Stories description: Clustered narratives (stories) and their articles. - name: Entities description: >- People & organizations — resolve a name to an entity, then fetch its profile and tone. - name: Geography description: Admin-1 geography lookups. - name: Energy description: Global Energy Monitor assets + ownership registry. - name: Facilities description: >- Unified physical-asset directory — GEM energy assets + World Port Index ports + Epoch AI data centers on one keyed surface, resolved to spine owners. Plan-gated (Analyst plan and up). - name: Screening and Reference description: >- Restricted-party lists, screening, and ownership-chain exposure. Plan-gated (`can_use_screening` / `can_use_exposure`). - name: China description: >- China overseas development finance (AidData GCDF). Plan-gated (`can_use_china`). - name: Media Intelligence description: >- Entity tone (`can_use_tone`) and Share of Voice (`can_use_share_of_voice`) are plan-gated. Social signal remains an admin-only preview. - name: Filings description: >- SEC EDGAR filings, XBRL financials, and AI-extracted relations. Requires a plan with SEC filings access (`can_use_filings`) — the Corporate & Supply Chain plan and above. - name: Macro Finance description: >- FRED economic time series (catalog, point-in-time observations, releases). Plan-gated (`can_use_macro`). - name: Maritime description: >- AIS-derived vessel-flow signals across maritime chokepoints — chokepoint transits, last-known vessel positions, carriers, dwell, and AIS-dark gaps. Plan-gated (`can_use_maritime`). - name: Briefs description: Source-backed monitoring briefs. paths: /api/v2/energy/assets/{tracker}/{gem_id}: get: tags: - Energy summary: Get Energy Asset description: >- Fetch one Energy asset by tracker and GEM ID. The response includes the canonical asset card plus a raw source record containing tracker-specific fields. operationId: get-energy-asset-v2 parameters: - name: tracker in: path required: true schema: type: string enum: - coal_plants - coal_mines - coal_terminals - oil_gas_plants - oil_gas_extraction - lng_terminals - nuclear - geothermal - bioenergy - hydropower - solar - wind - gas_pipelines - oil_pipelines - lng_carriers description: >- GEM tracker name. All trackers: [Taxonomy & Codes — Energy](/api-reference/taxonomy#energy-vocabularies). - name: gem_id in: path required: true schema: type: string description: GEM asset ID returned by Search Energy Assets. responses: '200': description: Success content: application/json: schema: $ref: '#/components/schemas/EnergyAssetDetailResponse' examples: asset: value: success: true data: id: oil_gas_plants:G100001090366 gem_id: G100001090366 tracker: oil_gas_plants tier: main asset_class: fixed name: GW Ranch Energy Center name_local: null name_other: null status: pre-construction status_detail: null start_year: 2028 retired_year: null fuel: 'fossil gas: natural gas' capacity: value: 5000 unit: MW mw: 5000 mw_secondary: null geo: country: United States country_iso3: USA secondary_country_iso3: null region: North America subregion: Northern America continent: North America state_province: Texas city: Fort Stockton lat: 31.16 lon: -102.9 location_accuracy: exact owners_raw: Pacifico GW LLC owners: - name: Pacifico GW LLC entity_id: E100002021305 stake_pct: null operators_raw: null operators: [] parents_raw: Pacifico Energy Group LLC parents: - name: Pacifico Energy Group LLC entity_id: E100002021513 stake_pct: null wiki_url: https://www.gem.wiki/GW_Ranch_Energy_Center last_updated: '2026-01-15' detail_url: /energy/oil_gas_plants/G100001090366 api_url: /api/v2/energy/assets/oil_gas_plants/G100001090366 raw: gem_id: G100001090366 tracker: oil_gas_plants dataset_version: 2026-01 '401': description: 'API key required. Include: Authorization: Bearer gdelt_sk_...' content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' examples: error: value: error: >- API key required. Include: Authorization: Bearer gdelt_sk_... code: MISSING_API_KEY '404': description: Asset not found. content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' examples: error: value: success: false error: Asset not found. code: NOT_FOUND '429': description: Rate limit or quota exceeded. content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' examples: error: value: success: false error: Rate limit or quota exceeded. code: RATE_LIMITED '500': description: Failed to fetch energy asset. content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' examples: error: value: success: false error: Failed to fetch energy asset. code: INTERNAL_ERROR security: - ApiKeyAuth: [] components: schemas: EnergyAssetDetailResponse: type: object additionalProperties: false required: - success - data - raw properties: success: type: boolean enum: - true data: $ref: '#/components/schemas/EnergyAssetCard' raw: type: object additionalProperties: true ErrorResponse: type: object properties: success: type: boolean enum: - false error: type: string code: type: string details: type: object description: >- Recoverable validation context when available, such as param, invalid_value, accepted_values, nearest_values, and a corrected example. additionalProperties: true EnergyAssetCard: type: object additionalProperties: false required: - id - gem_id - tracker - tier - asset_class - name - name_local - name_other - status - status_detail - start_year - retired_year - fuel - capacity - geo - owners_raw - owners - operators_raw - operators - parents_raw - parents - wiki_url - last_updated - detail_url - api_url properties: id: type: string gem_id: type: string tracker: type: string enum: - coal_plants - coal_mines - coal_terminals - oil_gas_plants - oil_gas_extraction - lng_terminals - nuclear - geothermal - bioenergy - hydropower - solar - wind - gas_pipelines - oil_pipelines - lng_carriers tier: type: string nullable: true asset_class: type: string name: type: string name_local: type: string nullable: true name_other: type: string nullable: true status: type: string status_detail: type: string nullable: true start_year: type: integer nullable: true retired_year: type: integer nullable: true fuel: type: string nullable: true capacity: $ref: '#/components/schemas/EnergyCapacity' geo: $ref: '#/components/schemas/EnergyAssetGeo' owners_raw: type: string nullable: true owners: type: array items: $ref: '#/components/schemas/EnergyOwnerEntry' operators_raw: type: string nullable: true operators: type: array items: $ref: '#/components/schemas/EnergyOwnerEntry' parents_raw: type: string nullable: true parents: type: array items: $ref: '#/components/schemas/EnergyOwnerEntry' wiki_url: type: string nullable: true last_updated: type: string nullable: true detail_url: type: string api_url: type: string EnergyCapacity: type: object additionalProperties: false required: - value - unit - mw - mw_secondary properties: value: type: number nullable: true unit: type: string mw: type: number nullable: true description: Populated only for power-generation trackers. mw_secondary: type: number nullable: true EnergyAssetGeo: type: object additionalProperties: false required: - country - country_iso3 - secondary_country_iso3 - region - subregion - continent - state_province - city - lat - lon - location_accuracy properties: country: type: string nullable: true country_iso3: type: string nullable: true secondary_country_iso3: type: string nullable: true region: type: string nullable: true subregion: type: string nullable: true continent: type: string nullable: true state_province: type: string nullable: true city: type: string nullable: true lat: type: number nullable: true lon: type: number nullable: true location_accuracy: type: string nullable: true EnergyOwnerEntry: type: object additionalProperties: false required: - name - entity_id - stake_pct properties: name: type: string entity_id: type: string nullable: true stake_pct: type: number nullable: true securitySchemes: ApiKeyAuth: type: http scheme: bearer bearerFormat: gdelt_sk_... description: 'GDELT Cloud API key. Send as `Authorization: Bearer gdelt_sk_...`.' ````