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

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
curl https://api.stripe.com/v1/terminal/hardware_skus/thsku_OEu70OWVaQ0DG3 \
  -u "sk_test_BQokikJ...2HlWgH4olfQ2sk_test_BQokikJOvBiI2HlWgH4olfQ2:" \
  -H "Stripe-Version: 2025-07-30.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
curl https://api.stripe.com/v1/terminal/hardware_skus \
  -u "sk_test_BQokikJ...2HlWgH4olfQ2sk_test_BQokikJOvBiI2HlWgH4olfQ2:" \
  -H "Stripe-Version: 2025-07-30.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

Configuration 

A Configurations object represents how features should be configured for terminal readers. For information about how to use it, see the Terminal configurations documentation.

Endpoints