---
title: "List ownership inference history for a resource"
method: GET
path: "/api/v2/csm/ownership/{resource_id}/history"
tags: ["CSM Ownership"]
---

# List ownership inference history for a resource

`GET /api/v2/csm/ownership/{resource_id}/history`

## Request

- Base URL: `https://api.datadoghq.com`
- URL: `https://api.datadoghq.com/api/v2/csm/ownership/{resource_id}/history`
- Auth: API key in header `DD-API-KEY` and API key in header `DD-APPLICATION-KEY`

List inference history entries for a resource across all owner types, ordered from most recent to oldest. Uses cursor-based pagination.

## Path parameters

- `resource_id` string, required

## Query parameters

- `cursor` string
- `limit` integer

## Response `200`

OK

- OwnershipHistoryResponse: The response returned when listing the inference history for a resource.
  - `data` OwnershipHistoryData, required: The data wrapper for an ownership history response.
    - `attributes` OwnershipHistoryAttributes, required: The attributes of an ownership history response.
      - `items` OwnershipHistoryItem[], required: The list of history entries returned for this page.
        - `checksum` string, required: A checksum identifying the state of the inference at this point in time.
        - `confidence` string, required: The confidence score of the inference, expressed as a numeric string with up to four decimal places.
        - `created_at` string, date-time, required: The time this history entry was created.
        - `evidence_versions` OwnershipEvidenceVersion[], nullable, required: The list of evidence versions associated with an inference.
        - `explanation` string, required: A human-readable explanation of how the inference was produced.
        - `failed_at` string, date-time, nullable: The time when this inference failed, if applicable.
        - `failure_reason` string, nullable: The reason why this inference failed, if applicable.
        - `id` integer, required: The unique identifier of the history entry.
        - `owner_type` 'user' | 'team' | 'service' | 'unknown', required: The owner type for an ownership inference.
        - `primary_contact_ref` string, nullable: The primary contact reference for the inferred owner, formatted as `ref:handle/<owner_handle>`.
        - `resource_id` string, required: The identifier of the resource that the inference applies to.
        - `retry_schedule` string, date-time, nullable: The scheduled retry time for a failed inference, if applicable.
        - `sources` OwnershipInferenceSource[], required: The list of sources backing an ownership inference. Empty when the inference status is not whitelisted to expose sources.
        - `status` 'suggested' | 'persisted' | 'overridden' | 'failed' | 'unknown', required: The lifecycle status of an ownership inference.
      - `pagination` OwnershipHistoryPagination, required: Cursor-based pagination metadata for the history response.
        - `has_more` boolean, required: Whether more history entries are available beyond this page.
        - `next_cursor` string, nullable: An opaque, base64-encoded cursor token. Pass it as the `cursor` query parameter to retrieve the next page. Absent or `null` when there are no further pages.
    - `id` string, required: The resource identifier for which history is returned.
    - `type` 'ownership_history', required: The type of the ownership history resource. The value should always be `ownership_history`.

## Other responses

- `400`: Bad Request
- `401`: Unauthorized
- `429`: Too many requests

---

[API](https://skmtc.dev/datadog/apis/datadog-api-v2-collection.md) - [All operations](https://skmtc.dev/datadog/apis/datadog-api-v2-collection/llms.txt) - [OpenAPI document](https://skmtc.dev/datadog/apis/datadog-api-v2-collection/revisions/da68bf029e4c?raw)