Skip to content

Tiendup Public API (1.0.0)

API pública para integrar Tiendup 🔑 Para obtener una API Key, sigue los pasos de la documentación:
¿Cómo obtener tu API Key de Tiendup?

Download OpenAPI description
Overview
Languages
Servers
https://{business_slug}.public-api.tiendup.com
Operations

Request

Retorna el listado de compras realizadas en el negocio. Por defecto se retornan ordenadas por fecha de creación de forma descendente. Si no hay compras, data viene como [].

Security
ApiKeyAuth
Query
pageinteger>= 1

Número de página (empieza en 1).

Default 1
limitinteger>= 1

Cantidad de resultados por página (default 25).

Default 25
curl -i -X GET \
  'https://demo.public-api.tiendup.com/orders?page=1&limit=25' \
  -H 'X-API-Key: YOUR_API_KEY_HERE'

Responses

OK

Bodyapplication/json
statusstringrequired
Example: "OK"
dataArray of objects(Order)required

Lista de compras (si no hay compras, viene vacío).

data[].​idintegerrequired
Example: 18508
data[].​hashstringrequired
Example: "ZKp7q4VgRP"
data[].​numberstringrequired
Example: "16"
data[].​typestringrequired

Tipo de compra (common, downloadable, elearning, event, bundle, session, etc.)

Example: "common"
data[].​statusstringrequired
Example: "open"
data[].​language_isostring
Example: "es"
data[].​creation_datestringrequired

Formato: YYYY-MM-DD HH:mm:ss

Example: "2026-01-19 21:01:26"
data[].​update_datestring

Formato: YYYY-MM-DD HH:mm:ss

Example: "2026-01-19 21:01:28"
data[].​currencystring
Example: "ARS"
data[].​currency_symbolstring
Example: "$"
data[].​total_amountstring
Example: "2650"
data[].​pay_urlstring
Example: "https://pay.example.com/pay/265/ZKp7q4VgRP"
data[].​itemsArray of objects(OrderItem)required
data[].​items[].​idintegerrequired
Example: 24148
data[].​items[].​product_idintegerrequired
Example: 12181
data[].​items[].​ecommerce_typestringrequired
Example: "retail"
data[].​items[].​namestringrequired
Example: "Producto de ejemplo"
data[].​items[].​skustring
Example: "abc123"
data[].​items[].​quantityintegerrequired
Example: 1
data[].​items[].​pricestringrequired
Example: "2500"
data[].​items[].​unit_pricestring
Example: "2500"
data[].​items[].​property name*anyadditional property
data[].​customerobject(CustomerSummaryOrder)required

Cliente (schema parcial).

data[].​customer.​idintegerrequired
Example: 40737
data[].​customer.​namestringrequired
Example: "Michael"
data[].​customer.​last_namestring
Example: "Smith"
One of:
string
data[].​customer.​emailstring(email)required
Example: "customer3@example.com"
data[].​customer.​creation_datestringrequired

Formato: YYYY-MM-DD HH:mm:ss

Example: "2020-04-03 11:10:54"
data[].​customer.​update_datestringrequired

Formato: YYYY-MM-DD HH:mm:ss

Example: "2025-12-26 12:25:57"
data[].​customer.​commentstring
Example: ""
data[].​customer.​activebooleanrequired
Example: true
data[].​customer.​is_guestbooleanrequired
Example: false
data[].​customer.​birthdatestring
One of:
string
data[].​customer.​has_passwordbooleanrequired
Example: true
data[].​customer.​stagestringrequired
Example: "evangelist"
data[].​customer.​avatar_filenamestring or null
Example: "https://api.example.com/api/portraits/lego/5.jpg"
One of:
string
data[].​customer.​member_idinteger
Example: 5783
One of:
integer
data[].​customer.​main_phonestring
Example: "+1 202 555 1002"
One of:
string
data[].​customer.​categoriesArray of any
Example: []
data[].​customer.​metafieldsArray of arrays or object
Example: []
One of:
arrays
data[].​customer.​property name*anyadditional property
data[].​property name*anyadditional property
countFilteredintegerrequired

Cantidad filtrada

countinteger or stringrequired

Puede venir como string o integer.

One of:

Puede venir como string o integer.

integer
previousinteger or nullrequired
One of:
integer
currentintegerrequired
pagesintegerrequired
nextinteger or nullrequired
One of:
integer
property name*anyadditional property
Response
application/json
{ "status": "OK", "data": [ { … } ], "countFiltered": 0, "count": 0, "previous": 0, "current": 0, "pages": 0, "next": 0 }

Request

Security
ApiKeyAuth
Path
order_idintegerrequired

ID de la compra (order)

curl -i -X GET \
  'https://demo.public-api.tiendup.com/orders/{order_id}' \
  -H 'X-API-Key: YOUR_API_KEY_HERE'

Responses

OK

Bodyapplication/json
statusstringrequired
Example: "OK"
dataobject(OrderDetail)required

Detalle de una compra/orden. Schema parcial: Tiendup puede incluir campos adicionales.

data.​idintegerrequired
Example: 18508
data.​hashstringrequired
Example: "ZKp7q4VgRP"
data.​numberstringrequired
Example: "16"
data.​typestringrequired
Example: "common"
data.​statusstringrequired
Example: "open"
data.​creation_datestringrequired

Formato: YYYY-MM-DD HH:mm:ss

Example: "2026-01-19 21:01:26"
data.​update_datestring

Formato: YYYY-MM-DD HH:mm:ss

Example: "2026-01-19 21:01:28"
data.​currencystring
Example: "ARS"
data.​currency_symbolstring
Example: "$"
data.​total_amountstring
Example: "2650"
data.​pay_urlstring or null
Example: "https://pay.example.com/pay/265/ZKp7q4VgRP"
One of:
string
data.​sourceobject(OrderSourceSummary)
data.​itemsArray of objects(OrderItemDetail)required

En el detalle, items puede venir enriquecido (con datos del producto).

data.​items[].​idintegerrequired
data.​items[].​product_idinteger
data.​items[].​namestringrequired
data.​items[].​ecommerce_typestringrequired
data.​items[].​quantityintegerrequired
data.​items[].​pricestringrequired
data.​items[].​unit_pricestring
data.​items[].​skustring or null
One of:
string
data.​items[].​imageobject or boolean or null
One of:
object
data.​items[].​property name*anyadditional property
data.​customerobject(CustomerDetail)required
data.​customer.​idintegerrequired
data.​customer.​emailstring(email)required
data.​customer.​namestring
data.​customer.​last_namestring
data.​customer.​phonestring or null
One of:
string
data.​customer.​creation_datestring or null
One of:
string
data.​customer.​update_datestring or null
One of:
string
data.​customer.​billing_addressobject or null
One of:
object
data.​customer.​property name*anyadditional property
data.​gatewayobject(GatewayDetail)
data.​shippingobject(ShippingDetail)
data.​property name*anyadditional property
property name*anyadditional property
Response
application/json
{ "status": "OK", "data": { "id": 18508, "hash": "ZKp7q4VgRP", "number": "16", "type": "common", "status": "open", "creation_date": "2026-01-19 21:01:26", "update_date": "2026-01-19 21:01:28", "currency": "ARS", "currency_symbol": "$", "total_amount": "2650", "pay_url": "https://pay.example.com/pay/265/ZKp7q4VgRP", "source": { … }, "items": [ … ], "customer": { … }, "gateway": { … }, "shipping": { … } } }
Operations
Operations
Operations
Operations
Operations
Operations