guidewire-hello-world

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

• PolicyCenter API Reference
• ClaimCenter API Reference
• Cloud API Developer Guide

Next Steps

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