List all Terminal Hardware SKUs Preview

Terminal
Terminal Hardware SKU
List all Terminal Hardware SKUs

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

    A cursor for use in pagination. ending_before is an object ID that defines your place in the list. For instance, if you make a list request and receive 100 objects, starting with obj_bar, your subsequent call can include ending_before=obj_bar in order to fetch the previous page of the list.

  • limitinteger

    A limit on the number of objects to be returned. Limit can range between 1 and 100, and the default is 10.

  • productstring

    Only return SKUs for the product specified by this product ID.

  • providerenum

    The provider associated with this SKU.

    Possible enum values
    stripe

    The Stripe provider

  • starting_afterstring

    A cursor for use in pagination. starting_after is an object ID that defines your place in the list. For instance, if you make a list request and receive 100 objects, ending with obj_foo, your subsequent call can include starting_after=obj_foo in order to fetch the next page of the list.

  • statusenum

    Only return SKUs that have the given status. Defaults to available.

    Possible enum values
    available

    Available for new orders.

    unavailable

    Can no longer be used for order creation.

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
}
]
}