Skills Development Guidewire Cloud API Connection Testing

Guidewire Cloud API Connection Testing

v20260423
guidewire-hello-world
This skill provides foundational examples for interacting with Guidewire's core cloud APIs, including PolicyCenter, ClaimCenter, and BillingCenter. It demonstrates how to execute initial RESTful API calls, query resources (like accounts and claims), and understand common API response structures, pagination, and error handling patterns. Ideal for connectivity testing, learning Guidewire's REST structure, and prototyping basic insurance integrations.
Get Skill
405 downloads
Overview

Guidewire Hello World

Overview

Execute your first Cloud API calls to PolicyCenter, ClaimCenter, and BillingCenter. All Guidewire Cloud APIs are RESTful with JSON payloads and follow Swagger 2.0.

Instructions

Step 1: Query PolicyCenter Accounts

const token = await getGuidewireToken();
const headers = { 'Authorization': `Bearer ${token}`, 'Content-Type': 'application/json' };

// List accounts
const accounts = await fetch(`${process.env.GW_PC_URL}/account/v1/accounts?pageSize=5`, { headers });
const data = await accounts.json();
data.data.forEach((acct: any) => {
  console.log(`Account: ${acct.attributes.accountNumber} | ${acct.attributes.accountHolderContact.displayName}`);
});

Step 2: Query ClaimCenter Claims

// List recent claims
const claims = await fetch(`${process.env.GW_CC_URL}/claim/v1/claims?pageSize=5`, { headers });
const claimData = await claims.json();
claimData.data.forEach((claim: any) => {
  console.log(`Claim: ${claim.attributes.claimNumber} | ${claim.attributes.status.code} | ${claim.attributes.lossDate}`);
});

Step 3: Guidewire API Response Structure

{
  "count": 42,
  "data": [
    {
      "attributes": { "accountNumber": "A000001", "...": "..." },
      "checksum": "abc123",
      "links": { "self": { "href": "/account/v1/accounts/pc:123" } }
    }
  ],
  "links": { "next": { "href": "/account/v1/accounts?pageSize=5&offsetToken=..." } }
}

Key patterns: data[] array, attributes for fields, checksum for optimistic locking, links for pagination.

Error Handling

Error Code Solution
404 Not Found Invalid endpoint path Verify /account/v1/accounts format
400 Bad Request Invalid query params Check pageSize, filter syntax
422 Unprocessable Business rule violation Read userMessage in response
409 Conflict Stale checksum Re-GET resource, use new checksum

For detailed implementation, see: implementation guide

Resources

Next Steps

For local development workflow, see guidewire-local-dev-loop.

Info
Category Development
Name guidewire-hello-world
Version v20260423
Size 4.03KB
Updated At 2026-04-28
Language