Core Resources
Payment Methods
Products
Checkout
Payment Links
Billing
Capital
Connect
Reserves
Fraud
Issuing
Terminal
Treasury
Entitlements
Sigma
Reporting
Financial Connections
Tax
Identity
Crypto
Climate
Forwarding
Privacy
Webhooks

Terminal Hardware SKU Preview

A TerminalHardwareSKU represents a SKU for Terminal hardware. A SKU is a representation of a product available for purchase, containing information such as the name, price, and images.

Endpoints

The TerminalHardwareSKU object Preview

Attributes

More attributes

  • objectstring

  • countryenum

  • orderableinteger

  • productstringExpandable

  • providernullable enum

  • statusenum

  • unavailable_afternullable integer

The TerminalHardwareSKU object
{
  "id": "thsku_OEu70OWVaQ0DG3",
  "object": "terminal.hardware_sku",
  "amount": 450,
  "country": "US",
  "currency": "usd",
  "orderable": 100,
  "product": "thpr_NGubNsbUoS1oik",
  "status": "available",
  "unavailable_after": null
}

Retrieve an available Terminal Hardware SKU Preview

Retrieves an available TerminalHardwareSKU object.

Parameters

No parameters.

Returns

Returns an available TerminalHardwareSKU object if a valid identifier was provided.

GET /v1/terminal/hardware_skus/:id
curl https://api.stripe.com/v1/terminal/hardware_skus/thsku_OEu70OWVaQ0DG3 \
  -u "sk_test_BQokikJ...2HlWgH4olfQ2sk_test_BQokikJOvBiI2HlWgH4olfQ2:" \
  -H "Stripe-Version: 2025-08-27.basil; terminal_hardware_orders_beta=v5"
Response
{
  "id": "thsku_OEu70OWVaQ0DG3",
  "object": "terminal.hardware_sku",
  "amount": 450,
  "country": "US",
  "currency": "usd",
  "orderable": 100,
  "product": "thpr_NGubNsbUoS1oik",
  "status": "available",
  "unavailable_after": null
}

List all Terminal Hardware SKUs Preview

List all TerminalHardwareSKU objects.

Parameters

  • countrystringRequired

    The ISO 3166-1 alpha-2 country code representing the country associated with the SKUs to be retrieved. Available country codes can be listed with the List Country Specs endpoint.

More parameters

  • ending_beforestring

  • limitinteger

  • productstring

  • providerenum

  • starting_afterstring

  • statusenum

Returns

A dictionary with a data property that contains an array of terminal hardware SKUs. Each entry in the array is a separate SKU object.

GET /v1/terminal/hardware_skus
curl https://api.stripe.com/v1/terminal/hardware_skus \
  -u "sk_test_BQokikJ...2HlWgH4olfQ2sk_test_BQokikJOvBiI2HlWgH4olfQ2:" \
  -H "Stripe-Version: 2025-08-27.basil; terminal_hardware_orders_beta=v5"
Response
{
  "object": "list",
  "url": "/v1/terminal/hardware_skus",
  "has_more": false,
  "data": [
    {
      "id": "thsku_OEu70OWVaQ0DG3",
      "object": "terminal.hardware_sku",
      "amount": 450,
      "country": "US",
      "currency": "usd",
      "orderable": 100,
      "product": "thpr_NGubNsbUoS1oik",
      "status": "available",
      "unavailable_after": null
    }
  ]
}

Terminal Hardware Shipping Method Preview

A TerminalHardwareShipping represents a Shipping Method for Terminal hardware. A Shipping Method is a country-specific representation of a way to ship hardware, containing information such as the country, name, and expected delivery date.

Endpoints