1. Tax Entities
  2. List tax entities
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>'

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