Pedidos
Listar pedidos
Pedidos de tu tienda, de más nuevo a más antiguo. Con updated_since, solo los que han cambiado después de esa fecha y de más antiguo a más nuevo: es lo que hay que usar para sincronizar.
GET/orders
Permiso necesario: orders:read
Parámetros
statusopcional | texto | Solo los pedidos de ese estado.Valores: pending, in_progress, shipped, delivered, completed, cancelled. |
updated_sinceopcional | fecha | Solo los pedidos que han cambiado después de esta fecha (ISO 8601). No se puede combinar con status. |
limitopcional | entero | Cuántos elementos devolver, de 1 a 100. Por defecto, 50. |
starting_afteropcional | texto | Para pedir la página siguiente: el valor de next_starting_after de la respuesta anterior. |
Petición
curl "https://europe-west1-primters-web.cloudfunctions.net/api/v1/orders?status=pending&limit=20" \
-H "Authorization: Bearer $PRIMTERS_API_KEY"Respuesta
{
"object": "list",
"data": [
{
"id": "Xk2pQ9aLm3",
"object": "order",
"status": "pending",
"created_at": "2026-12-03T19:12:40.000Z",
"updated_at": "2026-12-03T19:12:40.000Z",
"confirm_before": "2026-12-05T19:12:40.000Z",
"confirmed_at": null,
"shipped_at": null,
"delivered_at": null,
"completed_at": null,
"cancelled_at": null,
"customer": {
"name": "Laura Gómez",
"phone": "+34600000000"
},
"delivery": {
"method": "shipping",
"address": {
"name": "Laura Gómez",
"street": "Calle Mayor 1, 2.º B",
"additional_info": null,
"postal_code": "28013",
"city": "Madrid",
"province": "Madrid",
"country": "ES"
},
"pickup_location": null,
"estimated_date": null
},
"note": "Si puede ser, envolver para regalo",
"items": [
{
"product_id": "p8LmR2wq",
"title": "Taza de cerámica personalizada",
"reference": "TAZA-350",
"quantity": 2,
"quantity_mode": "units",
"lot_size": null,
"unit_price": 9.9,
"total": 19.8,
"customization": [
"Color: blanco",
"Texto: Feliz cumpleaños"
],
"addons": [],
"image_url": "https://firebasestorage.googleapis.com/…/taza.jpg",
"design_preview_url": "https://firebasestorage.googleapis.com/…/diseno.png"
}
],
"amounts": {
"currency": "EUR",
"subtotal": 19.8,
"discount": 0,
"primts": 0,
"shipping": 4.5,
"tax_rate": 0.21,
"tax": 5.1,
"total": 29.4,
"gift_card": 0,
"commission": 2.94,
"payout": 26.46,
"refunded": 0
},
"coupon": null,
"tracking": null,
"cancellation": null,
"dispute": null,
"panel_url": "https://primters.com/es/dashboard/maker/orders"
}
],
"has_more": true,
"next_starting_after": "Xk2pQ9aLm3"
}Errores
| 400 | invalid_parameter | Un dato no tiene el formato o el valor admitido. |
¿Dudas o necesitas algo que no está? Escríbenos a contacto@primters.com indicando, si es un error, la petición que haces y la respuesta que recibes (sin la clave).
