> For clean Markdown of any page, append .md to the page URL.
> For a complete documentation index, see https://developers.sellercenter.pe/llms.txt.
> For AI client integration (Claude Code, Cursor, etc.), connect to the MCP server at https://developers.sellercenter.pe/_mcp/server.

# Listar órdenes

GET https://inretailqa.mysellercenter.com/sellercenter/api/v1/orders

Lista las órdenes de tu tienda, de la más reciente a la más antigua.

### Filtros más usados

| Para ver…                    | Usa                         |
| ---------------------------- | --------------------------- |
| Órdenes nuevas por atender   | `status=ready-for-handling` |
| Órdenes en preparación       | `status=handling`           |
| Órdenes facturadas           | `status=invoiced`           |
| Una orden por número o texto | `text=<número de orden>`    |

* Todos los filtros son opcionales; activa los que necesites en **Params**.
* Paginación con `from` y `size`: repite la consulta aumentando `from` hasta que la respuesta sea una lista vacía.
* La respuesta es una **lista** de órdenes con la misma estructura del **Detalle de orden**.

> Si recibes webhooks, usa esta consulta como respaldo (cada 5–10 minutos) para recuperar órdenes cuya notificación se haya perdido.

Reference: https://developers.sellercenter.pe/referencia-de-la-api/ordenes/listar-ordenes

## Authentication

- `Authorization` header (bearer token, required) — `accessToken` obtenido en **Login**. Dura 24 horas.

## Servers

- `https://inretailqa.mysellercenter.com/sellercenter/api/v1` (QA, default)
- `https://inretail.mysellercenter.com/sellercenter/api/v1` (PRD)

## Request

### Query parameters

- `status` (string, optional) — Estado de la orden. Ver la tabla de estados en la carpeta.
- `text` (string, optional) — Número de orden u otro texto a buscar.
- `fromDate` (string, optional) — Fecha de creación: desde.
- `toDate` (string, optional) — Fecha de creación: hasta.
- `from` (string, optional) — Desde qué registro (paginación).
- `size` (string, optional) — Cantidad de registros.
- `sortBy` (string, optional) — Campo de orden.
- `sortOrder` (string, optional) — `asc` o `desc`.

## Response

### 200

Órdenes

- `list of OrdersGetResponsesContentApplicationJsonSchemaItems`

## Types

### OrdersGetResponsesContentApplicationJsonSchemaItems

- `id` (string, optional)
- `marketplacePaymentValue` (double, optional)
- `items` (list of OrdersGetResponsesContentApplicationJsonSchemaItemsItemsItems, optional)
- `clientProfileData` (OrdersGetResponsesContentApplicationJsonSchemaItemsClientProfileData, optional)
- `shippingData` (OrdersGetResponsesContentApplicationJsonSchemaItemsShippingData, optional)
- `openTextField` (any, optional)
- `creationDate` (string, optional)
- `status` (string, optional)
- `packageAttachment` (any, optional)
- `value` (double, optional)
- `totals` (list of OrdersGetResponsesContentApplicationJsonSchemaItemsTotalsItems, optional)
- `accountName` (string, optional)
- `controversies` (any, optional)
- `liquidated` (any, optional)
- `punishment` (any, optional)
- `marketplace` (OrdersGetResponsesContentApplicationJsonSchemaItemsMarketplace, optional)
- `tags` (list of any, optional)
- `updateDate` (string, optional)
- `updateHistory` (list of OrdersGetResponsesContentApplicationJsonSchemaItemsUpdateHistoryItems, optional)
- `paymentMethod` (string, optional)
- `paymentProof` (any, optional)

### OrdersGetResponsesContentApplicationJsonSchemaItemsItemsItems

- `id` (string, optional)
- `productId` (string, optional)
- `categoryId` (string, optional)
- `quantity` (double, optional)
- `seller` (string, optional)
- `price` (double, optional)
- `measurementUnit` (string, optional)
- `unitMultiplier` (double, optional)
- `isGift` (boolean, optional)
- `name` (string, optional)
- `commission` (double, optional)
- `priceTags` (list of any, optional)

### OrdersGetResponsesContentApplicationJsonSchemaItemsClientProfileData

