- Tax Entities
- List tax entities
Tax Entities
List tax entities
List the tax entities of a taxpayer, optionally filtered by external id or encrypted TIN.
GET
/v1/taxpayers/{taxpayerId}/tax-entities
curl --request GET \
--url https://public-api.sandbox.remitian.com/v1/taxpayers/{taxpayerId}/tax-entities \
--header 'Authorization: Bearer <token>' \
--header 'x-api-key: <x_api_key>'
curl --request GET \
--url https://public-api.sandbox.remitian.com/v1/taxpayers/{taxpayerId}/tax-entities \
--header 'Authorization: Bearer <token>' \
--header 'x-api-key: <x_api_key>'Authorizations
bearerAuth
required
string
Access token from POST /v1/auth/token, sent as `Authorization: Bearer {accessToken}`.
Query Parameters
taxpayerId
required
string
Unique identifier of the taxpayer.
externalId
string
Filter by your system's identifier.
pageNumber
integer
Page to retrieve, starting at 1.
pageSize
integer
Items per page.
encryptedTin
string
Filter by exact TIN, encrypted with the Remitian TIN encryption public key (RSA-OAEP SHA-256, base64url without padding).
x-api-key
required
string
API key of your Client Application.
Response
application/json
200
400
401
403
404
OK
items
required
array
Array of tax entity objects.
totalCount
required
integer
Total number of items across all pages.
totalPages
required
integer
Total number of pages.
currentPage
integer
Current page number.
pageSize
integer
Number of items per page.
curl --request GET \
--url https://public-api.sandbox.remitian.com/v1/taxpayers/{taxpayerId}/tax-entities \
--header 'Authorization: Bearer <token>' \
--header 'x-api-key: <x_api_key>'
curl --request GET \
--url https://public-api.sandbox.remitian.com/v1/taxpayers/{taxpayerId}/tax-entities \
--header 'Authorization: Bearer <token>' \
--header 'x-api-key: <x_api_key>'