VTEX · Example Payload

Vtex List Orders Example

CommerceE-CommerceRetailMarketplacePayments

Vtex List Orders Example is an example object payload from VTEX, with 3 top-level fields. It illustrates the shape of data this provider's APIs accept or return.

Top-level fields

titlerequestresponse

Example Payload

{
  "title": "VTEX List Orders - Example Request and Response",
  "request": {
    "method": "GET",
    "url": "https://{accountName}.vtexcommercestable.com.br/api/oms/pvt/orders?f_status=ready-for-handling&orderBy=creationDate,desc&page=1&per_page=15",
    "headers": {
      "X-VTEX-API-AppKey": "{your-app-key}",
      "X-VTEX-API-AppToken": "{your-app-token}",
      "Accept": "application/json",
      "Content-Type": "application/json"
    }
  },
  "response": {
    "status": 200,
    "headers": {
      "Content-Type": "application/json"
    },
    "body": {
      "list": [
        {
          "orderId": "v1234567890-01",
          "sequence": "500001",
          "origin": "Marketplace",
          "affiliateId": "",
          "salesChannel": "1",
          "merchantName": null,
          "status": "ready-for-handling",
          "statusDescription": "Ready for Handling",
          "value": 15990,
          "creationDate": "2026-05-01T14:32:00.0000000+00:00",
          "lastChange": "2026-05-01T14:45:00.0000000+00:00",
          "orderIsComplete": true,
          "listId": null,
          "listType": null,
          "authorizedDate": "2026-05-01T14:45:00.0000000+00:00",
          "callCenterOperatorName": null,
          "totalItems": 2,
          "currencyCode": "USD",
          "shippingEstimatedDate": "2026-05-05T23:59:59.0000000+00:00"
        }
      ],
      "facets": [],
      "paging": {
        "total": 1,
        "pages": 1,
        "currentPage": 1,
        "perPage": 15
      },
      "stats": {
        "stats": {
          "totalValue": {
            "Count": 1,
            "Max": 15990,
            "Mean": 15990.0,
            "Min": 15990,
            "Missing": 0,
            "StdDev": 0.0,
            "Sum": 15990,
            "SumOfSquares": 255680100.0,
            "Facets": {}
          }
        }
      }
    }
  }
}

Work with this as data

Every example here is available over the APIs.io API and to AI agents over MCP.

MCP server

One button, every client — Claude, Cursor, VS Code and the rest.

https://apis.io/mcp

Tools for examples

4 MCP tools reach this

find_examplesBrowse and filter every example in the catalog.
apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.
resolveTurn a domain, URL or GitHub org into the provider it belongs to.
find_cohortsEvery scored population of providers in the catalog.

All 92 tools

Call it yourself

curl for this page

This example

curl "https://apis.io/api/v1/examples/vtex-list-orders-example"

All examples

curl "https://apis.io/api/v1/examples?limit=25"

Discovery needs no key. Ratings and market analysis are Pro.

Get an API key

Free tier, no email required.

GitHub Google LinkedIn

A second provider on the same verified email joins the account you already have.