- `id` (any, optional)
- `email` (string, optional)
- `firstName` (string, optional)
- `lastName` (string, optional)
- `documentType` (string, optional)
- `document` (string, optional)
- `phone` (string, optional)
- `corporateName` (any, optional)
- `tradeName` (any, optional)
- `corporateDocument` (any, optional)
- `stateInscription` (any, optional)
- `corporatePhone` (any, optional)
- `isCorporate` (boolean, optional)
- `userProfileId` (any, optional)

### OrdersGetResponsesContentApplicationJsonSchemaItemsShippingData

- `id` (any, optional)
- `address` (OrdersGetResponsesContentApplicationJsonSchemaItemsShippingDataAddress, optional)
- `logisticsInfo` (list of OrdersGetResponsesContentApplicationJsonSchemaItemsShippingDataLogisticsInfoItems, optional)

### OrdersGetResponsesContentApplicationJsonSchemaItemsTotalsItems

- `id` (string, optional)
- `name` (string, optional)
- `value` (double, optional)

### OrdersGetResponsesContentApplicationJsonSchemaItemsMarketplace

- `id` (string, optional)
- `name` (string, optional)
- `accountName` (string, optional)

### OrdersGetResponsesContentApplicationJsonSchemaItemsUpdateHistoryItems

- `id` (string, optional)
- `user` (any, optional)
- `date` (string, optional)
- `status` (string, optional)

### OrdersGetResponsesContentApplicationJsonSchemaItemsShippingDataAddress

- `addressType` (string, optional)
- `receiverName` (string, optional)
- `addressId` (string, optional)
- `postalCode` (string, optional)
- `city` (string, optional)
- `state` (string, optional)
- `country` (string, optional)
- `street` (string, optional)
- `number` (string, optional)
- `neighborhood` (string, optional)
- `complement` (string, optional)
- `reference` (string, optional)

### OrdersGetResponsesContentApplicationJsonSchemaItemsShippingDataLogisticsInfoItems

- `itemIndex` (double, optional)
- `selectedSla` (string, optional)
- `lockTTL` (string, optional)
- `shippingEstimate` (string, optional)
- `price` (double, optional)
- `deliveryWindow` (any, optional)
- `deliveryCompany` (string, optional)
- `shippingEstimateDate` (string, optional)
- `selectedDeliveryChannel` (string, optional)
- `collectionDate` (any, optional)
- `sellerType` (any, optional)

## Examples

**Response**

```json
[
  {
    "id": "1671730516377-01",
    "marketplacePaymentValue": 504.9,
    "items": [
      {
        "id": "1791571082273",
        "productId": "1791571080770",
        "categoryId": "YbC223HTMKzUKWRI95_a",
        "quantity": 1,
        "seller": "1",
        "price": 489.9,
        "measurementUnit": "un",
        "unitMultiplier": 1,
        "isGift": false,
        "name": "Zapatillas Running Nike Air Winflo 12 Azul Nike Air Winflo 12 Azul - Talla 7",
        "commission": 0,
        "priceTags": []
      }
    ],
    "clientProfileData": {
      "email": "cliente@correo.com",
      "firstName": "Juan",
      "lastName": "Pérez",
      "documentType": "dni",
      "document": "77777777",
      "phone": "+51999999999",
      "isCorporate": false
    },
    "shippingData": {
      "address": {
        "addressType": "residential",
        "receiverName": "Juan Pérez",
        "addressId": "casa",
        "postalCode": "150122",
        "city": "Lima",
        "state": "Lima",
        "country": "PER",
        "street": "Av. Ejemplo",
        "number": "123",
        "neighborhood": "Miraflores",
        "complement": "Dpto. 401",
        "reference": "Frente al parque"
      },
      "logisticsInfo": [
        {
          "itemIndex": 0,
          "selectedSla": "Envío a domicilio(wG8uy4QBU0PKXr-ggChM)",
          "lockTTL": "15d",
          "shippingEstimate": "7bd",
          "price": 15,
          "deliveryCompany": "ENVIO DD LIMA",
          "shippingEstimateDate": "2026-11-04T16:12:28",
          "selectedDeliveryChannel": "delivery"
        }
      ]
    },
    "creationDate": "2026-10-26T16:12:28",
    "status": "ready-for-handling",
    "value": 504.9,
    "totals": [
      {
        "id": "Items",
        "name": "Total de los items",
        "value": 489.9
      }
    ],
    "accountName": "TRIATHLON",
    "marketplace": {
      "id": "qaoechsle",
      "name": "Oechsle QA",
      "accountName": "qaoechsle"
    },
    "tags": [],
    "updateDate": "2026-10-26T16:13:08",
    "updateHistory": [
      {
        "id": "1671730516377-01",
        "date": "2026-10-26T16:12:28",
        "status": "payment-pending"
      }
    ],
    "paymentMethod": "Contra Entrega - TARJETA OH"
  }
]
```

