API Referencev1Checkout Drafts

List checkout drafts

List checkout drafts for the store, filtered by status (default: abandoned). Requires the store plan to include the Abandoned Checkouts feature. Each draft includes a ready-to-use recovery_url (the same link the checkout.abandoned webhook delivers) plus the raw recovery_token.

GET
/v1/checkout-drafts
X-API-Key<token>

Per-store API key created in the dashboard at Settings > Developer > API Keys.

In: header

Query Parameters

page?integer
Default1
Range1 <= value
per_page?integer
Default25
Range1 <= value <= 100
status?string
Default"abandoned"
Value in"active" | "abandoned" | "recovered" | "expired" | "all"

Response Body

application/json

application/json

curl -X GET "https://api.whatalo.com/v1/checkout-drafts"
{
  "data": [
    {
      "id": "472819365047",
      "status": "abandoned",
      "recovery_token": "7f8a9b2c-4d5e-6f7a-8b9c-0d1e2f3a4b5c",
      "recovery_url": "https://mistore.whatalo.com/r/7f8a9b2c-4d5e-6f7a-8b9c-0d1e2f3a4b5c",
      "customer": {
        "name": "Ana Perez",
        "email": "[email protected]",
        "phone": "8090000000"
      },
      "shipping_address": {
        "address": "Calle 1 #2",
        "city": "Santo Domingo",
        "province": "Distrito Nacional",
        "country_code": "DO",
        "postal_code": "10101"
      },
      "items": [
        {
          "product_id": "472819365047",
          "product_name": "Starter Kit",
          "variant_name": "Color: Rojo",
          "quantity": 2,
          "unit_price": 4498.5,
          "total_price": 8997
        }
      ],
      "subtotal": 8997,
      "discount": 0,
      "shipping": 0,
      "total": 8997,
      "currency": "DOP",
      "created_at": "2026-03-01T15:00:00.000Z",
      "updated_at": "2026-03-01T15:05:00.000Z",
      "abandoned_at": "2026-03-01T15:30:00.000Z",
      "recovered_at": "string"
    }
  ],
  "pagination": {
    "page": 1,
    "per_page": 25,
    "total": 100,
    "total_pages": 4
  }
}
{
  "error": {
    "code": "FEATURE_ACCESS_DENIED",
    "message": "\"Control de Inventario\" requiere un plan premium. Actualiza tu plan para acceder a esta función.",
    "details": {
      "feature": "inventory"
    }
  }
}