1. Tax Entities
  2. Create a tax entity
POST
/v1/taxpayers/{taxpayerId}/tax-entities
curl --request POST \
     --url https://public-api.sandbox.remitian.com/v1/taxpayers/{taxpayerId}/tax-entities \
     --header 'Authorization: Bearer <token>' \
     --header 'x-api-key: <x_api_key>' \
     --header 'Content-Type: application/json' \
     --data '{
  "type": "IrsSsn",
  "tin": "string",
  "externalId": "string",
  "firstName": "string",
  "lastName": "string",
  "businessName": "string",
  "address": {
    "address1": "string",
    "address2": "string",
    "apartmentOrSuite": "string",
    "poBox": "string",
    "city": "string",
    "region": "string",
    "country": "string",
    "postalCode": "string"
  },
  "email": "string",
  "phone": "string",
  "filingStatus": "Single",
  "regionalTaxRegistrations": [
    {}
  ]
}'

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

x-api-key
required
string

API key of your Client Application.

​
Body

application/json
type
required
string

The type of tax entity. IrsSsn for individuals, IrsEin for businesses.

tin
required
string

The Tax Identification Number (SSN or EIN).

externalId
string

Optional external identifier provided by the client.

firstName
string

The first name of the individual (required for IrsSsn).

lastName
string

The last name of the individual (required for IrsSsn).

businessName
string

The business name (required for IrsEin).

address
object

The address information (optional, for all types).

email
string

Email address. Optional. Only applicable to individual entities (IrsSsn); ignored for IrsEin.

phone
string

Phone number (optional, for all types).

filingStatus
string

Filing status (optional, for IrsSsn only).

regionalTaxRegistrations
array

Regional tax registrations (optional, for IrsEin only).

​
Response

application/json
  • 201

  • 400

  • 401

  • 403

  • 404

  • 409

Created

id
string

The unique identifier of the resource.

externalId
string

The external identifier provided by the client.