Authentication
- Credentials:
usernameandpasswordusing Basic Auth - Runtime base URL:
https://energydataservices.ci.spglobal.com/data/v1 - Source Swagger: energydataservices.ihsenergy.com/data/swagger/v1/swagger.json
S&P Global IHS Energy Single Page Model
User-facing reference for the Swagger-backed IHS connector in PatchOps: authentication, surface area, tool selection, and the fastest path from discovery to data retrieval.
Published Surface
131 published operations across 15 tagged groups in the vendored Swagger
International upstream domains including ADM, Standard, Spatial V2, Enhanced Midstream, Reservoir, and Formation Pressure
North America domains including Midstream, Midstream Spatial, Well Formation Pressure, and Energy Documents
Upstream Intelligence document and search endpoints
Entitlements and session-management endpoints
PatchOps Tool Surface
listOperationsdescribeOperationrequestlistDomainslistViewsgetViewSchemaretrievecountgetSessionsdeleteSessionsgetReportsgetImageRecommended Workflow
Discover relevant operations with listOperations() when you need the exact published operationId.
Inspect parameters with describeOperation() before calling broad search or document endpoints.
Use request() for full Swagger coverage when the helper methods do not map cleanly to the endpoint you need.
Use listViews() / getViewSchema() / retrieve() / count() for the catalog-style view domains because those helpers stay much shorter than raw path calls.
Use getSessions() and deleteSessions() to diagnose entitlement or concurrent-session issues before retrying authentication-heavy workflows.
Quick Start
// 1) Discover the published surface
await ihs.listOperations({ text: "Upstream Intelligence" });
// 2) Inspect one operation before calling it
await ihs.describeOperation({
operationId: "GlobalUpstreamIntelligence_GetDocuments"
});
// 3) Call any published operation directly
await ihs.request({
operationId: "GlobalUpstreamIntelligence_GetDocuments",
query: { "$count": 10 }
});
// 4) Use helpers for catalog-style data domains
await ihs.listViews({ domain: "northamerica/midstream" });
await ihs.retrieve({
domain: "adm/eandp",
view: "Wells",
filter: "country_name eq 'Brazil'",
count: 25
});