gRPC Status Code Lookup — Map and Debug Microservice Error Codes
Look up any of the 17 gRPC status codes by number or name. Instantly see the description, HTTP status equivalent, and common causes for each code. Covers all codes from OK (0) through UNAUTHENTICATED (16). Free and runs entirely in your browser.
How to Use gRPC Status Code Lookup — Map and Debug Microservice Error Codes
How to Use the gRPC Status Code Lookup:
Enter a Code or Name: Type a numeric code (0–16) or a status name such as NOT_FOUND, UNAUTHENTICATED, or DEADLINE_EXCEEDED into the input field. The lookup is case-insensitive and accepts spaces or hyphens in place of underscores, so "not found", "Not_Found", and "NOT_FOUND" all resolve to code 5.
Read the Result: The result card shows the numeric code, canonical name, category (Success / Client Error / Server Error), and a plain-language description of what the status means in the gRPC protocol.
Check the HTTP Equivalent: Below the main card you will find the nearest HTTP status code equivalent. gRPC runs over HTTP/2 but uses its own status space. When building HTTP/gRPC transcoding proxies (e.g., gRPC-Gateway, Google Cloud Endpoints, or Envoy), this mapping tells you what HTTP status your proxy should emit.
Review Common Causes: The Common Causes list explains the typical scenarios that produce each status code in production. Use it to narrow down what went wrong in your service or client code without reading through the full gRPC spec.
Use the Quick Reference Table: When the input is empty a full reference table of all 17 codes is shown. Click any row to load its full details — useful when scanning codes you are not yet familiar with.
Copy the Code: Click Copy Code to copy the numeric code and name (e.g., "5 NOT_FOUND") to the clipboard for use in error messages, runbooks, or documentation.
Common Use Cases:
- Debugging gRPC errors: Quickly decode an unfamiliar status code returned in a log or error response during development or on-call.
- Client-side error handling: Decide which codes to retry (UNAVAILABLE, DEADLINE_EXCEEDED) vs. surface to the user (NOT_FOUND, PERMISSION_DENIED) when writing gRPC client code.
- HTTP/gRPC transcoding: Map gRPC status codes to HTTP status codes when configuring Envoy, gRPC-Gateway, or a hand-written REST wrapper.
- API documentation: Reference the exact canonical name and HTTP equivalent when writing runbooks, incident reports, or API docs.
- Code reviews: Verify that a service is returning semantically correct status codes (e.g., INVALID_ARGUMENT instead of INTERNAL for user input errors).
Tips:
- Prefer INVALID_ARGUMENT over INTERNAL for bad user input — INTERNAL signals a server-side bug, not a client mistake.
- UNAVAILABLE is the correct code for transient failures; clients should retry with exponential backoff. INTERNAL signals a non-transient bug and should not be auto-retried.
- FAILED_PRECONDITION means the system state must change before the operation can succeed; INVALID_ARGUMENT means the request itself is always wrong regardless of system state.
- DEADLINE_EXCEEDED may be returned even when the operation actually completed on the server — design clients to handle this ambiguity with idempotency keys.
Frequently Asked Questions
Most Viewed Tools
Screen Size Converter — Diagonal Dimension Tool
Calculate screen width and height from diagonal size and aspect ratio. Convert between inches and centimeters for displays, TVs, and monitors with instant dimension calculations.
Use Tool →TOTP Code Generator — 2FA Testing Tool
Generate time-based one-time passwords from a TOTP secret key. Enter your base32 secret, choose a period and digit length, and get the current and next codes with a live countdown timer. Useful for testing and debugging 2FA integrations.
Use Tool →JSON to Zod — Schema Generator
Generate Zod validation schema code from a JSON sample object. Infers z.string(), z.number(), z.boolean(), z.array(), z.object(), and z.null() types automatically. Handles nested objects, arrays of objects with optional field detection, and outputs copy-ready TypeScript with import and z.infer type alias.
Use Tool →JSONL Formatter — Line-by-Line Validator
Format, validate, and inspect JSON Lines (JSONL) and NDJSON files. Validates each line individually, reports parse errors by line number, outputs compact JSONL or a pretty-print preview, and lets you download the cleaned file.
Use Tool →Password Entropy Calculator — Crack Time Estimator
Calculate the information-theoretic bit entropy of any password or API key. Detects character set pools automatically, shows the total number of possible combinations, and estimates crack time across five attack scenarios from rate-limited web logins to GPU cracking clusters.
Use Tool →TLS Cipher Suite Checker — Strength Analyzer
Check TLS protocol version compatibility and cipher suite strength ratings against current best practices. Supports IANA and OpenSSL cipher names — rates each suite as Strong, Weak, or Deprecated and explains why.
Use Tool →Secret Scanner — API Key & Credential Detector
Scan pasted text, code, or config files for accidentally exposed API keys, tokens, passwords, and private keys. Detects 50+ secret types across AWS, GitHub, Stripe, OpenAI, and more — all client-side, nothing leaves your browser.
Use Tool →TOML Config Validator — Syntax Error Finder
Validate TOML configuration file syntax and report errors with line numbers. Paste any TOML content — Cargo.toml, pyproject.toml, config.toml — and instantly see a green checkmark with key counts and structure stats, or a precise error message pointing to the exact line. Includes a collapsible JSON structure preview to confirm what was parsed.
Use Tool →Related API & Backend Tools
REST Endpoint Documenter — Markdown Doc Generator
Document a REST endpoint quickly by entering the URL, method, headers, and sample request/response. Generates formatted Markdown documentation and an example cURL command instantly.
Use Tool →JSON-RPC Builder — Compose and Validate JSON-RPC 2.0 Payloads
Build and validate JSON-RPC 2.0 request and notification payloads with method and params. Fill in the method name, optional params (named or positional), and an id — the tool validates the input against the JSON-RPC 2.0 specification and outputs a formatted payload plus a ready-to-run curl command. Supports requests, fire-and-forget notifications, and batch arrays. Five presets cover the most common patterns. Free and runs entirely in your browser.
Use Tool →API Changelog Generator — Automatically Detect Breaking Changes and Write Release Notes
Convert API change descriptions into structured Keep-a-Changelog format. Enter a version, date, and one change per line prefixed with its type (added, changed, deprecated, removed, fixed, or security). The tool instantly groups them into the canonical section order and outputs a ready-to-paste CHANGELOG.md block. Supports four real-world presets for REST API releases, breaking changes, patch releases, and unreleased work. Free and runs entirely in your browser.
Use Tool →GraphQL Cost Estimator — Analyze Query Complexity and Depth
Assign custom field weights to a GraphQL schema and calculate the total query complexity score. Paste any GraphQL query, configure per-field costs, and get a per-field breakdown table showing depth, multipliers, and cumulative cost.
Use Tool →HTTP Retry Policy Builder — Configure Resilient API Client Logic
Configure max retries, initial delay, backoff multiplier, jitter, max delay cap, and retryable HTTP status codes to instantly generate ready-to-use retry policy code for Axios (with axios-retry), native Fetch API (Node 18+ and node-fetch), and Go net/http. Supports presets for Standard, Aggressive, Conservative, and Rate-Limit Aware policies. All code is generated in your browser — free, instant, no signup.
Use Tool →Postman to OpenAPI Converter — Spec Migration Tool
Convert Postman Collection v2.1 JSON to OpenAPI 3.0 specification format. Upload or paste your collection, and get a downloadable openapi.yaml or openapi.json with mapped paths, parameters, request bodies, and example responses.
Use Tool →GraphQL Query Formatter — Mutation & Subscription Tool
Format and prettify GraphQL queries, mutations, subscriptions, and fragments with correct indentation.
Use Tool →Webhook Retry Config Calculator — Simulate Exponential Backoff & Jitter
Configure exponential backoff parameters and preview the full retry schedule for webhook delivery. Enter max attempts, initial delay, multiplier, jitter, and a max delay cap to instantly see each retry timestamp, cumulative elapsed time, jitter range, and which delays hit the cap. Supports presets for standard, aggressive, conservative, Stripe-style, and fixed-interval retry policies. Free and runs entirely in your browser.
Use Tool →Share Your Feedback
Help us improve this tool by sharing your experience