---
title: ids (Filter IDs)
slug: graph/docs/ids-filter-ids
docTags: 
createdAt: 2026-07-30T20:30:19.772Z
---

The `ids` parameter lets you fetch a known set of content items by exact GUID match in Optimizely Graph, which is the fastest way to retrieve a specific item or a small, fixed list of items without writing a broader `where` filter. Use it when an application already holds the content GUIDs (for example, IDs persisted in a CMS reference field) and needs to project the latest field values.

The `ids` parameter lets you filter globally unique identifiers (GUIDs) through the `ContentLink.GuidValue` property. This parameter is an array of GUIDs.

## Request example

The following request retrieves a single `BiographyPage` item by its GUID and projects the `Name` and `ContentLink.GuidValue` fields.

```graphql
{
  BiographyPage (
    locale: en,
    ids: ["64ea99b4-fe38-43b7-a993-20ceb333861a"]
  )
  {
    Name,
    ContentLink{GuidValue}
  }
}
```