---
title: "Get Claim Photos by Claim ID"
method: GET
path: "/claims-management/claims/{claimId}/photos"
tags: ["Claims Management"]
---

# Get Claim Photos by Claim ID

`GET /claims-management/claims/{claimId}/photos`

## Request

- Base URL: `https://api.helloextend.com`
- URL: `https://api.helloextend.com/claims-management/claims/{claimId}/photos`
- Auth: none declared. Required headers: `Content-Type`, `X-Extend-Access-Token`, `X-Extend-Api-Version`

<html>
  <p>
    This endpoint returns the current set of photos required or uploaded for a
    given claim. Each call generates fresh presigned URLs for the photos so they
    can be downloaded directly from Extend's storage.
  </p>
  <h2>Important:</h2>
  <ul>
    <li>
      Presigned URLs returned by this endpoint are short-lived. Fetch the
      response and use the URLs immediately — do not cache them.
    </li>
    <li>
      Requests are scoped to the calling merchant. A claim that does not belong
      to the caller's store will return <b>403: Forbidden</b>.
    </li>
    <li>
      If the claim exists but has no photos, the endpoint returns
      <b>200</b> with an empty <code>photoDetails</code> array (not a 404).
    </li>
  </ul>
</html>

## Path parameters

- `claimId` string, uuid, required

## Headers

- `Content-Type` string, required
- `X-Extend-Access-Token` string, required
- `X-Extend-Api-Version` '2022-02-01', required

## Response `200`

Successfully retrieved claim photos

- object
  - `photoDetails` object[], required
    - `id` string, uuid, required: Unique identifier for the claim photo
    - `name` string: File name of the photo
    - `description` string: Description of the photo
    - `url` string, uri: Short-lived presigned URL to download the photo. Fetch and use immediately; expires shortly after issuance.
    - `source` 'chatbot' | 'ops_admin' | 'merchant_ops_admin', required: Source through which the photo was uploaded
    - `createdBy` string: Identifier of the user or system that uploaded the photo (typically an email)
    - `createdAt` number, required: Unix timestamp (ms) when the photo was created
    - `status` 'upload_started' | 'saved' | 'deleted' | 'photo_processing_started' | 'rejected' | 'upload_failed', required: Current status of the photo
    - `requirement` object: Photo requirement this upload satisfies

## Other responses

- `403`: Forbidden
- `404`: The specified resource was not found
- `500`: Internal server error
- `503`: Service unavailable

---

[API](https://skmtc.dev/extend/apis/claims-management-api.md) - [All operations](https://skmtc.dev/extend/apis/claims-management-api/llms.txt) - [OpenAPI document](https://skmtc.dev/extend/apis/claims-management-api/revisions/24e670a19948?raw)