Order API default limit

Hi there,

I’ve been trying to pull data using the order API, but the data returned never exceeded the default amount of 500 even when I set different limit. Here are my codes for your reference:

headers = {
‘Square-Version’: ‘2022-06-16’,
‘Authorization’: ‘MY_TOKEN’,
‘Content-Type’: ‘application/json’,

json_data = {
‘query’: {
‘filter’: {
‘date_time_filter’: {
‘created_at’: {
‘start_at’: ‘2022-04-01T00:00:00Z’,
‘end_at’: ‘2022-04-30T00:00:00Z’,
‘location_ids’: [
‘limit’: 5000,

response = requests.post(‘https://connect.squareup.com/v2/orders/search’, headers=headers, json=json_data)

:wave: With the Orders API the limit is the maximum number of results to be returned in a single page. It is possible to receive fewer results than the specified limit on a given page. At this time the maximum amount that can be returned is the default: 500. :slightly_smiling_face:

Thank Bryan

So does using oauth method surpass the 500 limit?

No, OAuth wouldn’t change the limit of orders that’s returned in the response. At this time the maximum about of orders that are returned in a response are 500. If the limit exceeds that the payload would be too big and you may experience performance issues. :slightly_smiling_face: