---
name: guidewire-hello-world
description: '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: Read, Write, Edit, Bash(curl:*), Bash(npm:*), Grep
version: 1.0.0
license: MIT
author: Jeremy Longshore <jeremy@intentsolutions.io>
tags:
- saas
- insurance
- guidewire
compatibility: Designed for Claude Code
---
# 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

```typescript
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

```typescript
// 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

```json
{
  "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](references/implementation-guide.md)

## Resources

- [PolicyCenter API Reference](https://docs.guidewire.com/cloud/pc/202503/apiref/)
- [ClaimCenter API Reference](https://docs.guidewire.com/cloud/cc/202407/apiref/)
- [Cloud API Developer Guide](https://docs.guidewire.com/cloud/pc/202503/cloudapica/pdf/CloudAPI-Developer.pdf)

## Next Steps

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