gRPC Status Code Lookup | gRPC to HTTP Codes

gRPC status code lookup explains all 17 codes with HTTP mapping, retry guidance and language constants. Paste a code, a name or a log line. Free. Designed specifically for developers and professionals, this free online networking runs entirely in your browser to process tasks quickly and securely. Enjoy unlimited usage with no data tracking and no registration required.

Also known as: grpc status code lookup · grpc error codes list · grpc to http status code mapping · grpc code 14 unavailable meaning · grpc deadline exceeded code · grpc retryable error codes · grpc status code reference · rpc error code lookup online

api and http tools

developer utilities

networking

Status Code Input

Status Code Details

All 17 gRPC Status Codes

Code	Name	HTTP	Retry	Meaning
0	OK	200 OK	n/a	The call completed successfully. This is the only non-error gRPC status.
1	CANCELLED	499 Client Closed Request	No	The operation was canceled, almost always by the client that started it.
2	UNKNOWN	500 Internal Server Error	No	An error whose status could not be determined, usually because it crossed the gRPC boundary untranslated.
3	INVALID_ARGUMENT	400 Bad Request	No	The client sent an argument the server rejects no matter what state the system is in.
4	DEADLINE_EXCEEDED	504 Gateway Timeout	Idempotent only	The deadline expired before the operation finished. The server may still have done the work.
5	NOT_FOUND	404 Not Found	No	The requested entity does not exist. Use PERMISSION_DENIED instead when hiding an entity from an unauthorized caller.
6	ALREADY_EXISTS	409 Conflict	No	The entity a client tried to create already exists.
7	PERMISSION_DENIED	403 Forbidden	No	The caller is authenticated but is not allowed to perform this operation. It says nothing about the request being well formed.
8	RESOURCE_EXHAUSTED	429 Too Many Requests	Yes, backoff	A per-user quota, a rate limit, or a resource such as disk space is exhausted.
9	FAILED_PRECONDITION	400 Bad Request	No	The system is not in the state the operation requires. Unlike ABORTED, a plain retry will not help.
10	ABORTED	409 Conflict	Yes, whole txn	The operation was aborted, typically by a concurrency conflict such as a failed transaction.
11	OUT_OF_RANGE	400 Bad Request	Sometimes	The operation was attempted past the valid range. Unlike INVALID_ARGUMENT, it can start succeeding as state changes.
12	UNIMPLEMENTED	501 Not Implemented	No	The method is not implemented, not registered, or not enabled on this server.
13	INTERNAL	500 Internal Server Error	No	An internal invariant expected by the system has been broken. Reserved for genuinely serious problems.
14	UNAVAILABLE	503 Service Unavailable	Yes, backoff	The service is unavailable right now. This is a transient condition and is safe to retry.
15	DATA_LOSS	500 Internal Server Error	No	Unrecoverable data loss or corruption.
16	UNAUTHENTICATED	401 Unauthorized	After refresh	The request has no valid credentials. Compare with PERMISSION_DENIED, where credentials are valid but insufficient.

About gRPC Status Code Lookup

A gRPC failure arrives as a bare integer or a terse name like code = 14, and the useful part, whether to retry and what the caller should see over HTTP, is nowhere in the message. This lookup takes a number, a constant name or a whole log line and returns the meaning, the HTTP status a gateway maps it to, retry guidance, and the exact constant in Go, Java, Python, Node, C# and Rust.

Key Features

Covers all 17 canonical codes from OK through UNAUTHENTICATED
Accepts a number, a constant name, or a raw rpc error line pasted from logs
Resolves many lines at once so you can triage a whole log excerpt
Shows the grpc-gateway HTTP mapping used by most REST transcoding setups
Says whether a code is safe to retry, and whether the retry belongs at a higher level
Prints the matching constant for Go, Java, Python, Node, C# and Rust tonic

Use Cases

Decode code = 14 during an incident without opening the gRPC source
Decide whether a failing call belongs in your retry policy or your alert rules
Pick the right status to return from a new handler you are writing
Map gRPC errors to HTTP responses behind grpc-gateway or Envoy transcoding
Explain the difference between FAILED_PRECONDITION and ABORTED in a code review
Translate a Python traceback status into the Go constant a teammate is using

Supported Formats

Numeric code 0-16

SCREAMING_SNAKE names

codes.Unavailable

grpc.StatusCode.NOT_FOUND

rpc error: code = ... desc = ...

Related Keywords

grpc status code lookup

grpc error codes list

grpc to http status code mapping

grpc code 14 unavailable meaning

grpc deadline exceeded code

grpc retryable error codes

grpc status code reference

rpc error code lookup online

Which gRPC status codes should a client retry?

UNAVAILABLE (14) is the one code gRPC treats as retryable by default, because it means the server was not reached or is restarting, so the call almost certainly had no effect. RESOURCE_EXHAUSTED (8) is retryable with backoff once the quota window moves. DEADLINE_EXCEEDED (4) is only safe for idempotent calls, since the server may have finished the work after your deadline expired. ABORTED (10) needs the whole read-modify-write sequence replayed, not just the one call. Everything else, including INTERNAL (13) and UNKNOWN (2), is a bug or a bad request, and retrying it just multiplies load during an outage.

Privacy & Security

All processing happens locally in your browser. Your data never leaves your computer, ensuring complete privacy and security.

Liked this tool?

DevToolLab is free to use. If this networking saved you some time today, please consider supporting our work.

Buy us a coffee ☕

Frequently asked questions

What is gRPC Status Code Lookup used for?

gRPC status code lookup explains all 17 codes with HTTP mapping, retry guidance and language constants. Paste a code, a name or a log line. Free.

Is gRPC Status Code Lookup free to use?

Yes. gRPC Status Code Lookup is completely free with no usage limits, and there is no paid tier required to use it.

Do I need an account to use gRPC Status Code Lookup?

No. gRPC Status Code Lookup works immediately in your browser with no signup, login, or email address required.

Related Tools

HTTP Status Checker | Check URL Response Code Online

Check HTTP status codes, response headers, and redirect chains for any URL. Identify 301/302 redirects, 404 errors, and server response times instantly. Free, no signup required.

api and http tools

url and link tools

Webhook Receiver & Inspector | Test HTTP Webhooks

Generate a unique URL to easily test, receive and inspect HTTP webhooks in real-time. View request headers, query parameters, JSON payloads, and more.

json tools

api and http tools

Subnet Calculator | IPv4 CIDR Network Calculator Online

Subnet calculator computes IPv4 network masks, broadcast addresses, and host ranges from any IP and CIDR prefix - fast, free, and works entirely in your browser.

network tools

networking

More Tools You Might Like

Pastebin Online | Share Code & Text Snippets Free

Popular

Share code snippets, logs, and text with a shareable link. Syntax highlighting for 30+ languages, expiration controls, and password protection for Pro users.

text tools

password and key generators

math calculators

utilities

Use Tool

URL Tracker & Link Shortener | Track Clicks

Popular

Create short, trackable URLs with detailed click analytics. Track visitor location, devices, referrers, and more. Password protection & QR codes included.

text tools

password and key generators

url and link tools

networking

Use Tool

Webhook Receiver & Inspector | Test HTTP Webhooks

Popular

Generate a unique URL to easily test, receive and inspect HTTP webhooks in real-time. View request headers, query parameters, JSON payloads, and more.