---
title: "List datastore items"
method: GET
path: "/api/v2/actions-datastores/{datastore_id}/items"
tags: ["Actions Datastores"]
---

# List datastore items

`GET /api/v2/actions-datastores/{datastore_id}/items`

## Request

- Base URL: `https://api.datadoghq.com`
- URL: `https://api.datadoghq.com/api/v2/actions-datastores/{datastore_id}/items`
- Auth: API key in header `DD-API-KEY` and API key in header `DD-APPLICATION-KEY`

Lists items from a datastore. You can filter the results by specifying either an item key or a filter query parameter, but not both at the same time. Supports server-side pagination for large datasets.

## Path parameters

- `datastore_id` string, required

## Query parameters

- `filter` string
- `item_key` string
- `page[limit]` integer
- `page[offset]` integer
- `sort` string

## Response `200`

OK

- ItemApiPayloadArray: A collection of datastore items with pagination and schema metadata.
  - `data` ItemApiPayloadData[], required: An array of datastore items with their content and metadata.
    - `attributes` ItemApiPayloadDataAttributes: Metadata and content of a datastore item.
      - `created_at` string, date-time: Timestamp when the item was first created.
      - `modified_at` string, date-time: Timestamp when the item was last modified.
      - `org_id` integer: The ID of the organization that owns this item.
      - `primary_column_name` string: The name of the primary key column for this datastore. Primary column names: - Must abide by both [PostgreSQL naming conventions](https://www.postgresql.org/docs/7.0/syntax525.htm) - Cannot exceed 63 characters
      - `signature` string: A unique signature identifying this item version.
      - `store_id` string: The unique identifier of the datastore containing this item.
      - `value` ItemApiPayloadDataAttributesValue: The data content (as key-value pairs) of a datastore item.
    - `id` string: The unique identifier of the datastore.
    - `type` 'items', required: The resource type for datastore items.
  - `meta` ItemApiPayloadMeta: Additional metadata about a collection of datastore items, including pagination and schema information.
    - `page` ItemApiPayloadMetaPage: Pagination information for a collection of datastore items.
      - `hasMore` boolean: Whether there are additional pages of items beyond the current page.
      - `totalCount` integer: The total number of items in the datastore, ignoring any filters.
      - `totalFilteredCount` integer: The total number of items that match the current filter criteria.
    - `schema` ItemApiPayloadMetaSchema: Schema information about the datastore, including its primary key and field definitions.
      - `fields` ItemApiPayloadMetaSchemaField[]: An array describing the columns available in this datastore.
        - `name` string, required: The name of this column in the datastore.
        - `type` string, required: The data type of this column. For example, 'string', 'number', or 'boolean'.
      - `primary_key` string: The name of the primary key column for this datastore.

## Other responses

- `400`: Bad Request
- `404`: Not Found
- `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)