---
title: "Batch search webhook results"
method: POST
path: "/v2/webhooks/results"
tags: ["Webhooks"]
---

# Batch search webhook results

`POST /v2/webhooks/results`

Search webhook results for multiple parcels at once.
Use this to retrieve final results of registered webhooks.

**Search methods:**
- Search by carrier + trackingNumber
- Search by clientId
- Both methods can be used simultaneously

**How it works:**
- Searches using trackingIndex/clientIdIndex fields in the tracking_requests collection
- Returns only the latest document when multiple documents exist for the same tracking number
- Batch processed due to Firestore array-contains-any limit (10) (up to 10 queries for 100 items)

Free API - does not count towards usage quota.

## Request body

- SearchWebhookResultsBatchRequest — Batch search request
  - `trackingItems` union[], required
    - union
      - object
        - `carrier` string, required
        - `trackingNumber` string, required
      - object
        - `clientId` string, required

## Response `200`

Batch search completed successfully

- SearchWebhookResultsBatchResponse
  - `results` Record3Cstring2C7Bsource3A22none227C22bulk227C22cache223Bdata3ATrackingData7CTrackingData5B5D7Cnull3Bstatus3F3Astring7Cnull7Cundefined3BjobId3F3Astring7Cundefined3BcreatedAt3F3Astring7Cundefined3B7D3E, required — unresolved $ref

## Other responses

- `401` — Authentication failed

---

[API](https://skmtc.dev/whereparcel/apis/whereparcel-api.md) · [All operations](https://skmtc.dev/whereparcel/apis/whereparcel-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/whereparcel/whereparcel-api/revisions/629880970b8b/schema)