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.


{info} 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

Request Without If-None-Match Header

{primary.fa-paper-plane} Request

GET /orders HTTP/1.1

{success} Response

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

Request With If-None-Match Header

{primary.fa-paper-plane} Request

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

{success} Response

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