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 valuesaccount
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_
is an object ID that defines your place in the list. For instance, if you make a list request and receive 100 objects, starting withbefore obj_
, your subsequent call can includebar ending_
in order to fetch the previous page of the list.before=obj_ bar - 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_
is an object ID that defines your place in the list. For instance, if you make a list request and receive 100 objects, ending withafter obj_
, your subsequent call can includefoo starting_
in order to fetch the next page of the list.after=obj_ foo
Returns
A dictionary with a data
property that contains an array of up to limit
tax IDs, starting after tax ID starting_
. Each entry in the array is a separate tax_
object. If no more tax IDs are available, the resulting array will be empty.
{ "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 } } ]}