gRPC Status Codes

gRPC uses a fixed set of 17 status codes defined in google.rpc.Code. Unlike HTTP, every gRPC response includes a status code – there is no "no status." Code 0 (OK) indicates success; all others indicate failure.

Status Codes

Code	Name	Description	HTTP ~
0	OK	The operation completed successfully.	200
1	CANCELLED	The operation was cancelled, typically by the caller.	499
2	UNKNOWN	An unknown error occurred.	500
3	INVALID_ARGUMENT	The client specified an invalid argument.	400
4	DEADLINE_EXCEEDED	The deadline for the operation expired before it could complete.	504
5	NOT_FOUND	The requested entity was not found.	404
6	ALREADY_EXISTS	The entity that a client attempted to create already exists.	409
7	PERMISSION_DENIED	The caller does not have permission to execute the operation.	403
8	RESOURCE_EXHAUSTED	Some resource has been exhausted – per-user quota exceeded, disk space full, or rate limit hit.	429
9	FAILED_PRECONDITION	The operation was rejected because the system is not in a state required for the operation.	400
10	ABORTED	The operation was aborted, typically due to a concurrency issue such as a sequencer check failure or transaction abort.	409
11	OUT_OF_RANGE	The operation was attempted past the valid range – for example, seeking past the end of a file, or reading beyond the end of an iterator.	400
12	UNIMPLEMENTED	The operation is not implemented or not supported by this server.	501
13	INTERNAL	Internal server error.	500
14	UNAVAILABLE	The server is currently unavailable.	503
15	DATA_LOSS	Unrecoverable data loss or corruption occurred.	500
16	UNAUTHENTICATED	The request does not have valid authentication credentials.	401