# List dead letters `GET https://events.inovacc.dev/v1/workspaces/{workspace_id}/dead` List the events that could not be delivered, newest first. ## Path params - `workspace_id` (string), required: Your workspace. A credential bound to a workspace may name only its own. ## Query params - `limit` (integer): 1 to 100. Default 50. The only query parameter the Events API accepts. ## Headers - `Authorization` (string), required: Bearer ## Request **cURL** ```sh curl "https://events.inovacc.dev/v1/workspaces/{workspace_id}/dead" \ -H "Authorization: Bearer $INOVACC_API_KEY" ``` **TypeScript** ```ts const url = "https://events.inovacc.dev/v1/workspaces/{workspace_id}/dead"; const response = await fetch(url, { method: "GET", headers: { Authorization: `Bearer ${process.env.INOVACC_API_KEY}`, }, }); console.log(response.status, await response.text()); ``` **Python** ```py import os import urllib.request request = urllib.request.Request( "https://events.inovacc.dev/v1/workspaces/{workspace_id}/dead", method="GET", headers={ "User-Agent": "inovacc-python-sample", "Authorization": "Bearer " + os.environ["INOVACC_API_KEY"], }, ) with urllib.request.urlopen(request) as response: print(response.status, response.read().decode()) ``` **Go** ```go package main import ( "fmt" "io" "net/http" "os" ) const url = "https://events.inovacc.dev/v1/workspaces/{workspace_id}/dead" func main() { req, err := http.NewRequest("GET", url, nil) if err != nil { panic(err) } req.Header.Set("Authorization", "Bearer "+os.Getenv("INOVACC_API_KEY")) res, err := http.DefaultClient.Do(req) if err != nil { panic(err) } defer res.Body.Close() out, err := io.ReadAll(res.Body) if err != nil { panic(err) } fmt.Println(res.Status, string(out)) } ``` **Rust** ```rs // Cargo.toml: reqwest = { version = "0.12", features = ["blocking", "json"] } fn main() -> Result<(), Box> { let api_key = std::env::var("INOVACC_API_KEY")?; let response = reqwest::blocking::Client::new() .get("https://events.inovacc.dev/v1/workspaces/{workspace_id}/dead") .bearer_auth(api_key) .send()?; println!("{} {}", response.status(), response.text()?); Ok(()) } ``` **JavaScript** ```mjs const url = "https://events.inovacc.dev/v1/workspaces/{workspace_id}/dead"; const response = await fetch(url, { method: "GET", headers: { Authorization: `Bearer ${process.env.INOVACC_API_KEY}`, }, }); console.log(response.status, await response.text()); ``` **PHP** ```php true, CURLOPT_HTTPHEADER => [ 'Authorization: Bearer ' . getenv('INOVACC_API_KEY'), ], ]); $response = curl_exec($curl); echo curl_getinfo($curl, CURLINFO_HTTP_CODE), ' ', $response, "\n"; curl_close($curl); ``` **Ruby** ```rb require "net/http" require "uri" uri = URI('https://events.inovacc.dev/v1/workspaces/{workspace_id}/dead') request = Net::HTTP::Get.new(uri) request["Authorization"] = "Bearer #{ENV.fetch('INOVACC_API_KEY')}" response = Net::HTTP.start(uri.host, uri.port, use_ssl: uri.scheme == "https") do |http| http.request(request) end puts "#{response.code} #{response.body}" ``` **Java** ```java import java.net.URI; import java.net.http.HttpClient; import java.net.http.HttpRequest; import java.net.http.HttpResponse; public class Main { public static void main(String[] args) throws Exception { String apiKey = System.getenv("INOVACC_API_KEY"); HttpRequest request = HttpRequest.newBuilder() .uri(URI.create("https://events.inovacc.dev/v1/workspaces/{workspace_id}/dead")) .header("Authorization", "Bearer " + apiKey) .GET() .build(); HttpResponse response = HttpClient.newHttpClient() .send(request, HttpResponse.BodyHandlers.ofString()); System.out.println(response.statusCode() + " " + response.body()); } } ``` **C#** ```cs var url = "https://events.inovacc.dev/v1/workspaces/{workspace_id}/dead"; var apiKey = Environment.GetEnvironmentVariable("INOVACC_API_KEY"); using var client = new HttpClient(); using var request = new HttpRequestMessage(HttpMethod.Get, url); request.Headers.Add("Authorization", $"Bearer {apiKey}"); using var response = await client.SendAsync(request); Console.WriteLine($"{(int)response.StatusCode} {await response.Content.ReadAsStringAsync()}"); ``` **Kotlin** ```kt import java.net.URI import java.net.http.HttpClient import java.net.http.HttpRequest import java.net.http.HttpResponse fun main() { val apiKey = System.getenv("INOVACC_API_KEY") val request = HttpRequest.newBuilder() .uri(URI.create("https://events.inovacc.dev/v1/workspaces/{workspace_id}/dead")) .header("Authorization", "Bearer " + apiKey) .GET() .build() val response = HttpClient.newHttpClient() .send(request, HttpResponse.BodyHandlers.ofString()) println("${response.statusCode()} ${response.body()}") } ``` **Swift** ```swift import Foundation #if canImport(FoundationNetworking) import FoundationNetworking #endif let apiKey = ProcessInfo.processInfo.environment["INOVACC_API_KEY"] ?? "" let url = URL(string: "https://events.inovacc.dev/v1/workspaces/{workspace_id}/dead")! var request = URLRequest(url: url) request.httpMethod = "GET" request.setValue("Bearer \(apiKey)", forHTTPHeaderField: "Authorization") let (data, response) = try await URLSession.shared.data(for: request) let status = (response as? HTTPURLResponse)?.statusCode ?? 0 print(status, String(decoding: data, as: UTF8.self)) ``` ## Response **200** ```json { "dead": [ { "event_id": "evt_01JCA4X9QY7M2KZ3N8PB5RT6VW", "event": { "event_id": "evt_01JCA4X9QY7M2KZ3N8PB5RT6VW", "type": "order.paid", "source": "checkout", "time": "2026-10-06T12:00:00.000Z", "tenant": { "organization_id": "o1", "account_id": "a1", "workspace_id": "w1", "application_id": "app1" }, "idempotency_key": "pay_123", "data": { "order_id": "ord_42" } }, "last_error": "webhook_timeout", "attempts": 5, "dead_at": "2026-10-06T12:40:00.000Z", "replay_count": 0 } ] } ``` **400**: invalid_query, invalid_limit **401**: invalid_credentials **403**: forbidden **429**: rate_limited **503**: service_unavailable ## See also - [Authentication](https://developer.inovacc.dev/en/guides/authentication/) - [Errors](https://developer.inovacc.dev/en/guides/errors/) - [Limits](https://developer.inovacc.dev/en/guides/limits/)