This is the documentation for 2021-02-23 but the latest version is 2022-02-01. You can switch versions in the menu.

Conditional Request

All successful GET requests responses return an ETag header. You can use the ETag value to make subsequent requests to those resources using the If-None-Match header. If the resource has not changed, the server returns a 304 Not Modified.

Making a conditional request and receiving a 304 response does not count against your Rate Limit, so we encourage you to use it whenever possible.

Examples

Without If-None-Match Header

Request

GET /orders HTTP/1.1

Response

GET /orders HTTP/1.1 200 OK
ETag: "644b5b0155e6404a9cc4bd9d8b1ae730"

With If-None-Match Header

Request

GET /orders HTTP/1.1
If-None-Match: "644b5b0155e6404a9cc4bd9d8b1ae730"

Response

GET /orders HTTP/1.1 304 Not Modified
ETag: "644b5b0155e6404a9cc4bd9d8b1ae730"