---
title: "Get a SAM CPH holding"
method: GET
path: "/holdings/sam/{cph}"
tags: ["Holdings"]
---

# Get a SAM CPH holding

`GET /holdings/sam/{cph}`

Looks up a SAM CPH holding by its CPH value (format: CC/PPP/HHHH).

## Path parameters

- `cph` string, required

## Response `200`

SAM holding details

- SamCphHoldingResponse
  - `cph` string
  - `locationName` string, nullable
  - `holding` object
  - `herd` QueryResult
    - `collectionName` string
    - `count` integer
    - `totalCount` integer, nullable
    - `data` object[]
    - `executedAtUtc` string, date-time
  - `parties` QueryResult
    - `collectionName` string
    - `count` integer
    - `totalCount` integer, nullable
    - `data` object[]
    - `executedAtUtc` string, date-time
  - `holders` QueryResult
    - `collectionName` string
    - `count` integer
    - `totalCount` integer, nullable
    - `data` object[]
    - `executedAtUtc` string, date-time
  - `timestamp` string, date-time

## Other responses

- `400` — Invalid CPH format
- `404` — Holding not found
- `499` — Client closed request

---

[API](https://skmtc.net/defra/apis/keeper-data-bridge-api.md) · [All operations](https://skmtc.net/defra/apis/keeper-data-bridge-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/defra/keeper-data-bridge-api/versions/0ab7d7a7a24f/schema)