Querying for a claim by claim ID

The GET /claim/v1/claims/{claimId} endpoint returns information on the given claim, assuming the caller's resource access permits the caller to view the claim.

For example, Andy Applegate owns the claim with ID cc:33. Betty Baker belongs to the same group as Andy Applegate, and therefore she has resource access permission to view claims assigned to Andy. Amy Baxter is a clerical user who works in a different group. She does not have resource access permission to view claim cc:33.

Suppose that each of these users triggers the following call:

GET /claim/v1/claims/cc:33?fields=claimNumber

The response for Andy Applegate is:

{
    "data": {
        "attributes": {
            "claimNumber": "235-53-425891"
        }
    }
}

The response for Betty Baker is:

{
    "data": {
        "attributes": {
            "claimNumber": "235-53-425891"
        }
    }
}

The response for Amy Baxter is:

{
    "status": 404,
    "errorCode": "gw.api.rest.exceptions.NotFoundException",
    "userMessage": "No resource was found at path /claim/v1/claims/cc:33"
}

Resource access is a component of the system API authentication and authorization framework. For more information on resource access, see the Cloud API Authentication Guide.