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-06-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-06-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.

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.

Financial Accounts 

Stripe Treasury provides users with a container for money called a FinancialAccount that is separate from their Payments balance. FinancialAccounts serve as the source and destination of Treasury’s money movement APIs.