> For clean Markdown of any page, append .md to the page URL.
> For a complete documentation index, see https://docs-beta.getzep.com/v4/sdk-reference/lookup/batch/llms.txt.
> For AI client integration (Claude Code, Cursor, etc.), connect to the MCP server at https://docs-beta.getzep.com/_mcp/server.

# Batch lookup of developer ids

POST https://api.getzep.com/api/v4/lookup
Content-Type: application/json

Reference: https://docs-beta.getzep.com/sdk-reference/lookup/batch

## Authentication

- `Authorization` header (required) (prefixed with ` Api-Key  `) — Type "Api-Key" followed by a space and the project API key.

## Request

### Body (application/json)

This endpoint expects a v4.BatchLookupRequest.

- `graphs` (list of string, optional) — Developer-assigned graph IDs to resolve to UUIDs.
- `threads` (list of string, optional) — Developer-assigned thread IDs to resolve to UUIDs.
- `users` (list of string, optional) — Developer-assigned user IDs to resolve to UUIDs.

## Response

### 200

OK

- `items` (list of v4.LookupItem, optional) — The lookup result for each identifier submitted, in request order within each resource type.

## Errors

### 400 Bad Request Error

Bad Request

- `error` (v4.ErrorBody, optional)

### 401 Unauthorized Error

Unauthorized

- `error` (v4.ErrorBody, optional)

### 404 Not Found Error

Not Found

- `error` (v4.ErrorBody, optional)

## Types

### v4.LookupItem

- `found` (boolean, optional) — Whether the identifier resolved to a resource visible to the caller.
- `legacy_id` (string, optional) — The developer-assigned identifier that was looked up.
- `resource_type` (string, optional) — The type of resource this entry resolves: user, thread, or graph.
- `uuid` (string, optional) — The resource's unique identifier; present only when found is true.

### v4.ErrorBody

- `code` (string, optional)
- `details` (map from string to any, optional)
- `message` (string, optional)
- `param` (string, optional)
- `request_id` (string, optional)

## Examples

**Request**

```json
{}
```

**Response**

```json
{
  "items": [
    {
      "found": true,
      "legacy_id": "string",
      "resource_type": "string",
      "uuid": "string"
    }
  ]
}
```