List all tax IDs 

Billing
Tax IDs
List all tax IDs

Returns a list of tax IDs.

Parameters

  • ownerobject

    The account or customer the tax ID belongs to. Defaults to owner[type]=self.

    • owner.typeenumRequired

      Type of owner referenced.

      Possible enum values
      account

      Indicates an account is being referenced.

      application

      Indicates an application is being referenced.

      customer

      Indicates a customer is being referenced.

      self

      Indicates that the account being referenced is the account making the API request.

    • owner.accountstring

      Account the tax ID belongs to. Required when type=account

    • owner.customerstring

      Customer the tax ID belongs to. Required when type=customer

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.

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

Returns

A dictionary with a data property that contains an array of up to limit tax IDs, starting after tax ID starting_after. Each entry in the array is a separate tax_id object. If no more tax IDs are available, the resulting array will be empty.

GET /v1/tax_ids
curl -G https://api.stripe.com/v1/tax_ids \
-u "sk_test_BQokikJ...2HlWgH4olfQ2sk_test_BQokikJOvBiI2HlWgH4olfQ2:" \
-d limit=3
Response
{
"object": "list",
"url": "/v1/tax_ids",
"has_more": false,
"data": [
{
"id": "txi_1NuMB12eZvKYlo2CMecoWkZd",
"object": "tax_id",
"country": "DE",
"created": 123456789,
"customer": null,
"livemode": false,
"type": "eu_vat",
"value": "DE123456789",
"verification": null,
"owner": {
"type": "self",
"customer": null
}
}
]
}