Retrieve a delivery
One message's delivery to one endpoint.
bearerAuthAuthorizationBearer <token>A secret API key from the dashboard: coss_live_… for production environments, coss_test_… for sandbox environments.
application*stringThe application's id (happ_…) or your uid for it.
delivery_id*stringCoss-Version?"2026-10-10"The API version (a date) to use for this request. Defaults to your organization's version, pinned to the latest one when it first used the API and upgraded from the dashboard. The SDK always sends the version it was built for.
"2026-10-10"The delivery.
application/json- response
- response
- …
object*"hook_delivery""hook_delivery"id*stringapplication_id*stringThe id of the application.
message_id*stringThe id of the message being delivered.
endpoint_id*stringThe id of the endpoint it's delivered to.
status*stringpending: waiting for its next attempt. succeeded: the endpoint answered 2xx. failed: every attempt failed, or the endpoint was disabled or deleted.
"pending""succeeded""failed"attempt_count*integerHow many attempts were made so far.
next_attempt_at*|When the next attempt runs. null: none is due, because it finished.
date-timelast_status_code*|The endpoint's HTTP status on the latest attempt. null: no response arrived, or no attempt yet.
last_error*|Why the latest attempt failed. null: it didn't, or no attempt yet.
created_at*stringdate-timefinished_at*|When it succeeded or failed. null: still pending.
date-timeimport { Coss } from "coss";const coss = new Coss({ apiKey: process.env.COSS_API_KEY, baseUrl: "https://api.coss.com",});const { data, error } = await coss.hooks.deliveries.get("customer_8812", "hdel_01k7c8m4q2f3e9v6t5r1n0p8yz");{ "object": "hook_delivery", "id": "hdel_01k7c8m4q2f3e9v6t5r1n0p8yz", "application_id": "happ_01k7c8m4q2f3e9v6t5r1n0p8yz", "message_id": "hmsg_01k7c8m4q2f3e9v6t5r1n0p8yz", "endpoint_id": "hep_01k7c8m4q2f3e9v6t5r1n0p8yz", "status": "succeeded", "attempt_count": 1, "next_attempt_at": null, "last_status_code": 200, "last_error": null, "created_at": "2026-01-15T09:30:00.000Z", "finished_at": "2026-01-15T09:30:00.000Z"}