{
  "info": {
    "_postman_id": "725addf0-6859-4532-96a1-893f282f4493",
    "name": "TikTok API for Business Ad Groups Orders API",
    "description": "TikTok's advertising API enabling developers to create and manage ad campaigns, ad groups, creatives, audiences, and reporting for global advertisers on TikTok's platform.\n\nContact Support:\n Name: TikTok API for Business",
    "schema": "https://schema.getpostman.com/json/collection/v2.1.0/collection.json",
    "createdAt": "2026-07-28T03:14:16.000Z",
    "updatedAt": "2026-07-28T03:14:16.000Z",
    "lastUpdatedBy": "35240",
    "uid": "35240-725addf0-6859-4532-96a1-893f282f4493"
  },
  "item": [
    {
      "name": "order",
      "item": [
        {
          "name": "202309",
          "item": [
            {
              "name": "orders",
              "item": [
                {
                  "name": "{order_id}",
                  "item": [
                    {
                      "name": "Get Order",
                      "id": "495d4dd1-775a-4d0c-8156-d6cdd02c3c97",
                      "protocolProfileBehavior": {
                        "disableBodyPruning": true
                      },
                      "request": {
                        "method": "GET",
                        "header": [
                          {
                            "key": "Accept",
                            "value": "application/json"
                          }
                        ],
                        "url": {
                          "raw": "{{baseUrl}}/order/202309/orders/:order_id",
                          "host": [
                            "{{baseUrl}}"
                          ],
                          "path": [
                            "order",
                            "202309",
                            "orders",
                            ":order_id"
                          ],
                          "variable": [
                            {
                              "id": "76ea1e1f-57dc-44c5-ae72-95c404076f7e",
                              "key": "order_id",
                              "value": "<string>",
                              "description": "(Required) "
                            }
                          ]
                        },
                        "description": "Retrieves detailed information about a specific order by its ID."
                      },
                      "response": [
                        {
                          "id": "0c76e05b-59cc-4837-9b09-3f2c436c8cfc",
                          "name": "Order details retrieved successfully",
                          "originalRequest": {
                            "method": "GET",
                            "header": [
                              {
                                "key": "Accept",
                                "value": "application/json"
                              },
                              {
                                "description": "Added as a part of security scheme: apikey",
                                "key": "Access-Token",
                                "value": "<API Key>"
                              }
                            ],
                            "url": {
                              "raw": "{{baseUrl}}/order/202309/orders/:order_id",
                              "host": [
                                "{{baseUrl}}"
                              ],
                              "path": [
                                "order",
                                "202309",
                                "orders",
                                ":order_id"
                              ],
                              "variable": [
                                {
                                  "key": "order_id"
                                }
                              ]
                            }
                          },
                          "status": "OK",
                          "code": 200,
                          "_postman_previewlanguage": "json",
                          "header": [
                            {
                              "key": "Content-Type",
                              "value": "application/json"
                            }
                          ],
                          "cookie": [],
                          "responseTime": null,
                          "body": "{\n  \"code\": \"<integer>\",\n  \"message\": \"<string>\",\n  \"data\": {\n    \"order_id\": \"<string>\",\n    \"order_status\": \"<string>\",\n    \"create_time\": \"<integer>\",\n    \"paid_time\": \"<integer>\",\n    \"buyer_email\": \"<string>\",\n    \"recipient_address\": {\n      \"name\": \"<string>\",\n      \"phone_number\": \"<string>\",\n      \"address_line1\": \"<string>\",\n      \"city\": \"<string>\",\n      \"province_code\": \"<string>\",\n      \"postal_code\": \"<string>\",\n      \"region_code\": \"<string>\"\n    },\n    \"line_items\": [\n      {\n        \"item_id\": \"<string>\",\n        \"product_name\": \"<string>\",\n        \"sku_id\": \"<string>\",\n        \"quantity\": \"<integer>\",\n        \"sale_price\": {\n          \"amount\": \"<string>\",\n          \"currency\": \"<string>\"\n        }\n      },\n      {\n        \"item_id\": \"<string>\",\n        \"product_name\": \"<string>\",\n        \"sku_id\": \"<string>\",\n        \"quantity\": \"<integer>\",\n        \"sale_price\": {\n          \"amount\": \"<string>\",\n          \"currency\": \"<string>\"\n        }\n      }\n    ]\n  }\n}",
                          "createdAt": "2026-07-28T03:14:17.000Z",
                          "updatedAt": "2026-07-28T03:14:17.000Z",
                          "uid": "35240-0c76e05b-59cc-4837-9b09-3f2c436c8cfc"
                        }
                      ],
                      "createdAt": "2026-07-28T03:14:17.000Z",
                      "updatedAt": "2026-07-28T03:14:17.000Z",
                      "uid": "35240-495d4dd1-775a-4d0c-8156-d6cdd02c3c97"
                    }
                  ],
                  "id": "4ed39c70-8bb3-47e9-adc1-c11787848a6c",
                  "createdAt": "2026-07-28T03:14:17.000Z",
                  "updatedAt": "2026-07-28T03:14:17.000Z",
                  "uid": "35240-4ed39c70-8bb3-47e9-adc1-c11787848a6c"
                },
                {
                  "name": "List Orders",
                  "id": "9da4d27b-1858-461f-8421-5d1a4a2db640",
                  "protocolProfileBehavior": {
                    "disableBodyPruning": true
                  },
                  "request": {
                    "method": "GET",
                    "header": [
                      {
                        "key": "Accept",
                        "value": "application/json"
                      }
                    ],
                    "url": {
                      "raw": "{{baseUrl}}/order/202309/orders?page_size=10&page_token=<string>&order_status=CANCELLED&create_time_ge=<integer>&create_time_lt=<integer>",
                      "host": [
                        "{{baseUrl}}"
                      ],
                      "path": [
                        "order",
                        "202309",
                        "orders"
                      ],
                      "query": [
                        {
                          "key": "page_size",
                          "value": "10"
                        },
                        {
                          "key": "page_token",
                          "value": "<string>"
                        },
                        {
                          "description": "Filter by order status",
                          "key": "order_status",
                          "value": "CANCELLED"
                        },
                        {
                          "description": "Filter orders created after this Unix timestamp",
                          "key": "create_time_ge",
                          "value": "<integer>"
                        },
                        {
                          "description": "Filter orders created before this Unix timestamp",
                          "key": "create_time_lt",
                          "value": "<integer>"
                        }
                      ]
                    },
                    "description": "Retrieves a list of orders for the seller's TikTok Shop with filtering and pagination."
                  },
                  "response": [
                    {
                      "id": "07e8e8c3-decd-4248-906e-8afd5f1be277",
                      "name": "Orders retrieved successfully",
                      "originalRequest": {
                        "method": "GET",
                        "header": [
                          {
                            "key": "Accept",
                            "value": "application/json"
                          },
                          {
                            "description": "Added as a part of security scheme: apikey",
                            "key": "Access-Token",
                            "value": "<API Key>"
                          }
                        ],
                        "url": {
                          "raw": "{{baseUrl}}/order/202309/orders?page_size=10&page_token=<string>&order_status=CANCELLED&create_time_ge=<integer>&create_time_lt=<integer>",
                          "host": [
                            "{{baseUrl}}"
                          ],
                          "path": [
                            "order",
                            "202309",
                            "orders"
                          ],
                          "query": [
                            {
                              "key": "page_size",
                              "value": "10"
                            },
                            {
                              "key": "page_token",
                              "value": "<string>"
                            },
                            {
                              "description": "Filter by order status",
                              "key": "order_status",
                              "value": "CANCELLED"
                            },
                            {
                              "description": "Filter orders created after this Unix timestamp",
                              "key": "create_time_ge",
                              "value": "<integer>"
                            },
                            {
                              "description": "Filter orders created before this Unix timestamp",
                              "key": "create_time_lt",
                              "value": "<integer>"
                            }
                          ]
                        }
                      },
                      "status": "OK",
                      "code": 200,
                      "_postman_previewlanguage": "json",
                      "header": [
                        {
                          "key": "Content-Type",
                          "value": "application/json"
                        }
                      ],
                      "cookie": [],
                      "responseTime": null,
                      "body": "{\n  \"code\": \"<integer>\",\n  \"message\": \"<string>\",\n  \"data\": {\n    \"orders\": [\n      {\n        \"order_id\": \"<string>\",\n        \"order_status\": \"<string>\",\n        \"create_time\": \"<integer>\",\n        \"paid_time\": \"<integer>\",\n        \"buyer_email\": \"<string>\",\n        \"recipient_address\": {\n          \"name\": \"<string>\",\n          \"phone_number\": \"<string>\",\n          \"address_line1\": \"<string>\",\n          \"city\": \"<string>\",\n          \"province_code\": \"<string>\",\n          \"postal_code\": \"<string>\",\n          \"region_code\": \"<string>\"\n        },\n        \"line_items\": [\n          {\n            \"item_id\": \"<string>\",\n            \"product_name\": \"<string>\",\n            \"sku_id\": \"<string>\",\n            \"quantity\": \"<integer>\",\n            \"sale_price\": {\n              \"amount\": \"<string>\",\n              \"currency\": \"<string>\"\n            }\n          },\n          {\n            \"item_id\": \"<string>\",\n            \"product_name\": \"<string>\",\n            \"sku_id\": \"<string>\",\n            \"quantity\": \"<integer>\",\n            \"sale_price\": {\n              \"amount\": \"<string>\",\n              \"currency\": \"<string>\"\n            }\n          }\n        ]\n      },\n      {\n        \"order_id\": \"<string>\",\n        \"order_status\": \"<string>\",\n        \"create_time\": \"<integer>\",\n        \"paid_time\": \"<integer>\",\n        \"buyer_email\": \"<string>\",\n        \"recipient_address\": {\n          \"name\": \"<string>\",\n          \"phone_number\": \"<string>\",\n          \"address_line1\": \"<string>\",\n          \"city\": \"<string>\",\n          \"province_code\": \"<string>\",\n          \"postal_code\": \"<string>\",\n          \"region_code\": \"<string>\"\n        },\n        \"line_items\": [\n          {\n            \"item_id\": \"<string>\",\n            \"product_name\": \"<string>\",\n            \"sku_id\": \"<string>\",\n            \"quantity\": \"<integer>\",\n            \"sale_price\": {\n              \"amount\": \"<string>\",\n              \"currency\": \"<string>\"\n            }\n          },\n          {\n            \"item_id\": \"<string>\",\n            \"product_name\": \"<string>\",\n            \"sku_id\": \"<string>\",\n            \"quantity\": \"<integer>\",\n            \"sale_price\": {\n              \"amount\": \"<string>\",\n              \"currency\": \"<string>\"\n            }\n          }\n        ]\n      }\n    ],\n    \"next_page_token\": \"<string>\",\n    \"total_count\": \"<integer>\"\n  }\n}",
                      "createdAt": "2026-07-28T03:14:17.000Z",
                      "updatedAt": "2026-07-28T03:14:17.000Z",
                      "uid": "35240-07e8e8c3-decd-4248-906e-8afd5f1be277"
                    }
                  ],
                  "createdAt": "2026-07-28T03:14:17.000Z",
                  "updatedAt": "2026-07-28T03:14:17.000Z",
                  "uid": "35240-9da4d27b-1858-461f-8421-5d1a4a2db640"
                }
              ],
              "id": "bf16b9ba-9085-45cf-a69f-67d1ac6fd831",
              "createdAt": "2026-07-28T03:14:17.000Z",
              "updatedAt": "2026-07-28T03:14:17.000Z",
              "uid": "35240-bf16b9ba-9085-45cf-a69f-67d1ac6fd831"
            }
          ],
          "id": "cacc024d-3917-48b7-87d1-39afed80a95c",
          "createdAt": "2026-07-28T03:14:17.000Z",
          "updatedAt": "2026-07-28T03:14:17.000Z",
          "uid": "35240-cacc024d-3917-48b7-87d1-39afed80a95c"
        }
      ],
      "id": "7336c918-8889-4561-96b3-d143c9a87b30",
      "createdAt": "2026-07-28T03:14:17.000Z",
      "updatedAt": "2026-07-28T03:14:17.000Z",
      "uid": "35240-7336c918-8889-4561-96b3-d143c9a87b30"
    }
  ],
  "auth": {
    "type": "apikey",
    "apikey": [
      {
        "key": "key",
        "value": "Access-Token",
        "type": "string"
      },
      {
        "key": "value",
        "value": "{{apiKey}}",
        "type": "string"
      },
      {
        "key": "in",
        "value": "header",
        "type": "string"
      }
    ]
  },
  "variable": [
    {
      "key": "baseUrl",
      "value": "https://business-api.tiktok.com"
    }
  ]
}