**SDK Code**

```python Ordenes_listarOrdenes_example
import requests

url = "https://inretailqa.mysellercenter.com/sellercenter/api/v1/orders"

querystring = {"from":"0","size":"20","sortBy":"creationDate","sortOrder":"desc","status":"ready-for-handling"}

headers = {"Authorization": "Bearer <token>"}

response = requests.get(url, headers=headers, params=querystring)

print(response.json())
```

```javascript Ordenes_listarOrdenes_example
const url = 'https://inretailqa.mysellercenter.com/sellercenter/api/v1/orders?from=0&size=20&sortBy=creationDate&sortOrder=desc&status=ready-for-handling';
const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};

try {
  const response = await fetch(url, options);
  const data = await response.json();
  console.log(data);
} catch (error) {
  console.error(error);
}
```

```go Ordenes_listarOrdenes_example
package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://inretailqa.mysellercenter.com/sellercenter/api/v1/orders?from=0&size=20&sortBy=creationDate&sortOrder=desc&status=ready-for-handling"

	req, _ := http.NewRequest("GET", url, nil)

	req.Header.Add("Authorization", "Bearer <token>")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(res)
	fmt.Println(string(body))

}
```

```ruby Ordenes_listarOrdenes_example
require 'uri'
require 'net/http'

url = URI("https://inretailqa.mysellercenter.com/sellercenter/api/v1/orders?from=0&size=20&sortBy=creationDate&sortOrder=desc&status=ready-for-handling")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Get.new(url)
request["Authorization"] = 'Bearer <token>'

response = http.request(request)
puts response.read_body
```

```java Ordenes_listarOrdenes_example
import com.mashape.unirest.http.HttpResponse;
import com.mashape.unirest.http.Unirest;

HttpResponse<String> response = Unirest.get("https://inretailqa.mysellercenter.com/sellercenter/api/v1/orders?from=0&size=20&sortBy=creationDate&sortOrder=desc&status=ready-for-handling")
  .header("Authorization", "Bearer <token>")
  .asString();
```

```php Ordenes_listarOrdenes_example
<?php
require_once('vendor/autoload.php');

$client = new \GuzzleHttp\Client();

$response = $client->request('GET', 'https://inretailqa.mysellercenter.com/sellercenter/api/v1/orders?from=0&size=20&sortBy=creationDate&sortOrder=desc&status=ready-for-handling', [
  'headers' => [
    'Authorization' => 'Bearer <token>',
  ],
]);

echo $response->getBody();
```

```csharp Ordenes_listarOrdenes_example
using RestSharp;

var client = new RestClient("https://inretailqa.mysellercenter.com/sellercenter/api/v1/orders?from=0&size=20&sortBy=creationDate&sortOrder=desc&status=ready-for-handling");
var request = new RestRequest(Method.GET);
request.AddHeader("Authorization", "Bearer <token>");
IRestResponse response = client.Execute(request);
```

```swift Ordenes_listarOrdenes_example
import Foundation

let headers = ["Authorization": "Bearer <token>"]

let request = NSMutableURLRequest(url: NSURL(string: "https://inretailqa.mysellercenter.com/sellercenter/api/v1/orders?from=0&size=20&sortBy=creationDate&sortOrder=desc&status=ready-for-handling")! as URL,
                                        cachePolicy: .useProtocolCachePolicy,
                                    timeoutInterval: 10.0)
request.httpMethod = "GET"
request.allHTTPHeaderFields = headers

let session = URLSession.shared
let dataTask = session.dataTask(with: request as URLRequest, completionHandler: { (data, response, error) -> Void in
  if (error != nil) {
    print(error as Any)
  } else {
    let httpResponse = response as? HTTPURLResponse
    print(httpResponse)
  }
})

dataTask.resume()
```