0

BatchRetrieveOrders

by
Published Oct 17, 2025

Retrieves a set of [orders]($m/Order) by their IDs. If a given order ID does not exist, the ID is ignored instead of generating an error.

Script square Verified

The script

Submitted by hugo697 Bun
Verified 235 days ago
1
//native
2
type Square = {
3
  token: string;
4
};
5
/**
6
 * BatchRetrieveOrders
7
 * Retrieves a set of [orders]($m/Order) by their IDs.
8

9
If a given order ID does not exist, the ID is ignored instead of generating an error.
10
 */
11
export async function main(
12
  auth: Square,
13
  body: { location_id?: string; order_ids: string[] },
14
) {
15
  const url = new URL(`https://connect.squareup.com/v2/orders/batch-retrieve`);
16

17
  const response = await fetch(url, {
18
    method: "POST",
19
    headers: {
20
      "Content-Type": "application/json",
21
      Authorization: "Bearer " + auth.token,
22
    },
23
    body: JSON.stringify(body),
24
  });
25
  if (!response.ok) {
26
    const text = await response.text();
27
    throw new Error(`${response.status} ${text}`);
28
  }
29
  return await response.json();
30
}
31