---
title: "Get delivery"
method: GET
path: "/v0/deliveries/{delivery_id}"
tags: ["Deliveries"]
---

# Get delivery

`GET /v0/deliveries/{delivery_id}`

## Request

- Base URL: `https://docs.quivr.thevibecompany.co` (the document declares no server; this is the origin it was published from)
- URL: `https://docs.quivr.thevibecompany.co/v0/deliveries/{delivery_id}`
- Auth: HTTP bearer

Read logical notification status and current admission view. Rights on the referenced Subscription/Corpus are still required for withdrawal-notice metadata.

## Path parameters

- `delivery_id` string, required

## Response `200`

Successful response

- Delivery
  - `delivery_id` string, required
  - `match_id` string, required
  - `destination_id` string, required
  - `state` 'pending' | 'delivering' | 'delivered' | 'exhausted', required
  - `event` WebhookEvent, required: Immutable reference-only notification. Retries preserve event_id and the exact stored body bytes; signing timestamp changes per attempt. No document content, excerpt, explanation, cursor or secret is embedded.
    - `event_id` string, required
    - `type` 'match.created' | 'match.corrected' | 'match.no_longer_matches' | 'match.withdrawn', required
    - `schema_version` '1', required
    - `occurred_at` string, date-time, required
    - `references` MonitoringReferences, required: owner is the Subscription Owner, so a client routes the notice to its user; absent for a global Subscription and in notices committed before owners existed. match_id is the new Match for created/corrected, prior positive Match for no_longer_matches/withdrawn. record_version_id is the causal correction version for corrected/no_longer_matches, otherwise the matched version. delivery_id is present only when a destination created a Delivery. References alone confer no access.
      - `match_id` string, required
      - `record_id` string, required
      - `record_version_id` string, required
      - `subscription_id` string, required
      - `subscription_version_id` string, required
      - `delivery_id` string
      - `previous_match_id` string
      - `owner` string: Subscription Owner, an opaque end-user reference defined by the client application (for example user-123). Quivr stores, filters and echoes it without interpreting it. At most 128 characters without control characters; none is reserved for the listing filter. A refused owner is 422 invalid_owner, in a creation body as in the listing filter.
  - `attempt_count` integer, required
  - `admission` DeliveryAdmission, required: Current derived admission view, separate from durable Delivery state. A disallowed pending Delivery makes no new network attempt; it does not become a new lifecycle state. destination_unavailable means its destination is no longer configured for the Organization. subscription_disabled lasts until a re-enable; subscription_deleted is permanent. record_withdrawn refuses match.created, match.corrected and match.no_longer_matches; match.withdrawn is admitted for a withdrawn Record. superseded refuses an undelivered match.created or match.corrected once a later match.corrected or match.no_longer_matches exists for the same Subscription and Record, and an undelivered match.no_longer_matches once a later match.corrected exists; match.withdrawn is never superseded.
    - `allowed` boolean, required
    - `reason` 'subscription_disabled' | 'subscription_deleted' | 'record_withdrawn' | 'superseded' | 'access_denied' | 'destination_unavailable' | 'terminal'
  - `last_error` Error
    - `request_id` string: Bounded caller X-Request-ID, or an engine-generated correlation ID.
    - `trace_id` string: W3C trace ID when a trace context is present.
    - `span_id` string: W3C span ID of the API handler when a trace context is present.
    - `code` string, required
    - `message` string, required
    - `retryable` boolean, required
    - `field` string: JSON Pointer (RFC 6901) to the request member that caused a 422, when known (for example /config/url or /credential/secret/token on connector commands).
    - `resync_url` string, uri-reference
  - `next_attempt_at` string, date-time: When the next automatic attempt becomes eligible. Present only while the Delivery is pending and admission is allowed; a retry waits with jittered exponential backoff (or a valid Retry-After on 429/503), never beyond the delivery window.

## Other responses

- `default`: Structured error. Existing /v0 authentication, scope, pagination and idempotency semantics apply.

---

[API](https://skmtc.dev/thevibecompany/apis/quivr-http-api.md) - [All operations](https://skmtc.dev/thevibecompany/apis/quivr-http-api/llms.txt) - [OpenAPI document](https://skmtc.dev/thevibecompany/apis/quivr-http-api/revisions/4f4e30ba8f4e?raw)