Skip to main content
POST
/
2025-09
/
orders
curl --request POST \
  --url https://public-api.stora.co/2025-09/orders \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "site": {
    "id": "site_14b419f1096013f1"
  },
  "billing_period": "monthly",
  "payment_method": "card",
  "purchase_order_number": "PO123456",
  "starts_at": "2025-03-04T14:41:00Z",
  "emails": {
    "booking_confirmation": false,
    "move_in_day": false
  },
  "coupon": {
    "id": "cpn_a26d0d4c582740c1"
  },
  "contract_template": {
    "id": "ctpl_33ae8d0b2b371ba2"
  },
  "contact": {
    "full_name": "John Doe",
    "email": "john@doe.com",
    "tax_id": "123456789",
    "phone_number": "+447525920754",
    "address": {
      "line_1": "123 Main St",
      "line_2": "Apt 4B",
      "city": "Anytown",
      "postal_code": "12345",
      "state": "CA",
      "country_alpha2": "US"
    },
    "type": "company",
    "marketing_source": "recommendation",
    "source": "walkin",
    "use_case": "more_space"
  },
  "finalize": {
    "cancel_redirect_url": "https://your-portal.com/orders/canceled"
  },
  "metadata": {
    "source": "zapier",
    "external_id": "abc_123"
  },
  "line_items": [
    {
      "type": "unit_type",
      "quantity": 1,
      "price": {
        "amount": 1999
      },
      "item": {
        "id": "utype_3b3aed5cca33b11d"
      }
    },
    {
      "type": "protection",
      "quantity": 1,
      "price": {
        "amount": 2999
      },
      "item": {
        "id": "plvl_851681552a608245"
      }
    },
    {
      "type": "product",
      "quantity": 1,
      "price": {
        "amount": 1999
      },
      "item": {
        "id": "prod_c4267b529ee675bd"
      }
    },
    {
      "type": "product",
      "quantity": 2,
      "price": {
        "amount": 999
      },
      "item": {
        "id": "prod_0bc539e1087f3070"
      }
    },
    {
      "type": "security_deposit",
      "quantity": 1,
      "price": {
        "amount": 10000
      },
      "item": {
        "id": "utype_3b3aed5cca33b11d"
      }
    }
  ]
}
'
{
  "order": {
    "id": "order_9ef07151f2470754",
    "billing_period": "monthly",
    "contact": {
      "id": "con_0ac0514ed0711462"
    },
    "contract_template": {
      "id": "ctpl_33ae8d0b2b371ba2"
    },
    "coupon": {
      "id": "cpn_a26d0d4c582740c1"
    },
    "created_at": "2025-02-22T14:41:00Z",
    "email_notifications": {
      "booking_confirmation": false,
      "move_in_day": false
    },
    "line_items": [
      {
        "id": "olitm_216f3087ddaf7756"
      },
      {
        "id": "olitm_164fba4304f78ca3"
      },
      {
        "id": "olitm_1d4561fd880ff259"
      },
      {
        "id": "olitm_63ec122061433484"
      },
      {
        "id": "olitm_9470fad13481e779"
      }
    ],
    "metadata": {
      "source": "zapier",
      "external_id": "abc_123"
    },
    "one_time_total": {
      "amount": 11998,
      "currency": "GBP",
      "formatted": "£119.98"
    },
    "one_time_total_excluding_tax": {
      "amount": 11998,
      "currency": "GBP",
      "formatted": "£119.98"
    },
    "payment_method": "card",
    "payment_url": "https://example.com/pay",
    "purchase_order_number": "PO123456",
    "site": {
      "id": "site_14b419f1096013f1"
    },
    "source": "public_api",
    "starts_at": "2025-03-04T14:41:00Z",
    "status": "finalized",
    "subscription": null,
    "subtotal": {
      "amount": 6997,
      "currency": "GBP",
      "formatted": "£69.97"
    },
    "tax": {
      "amount": 584,
      "currency": "GBP",
      "formatted": "£5.84"
    },
    "tenancy": null,
    "total": {
      "amount": 3498,
      "currency": "GBP",
      "formatted": "£34.98"
    },
    "total_discount": {
      "amount": 3499,
      "currency": "GBP",
      "formatted": "£34.99"
    },
    "total_excluding_tax": {
      "amount": 2914,
      "currency": "GBP",
      "formatted": "£29.14"
    },
    "updated_at": "2025-02-22T14:41:00Z"
  },
  "meta": {
    "request_id": "01563646-58c1-4607-8fe0-cae3e92c4477",
    "curies": [
      {
        "name": "bo",
        "href": "https://app.stora.test{rel}",
        "templated": true,
        "title": "Backoffice"
      },
      {
        "name": "sf",
        "href": "https://acme.stora.test{rel}",
        "templated": true,
        "title": "Storefront"
      }
    ]
  }
}

Authorizations

Authorization
string
header
required

Bearer Token necessary to use API

Query Parameters

expand
string[]

This endpoint supports expandable responses. For more, see the documentation page.

Body

application/json

Create an order

site
object
required
billing_period
enum<string>
Available options:
monthly,
weekly,
every_four_weeks,
every_three_months,
every_six_months,
yearly
payment_method
enum<string>
Available options:
card,
bacs_debit,
sepa_debit
purchase_order_number
string

The purchase order number associated with the order.

starts_at
string

The start date (date-time format) or now to indicate the order should start immediately after finalization.

emails
object

Configure email notifications for the order

contact
object
coupon
object
contract_template
object
line_items
object[]
finalize
object

When this object is present, the order will be finalized, and the Payment URL will be returned. The order won't be stored if the finalization fails (for example, due to validation).

metadata
object

Set of key-value pairs for storing additional information on the order. Learn more about metadata.

Response

order successfully created

Single Order

order
object

Order

meta
object