# Alert Match History

> Pod Engine API endpoint reference, optimized for LLM consumption.
> Auto-generated from the source-of-truth endpoint registry.
>
> Category: Alerts
> Source: https://www.podengine.ai/api-docs/get-alert-match-history.md
> Interactive HTML docs: https://www.podengine.ai/api-docs/get-alert-match-history
> Full API reference (all endpoints): https://www.podengine.ai/api-docs/llms.txt

**Base URL:** `http://localhost:4000`
**Auth:** Requires a Bearer token: `Authorization: Bearer YOUR_API_KEY`

---

#### GET /api/v1/alerts/history
**Alert Match History**

Get the paginated history of alert matches for the team, optionally scoped to a single alert config.

```bash
curl -X GET "http://localhost:4000/api/v1/alerts/history" \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer YOUR_API_KEY"
```

**Query schema:**
```json
{
  "type": "object",
  "properties": {
    "alertConfigId": {
      "type": "string"
    },
    "page": {
      "type": "number"
    },
    "sinceDate": {}
  },
  "additionalProperties": false
}
```

**Response schema:**
```json
{
  "type": "object",
  "properties": {
    "status": {
      "type": "string",
      "enum": [
        "OK"
      ]
    },
    "data": {
      "type": "object",
      "properties": {
        "options": {
          "type": "object",
          "properties": {
            "alertConfigId": {
              "type": "string"
            },
            "page": {
              "type": "number"
            },
            "sinceDate": {}
          },
          "additionalProperties": false
        },
        "totalAlertMatches": {
          "type": "number"
        },
        "alertMatches": {
          "type": "array",
          "items": {
            "allOf": [
              {
                "type": "object",
                "properties": {
                  "advertisementLLMHistoryId": {
                    "nullable": true,
                    "type": "number"
                  },
                  "contextLLMHistoryId": {
                    "nullable": true,
                    "type": "number"
                  },
                  "episodeDate": {},
                  "episodeId": {
                    "type": "string"
                  },
                  "filteredOutReason": {
                    "nullable": true,
                    "type": "string"
                  },
                  "podcastId": {
                    "type": "string"
                  },
                  "processedDate": {},
                  "id": {
                    "type": "string"
                  },
                  "alertConfig": {
                    "type": "object",
                    "properties": {
                      "id": {
                        "type": "string"
                      },
                      "name": {
                        "type": "string"
                      },
                      "value": {
                        "type": "string"
                      },
                      "teamId": {
                        "type": "string"
                      },
                      "createdByUserId": {
                        "type": "string"
                      }
                    },
                    "required": [
                      "id",
                      "name",
                      "value",
                      "teamId",
                      "createdByUserId"
                    ],
                    "additionalProperties": false
                  },
                  "emailHistoryId": {
                    "nullable": true,
                    "type": "number"
                  },
                  "episodeSlug": {
                    "type": "string"
                  },
                  "episodeTitle": {
                    "type": "string"
                  },
                  "filteredOut": {
                    "type": "boolean"
                  },
                  "imageUrl": {
                    "nullable": true,
                    "type": "string"
                  },
                  "podcastSlug": {
                    "type": "string"
                  },
                  "podcastTitle": {
                    "type": "string"
                  },
                  "text": {
                    "type": "string"
                  }
                },
                "required": [
                  "advertisementLLMHistoryId",
                  "contextLLMHistoryId",
                  "episodeDate",
                  "episodeId",
                  "filteredOutReason",
                  "podcastId",
                  "processedDate",
                  "id",
                  "alertConfig",
                  "emailHistoryId",
                  "episodeSlug",
                  "episodeTitle",
                  "filteredOut",
                  "imageUrl",
                  "podcastSlug",
                  "podcastTitle",
                  "text"
                ],
                "additionalProperties": false
              },
              {
                "oneOf": [
                  {
                    "type": "object",
                    "properties": {
                      "advertisementLLMHistoryId": {
                        "nullable": true,
                        "type": "number"
                      },
                      "contextLLMHistoryId": {
                        "nullable": true,
                        "type": "number"
                      },
                      "episodeDate": {},
                      "episodeId": {
                        "type": "string"
                      },
                      "filteredOutReason": {
                        "nullable": true,
                        "type": "string"
                      },
                      "podcastId": {
                        "type": "string"
                      },
                      "processedDate": {},
                      "type": {
                        "type": "string",
                        "enum": [
                          "EPISODE"
                        ]
                      }
                    },
                    "required": [
                      "advertisementLLMHistoryId",
                      "contextLLMHistoryId",
                      "episodeDate",
                      "episodeId",
                      "filteredOutReason",
                      "podcastId",
                      "processedDate",
                      "type"
                    ],
                    "additionalProperties": false
                  },
                  {
                    "type": "object",
                    "properties": {
                      "advertisementLLMHistoryId": {
                        "nullable": true,
                        "type": "number"
                      },
                      "contextLLMHistoryId": {
                        "nullable": true,
                        "type": "number"
                      },
                      "episodeDate": {},
                      "episodeId": {
                        "type": "string"
                      },
                      "filteredOutReason": {
                        "nullable": true,
                        "type": "string"
                      },
                      "podcastId": {
                        "type": "string"
                      },
                      "processedDate": {},
                      "type": {
                        "type": "string",
                        "enum": [
                          "TRANSCRIPT"
                        ]
                      },
                      "endSecond": {
                        "type": "number"
                      },
                      "startSecond": {
                        "type": "number"
                      },
                      "transcriptEmbeddingId": {
                        "type": "string"
                      },
                      "transcriptId": {
                        "type": "string"
                      },
                      "transcriptionDate": {}
                    },
                    "required": [
                      "advertisementLLMHistoryId",
                      "contextLLMHistoryId",
                      "episodeDate",
                      "episodeId",
                      "filteredOutReason",
                      "podcastId",
                      "processedDate",
                      "type",
                      "endSecond",
                      "startSecond",
                      "transcriptEmbeddingId",
                      "transcriptId",
                      "transcriptionDate"
                    ],
                    "additionalProperties": false
                  }
                ]
              }
            ]
          }
        }
      },
      "required": [
        "options",
        "totalAlertMatches",
        "alertMatches"
      ],
      "additionalProperties": false
    }
  },
  "required": [
    "status",
    "data"
  ],
  "additionalProperties": false
}
```

---

## See also

- All endpoints in one file: https://www.podengine.ai/api-docs/llms.txt
- Full reference with every schema inlined: https://www.podengine.ai/api-docs/llms-full.txt
- OpenAPI 3.1 spec: https://www.podengine.ai/api-docs/openapi.json
- Get an API key: https://www.podengine.ai/get-started
- Support: support@podengine.ai