# The Order object

| Field | Type | Required | Description |
| --- | --- | --- | --- |
| `id` | string | yes |  |
| `order_number` | string | no |  |
| `status` | string | yes | One of: `unpaid`, `pending`, `paid`, `completed`, `charged_back`, `cancelled`. |
| `first_name` | string | no |  |
| `last_name` | string | no |  |
| `email` | string | no |  |
| `organization_name` | string | no |  |
| `phone` | string | no |  |
| `address` | string | no |  |
| `postal_code` | string | no |  |
| `city` | string | no |  |
| `country` | string | no | ISO 3166-1 alpha-2 country code |
| `vat_number` | string | no |  |
| `carrier` | string | no |  |
| `tracktrace` | string | no |  |
| `wc_order_id` | integer | no |  |
| `wc_order_number` | string | no |  |
| `subscription` | string | no |  |
| `subscription_status` | string | no | One of: `active`, `cancelled`, `completed`. |
| `cancel_subscription_at` | string | no |  |
| `total_amount` | string | yes |  |
| `currency` | string | yes | One of: `AED`, `AUD`, `BGN`, `BRL`, `CAD`, `CHF`, `CZK`, `DKK`, `EUR`, `GBP`, `HKD`, `HUF`, `ILS`, `ISK`, `JPY`, `MXN`, `MYR`, `NOK`, `NZD`, `PHP`, `PLN`, `RON`, `SEK`, `SGD`, `THB`, `TWD`, `USD`, `ZAR`. |
| `created_at` | string | yes |  |
| `products` | array of OrderProducts | no |  |
| `products[].next_order` | string | no |  |
| `products[].quantity` | integer | yes |  |
| `products[].product` | object | yes |  |
| `products[].product.id` | string | no |  |
| `products[].product.name` | string | no |  |
| `products[].product.type` | string | no | One of: `once`, `subscription`, `shipping_costs`. |
| `products[].product.amount` | string | no |  |
| `products[].product.currency` | string | no | One of: `AED`, `AUD`, `BGN`, `BRL`, `CAD`, `CHF`, `CZK`, `DKK`, `EUR`, `GBP`, `HKD`, `HUF`, `ILS`, `ISK`, `JPY`, `MXN`, `MYR`, `NOK`, `NZD`, `PHP`, `PLN`, `RON`, `SEK`, `SGD`, `THB`, `TWD`, `USD`, `ZAR`. |
| `products[].product.interval` | string | no | One of: `day`, `week`, `month`, `year`. |
| `products[].product.times` | integer | no |  |
| `products[].product.wc_product_id` | integer | no |  |

```json
{
    "id": "ord_abc123",
    "order_number": "ORD-2025-001",
    "status": "paid",
    "first_name": "John",
    "last_name": "Doe",
    "email": "john@example.com",
    "organization_name": "Acme B.V.",
    "phone": "+31612345678",
    "address": "Keizersgracht 1",
    "postal_code": "1015AA",
    "city": "Amsterdam",
    "country": "NL",
    "vat_number": "NL123456789B01",
    "carrier": "PostNL",
    "tracktrace": "3STEST1234567",
    "wc_order_id": 5678,
    "wc_order_number": "WC-5678",
    "subscription": "sub_abc123",
    "subscription_status": "active",
    "cancel_subscription_at": "2025-12-31",
    "total_amount": "59.98",
    "currency": "EUR",
    "created_at": "2025-01-15 10:30:00",
    "products": [
        {
            "next_order": "2025-02-01",
            "quantity": 2,
            "product": {
                "id": "prod_abc123",
                "name": "Premium Plan",
                "type": "subscription",
                "amount": "29.99",
                "currency": "EUR",
                "interval": "month",
                "times": 12,
                "wc_product_id": 1234
            }
        }
    ]
}
```
