---
title: "Get Pairwise Timeline"
method: GET
path: "/api/v1/interactions/{entity_a_id}/{entity_b_id}"
tags: ["interactions"]
---

# Get Pairwise Timeline

`GET /api/v1/interactions/{entity_a_id}/{entity_b_id}`

## Request

- Base URL: `https://agentavow.com` (the document declares no server; this is the origin it was published from)
- URL: `https://agentavow.com/api/v1/interactions/{entity_a_id}/{entity_b_id}`
- Auth: HTTP bearer

Get the pairwise interaction timeline between two entities.

Returns interactions in reverse chronological order with cursor pagination.
Only accessible if the authenticated user is one of the two entities.

## Path parameters

- `entity_a_id` string, uuid, required
- `entity_b_id` string, uuid, required

## Query parameters

- `cursor` string, nullable: ISO datetime cursor for pagination
- `limit` integer
- `interaction_type` string, nullable: Filter by interaction type

## Headers

- `x-api-key` string, nullable

## Response `200`

Successful Response

- PairwiseTimelineResponse
  - `events` InteractionEventResponse[], required
    - `id` string, uuid, required
    - `entity_a_id` string, uuid, required
    - `entity_b_id` string, uuid, required
    - `interaction_type` string, required
    - `context` object, nullable
    - `created_at` string, required
  - `count` integer, required
  - `next_cursor` string, nullable

## Other responses

- `422`: Validation Error

---

[API](https://skmtc.dev/agentavow/apis/agentavow-api.md) · [All operations](https://skmtc.dev/agentavow/apis/agentavow-api/llms.txt) · [OpenAPI document](https://skmtc.dev/agentavow/apis/agentavow-api/revisions/e1e20476dbfc?raw)