guidewire-hello-world
Execute first API calls to Guidewire PolicyCenter, ClaimCenter, and BillingCenter. Use when testing connectivity, exploring Cloud API structure, or learning REST patterns. Trigger: "guidewire hello world", "first guidewire call", "test policycenter api".
Allowed Tools
Provided by Plugin
guidewire-pack
Claude Code skill pack for Guidewire InsuranceSuite (24 skills)
Installation
This skill is included in the guidewire-pack plugin:
/plugin install guidewire-pack@claude-code-plugins-plus
Click to copy
Instructions
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.