> ## Documentation Index
> Fetch the complete documentation index at: https://ixoworld-mintlify-37bee248.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# Claims management

> Build claim workflows while keeping IXO Protocol and service API responsibilities separate.

Use this guide for workflow design and integration choices. Use API reference pages for exact request/response contracts.

## Before you start

* Decide whether your claim operation runs at protocol layer or service layer.
* Confirm endpoint and network values in `/reference/networks-and-endpoints`.
* Confirm auth requirements in `/reference/authentication-matrix`.

## Protocol vs service boundary

* Protocol layer: claim module transactions and state queries through protocol gateways.
* Service layer: product-specific reporting and workflow APIs (for example, Registry service endpoints).

## Claim workflow outline

1. Create or collect claim data.
2. Submit to the target surface (protocol or service).
3. Run evaluation and dispute handling.
4. Track lifecycle transitions.

## Example protocol message literal

```typescript theme={null}
const msg = {
  typeUrl: "/ixo.claims.v1beta1.MsgSubmitClaim",
  value: {
    creator,
    claimId,
    claimType,
    data: claimData
  }
};
```

## Verify the result

Expected result:

* accepted claim write or query response on the target surface;
* clear traceability of whether execution happened through protocol gateways or a service API.

## See also

<CardGroup cols={2}>
  <Card title="Identity and credentials" icon="id-card" href="/articles/identity-and-credentials">
    See how claims relate to DIDs and verifiable credentials.
  </Card>

  <Card title="Developer workflows" icon="diagram-project" href="/guides/dev/workflows">
    Follow SDK-oriented create and evaluate patterns.
  </Card>

  <Card title="Blockchain RPC API" icon="server" href="/api-reference/rpc-api">
    Reference protocol RPC methods and request patterns.
  </Card>

  <Card title="Registry API" icon="grid" href="/api-reference/registry-api">
    Integrate registry endpoints for claim-linked records.
  </Card>

  <Card title="Product and SDK map" icon="map" href="/reference/product-and-sdk-map">
    Confirm canonical product and SDK naming/routes.
  </Card>

  <Card title="Networks and endpoints" icon="network-wired" href="/reference/networks-and-endpoints">
    Use the correct environment endpoints and chain details.
  </Card>

  <Card title="Authentication matrix" icon="table" href="/reference/authentication-matrix">
    Match each API surface to required credentials.
  </Card>
</CardGroup>

## Troubleshooting

* **Broadcast / transaction failures** — Read `rawLog` or `code` from the node response. `insufficient funds`, `unauthorized`, and `sequence mismatch` are common: fix fees, signer, or account sequence. Compare your `chainId` and RPC URL with [Networks and endpoints](/reference/networks-and-endpoints).
* **GraphQL partial failures** — Blocksync may return `errors` alongside partial `data`. Treat the response as failed for downstream writes if any required field is null; re-check filters and IDs.
* **DID or entity not found** — Confirm the entity is indexed on the network you query; registry vs indexer lag can produce temporary “not found” results.

## Next steps

<CardGroup>
  <Card title="API introduction" icon="table" href="/api-reference/intro-apis">
    Use the API matrix to choose RPC, REST, GraphQL, or Registry for each workflow step.
  </Card>
</CardGroup>