Skip to content

Instantly share code, notes, and snippets.

@vkostyukov
Last active June 13, 2024 16:30
Show Gist options
  • Save vkostyukov/32c84c0c01789425c29a to your computer and use it in GitHub Desktop.
Save vkostyukov/32c84c0c01789425c29a to your computer and use it in GitHub Desktop.
HTTP status codes used by world-famous APIs
API Status Codes
Twitter 200, 304, 400, 401, 403, 404, 406, 410, 420, 422, 429, 500, 502, 503, 504
Stripe 200, 400, 401, 402, 404, 429, 500, 502, 503, 504
Github 200, 400, 422, 301, 302, 304, 307, 401, 403
Pagerduty 200, 201, 204, 400, 401, 403, 404, 408, 500
NewRelic Plugins 200, 400, 403, 404, 405, 413, 500, 502, 503, 503
Etsy 200, 201, 400, 403, 404, 500, 503
Dropbox 200, 400, 401, 403, 404, 405, 429, 503, 507
Spotify 200, 201, 204, 304, 400, 401, 403, 404, 429, 500, 502, 503
Google Cloud 200, 301, 304, 307, 308, 400, 401, 403, 404, 405, 409, 411, 412, 416, 429, 500, 501, 503
HipChat 200, 201, 202, 400, 401, 403, 404, 405, 429, 500, 503
Telegram 200, 303, 400, 401, 403, 404, 420, 500
Pocket 200, 400, 401, 403, 503
Uber 200, 201, 400, 401, 403, 404, 406, 409, 422, 429, 500

Used by either one of them: 200, 201, 202, 204, 301, 302, 303, 304, 307, 308, 400, 401, 402, 403, 404, 405, 406, 408, 409, 410, 411, 412, 413, 416, 420, 422, 429, 500, 501, 502, 503, 504, 507

Used by at least two of them: 200, 201, 204, 301, 304, 307, 400, 401, 403, 404, 405, 406, 409, 420, 422, 429, 500, 502, 503, 504

Used by at least three of them: 200, 201, 304, 400, 401, 403, 404, 405, 422, 429, 500, 502, 503

Used by at least four of them: 200, 201, 304, 400, 401, 403, 404, 405, 429, 500, 502, 503

Used by at least five of them: 200, 201, 400, 401, 403, 404, 405, 429, 500, 503

Used by all of them: 200, 400

@rocco
Copy link

rocco commented Feb 5, 2016

I found this Gist here: http://racksburg.com/choosing-an-http-status-code/ - great read on the topic too.

@JohnBugner
Copy link

Google Cloud's link leads to Spotify's API. I think it was meant to lead to: https://cloud.google.com/storage/docs/xml-api/reference-status#http-status-and-error-codes . This is the XML API, but there's apparently a slightly different API for JSON: https://cloud.google.com/storage/docs/json_api/v1/status-codes#http-status-and-error-codes

@paulohfcanuto
Copy link

@dungsaga
Copy link

dungsaga commented Aug 3, 2017

https://httpstatuses.com/ is easier to read and has links to sections in RFC document.

@SteveOnorato
Copy link

@dret
Copy link

dret commented Feb 14, 2018

in case you're interested in a list that has links to all specifications and is available in machine-readable format as well: http://webconcepts.info/concepts/http-status-code/

@Yousha
Copy link

Yousha commented Feb 2, 2020

You forgot Discord: https://discordapp.com/developers/docs/topics/opcodes-and-status-codes

Pagerduty and uber pages NOT found. wrong page?

@fzyzcjy
Copy link

fzyzcjy commented Mar 10, 2020

good post, thanks!

@feenst
Copy link

feenst commented Apr 8, 2020

GitHub returns 404 in at least some cases.

@ad-m
Copy link

ad-m commented Apr 14, 2020

Modern status codes for Google Cloud: 200, 400, 401, 403, 404, 409, 429, 499, 500, 501, 503, 504
Source: https://github.com/googleapis/googleapis/blob/master/google/rpc/code.proto

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment