Skip to main content
Some registrations require additional information beyond the core registration fields — such as tax account details, officer information, or cross-border trade declarations. Use the form data endpoints to retrieve and submit this information.

​
Get form data

Retrieve the current form data for a registration, including officer details, cross-border trade fields, and any metadata collected during the registration process. 
GET /registrations/v2/{registration_id}/form-data

​
Path parameters

​
registration_id
string
required
The unique identifier (UUID) of the registration.

​
Query parameters

​
corporation_id
string
required
The corporation UUID.

​
Response fields

FieldTypeDescription
registration_idstringThe registration UUID
corporation_idstringThe corporation identifier
jurisdiction_idstring | nullJurisdiction identifier
jurisdiction_typestring | nullJurisdiction type (e.g., STATE_OR_PROVINCE, COUNTRY)
jurisdiction_namestring | nullHuman-readable jurisdiction name
sales_tax_registration_idstring | nullInternal registration reference
officerobject | nullResponsible officer details (see below)
metadataobject | nullAdditional collected data

​
Officer object

When present, the officer object contains details about the person responsible for the registration:
FieldTypeDescription
idnumberOfficer identifier
first_namestring | nullFirst name
middle_namestring | nullMiddle name
last_namestring | nullLast name
emailstring | nullEmail address
ssnstring | nullSocial security number (masked)
has_no_ssnboolean | nullWhether the officer has no SSN
job_titlestring | nullJob title or role
rolesstring[] | nullAssigned roles
employment_start_datestring | nullEmployment start date
date_of_birthstring | nullDate of birth
country_of_citizenshipstring | nullCountry of citizenship
home_addressobject | nullHome address with address_line_1, address_line_2, city, state, postal_code, country
government_idobject | nullGovernment ID document with id, file_name, file_url
curl --request GET \
  --url 'https://transaction-tax.api.in.commenda.io/api/v1/registrations/v2/7c9e6679-7425-40de-944b-e07fc1f90ae7/form-data?corporation_id=550e8400-e29b-41d4-a716-446655440000' \
  --header 'Authorization: Bearer <your_token>'

{
  "registration_id": "7c9e6679-7425-40de-944b-e07fc1f90ae7",
  "corporation_id": "550e8400-e29b-41d4-a716-446655440000",
  "jurisdiction_id": "JUR_EU_COUNTRY_DE",
  "jurisdiction_type": "COUNTRY",
  "jurisdiction_name": "Germany",
  "sales_tax_registration_id": "abc123",
  "officer": {
    "id": 42,
    "first_name": "Jane",
    "last_name": "Doe",
    "email": "jane@example.com",
    "job_title": "CFO",
    "roles": ["DIRECTOR"],
    "country_of_citizenship": "US",
    "home_address": {
      "address_line_1": "123 Main St",
      "city": "San Francisco",
      "state": "CA",
      "postal_code": "94105",
      "country": "US"
    }
  },
  "metadata": null
}

​
Update form data

Submit or update supplementary form data for a registration. Use this to provide tax account details, assign a responsible officer, or declare cross-border trade information. 
POST /registrations/v2/{registration_id}/form-data

​
Path parameters

​
registration_id
string
required
The unique identifier (UUID) of the registration.

​
Request body

​
corporation_id
string
required
The corporation UUID.
​
effective_start_date_of_tax_account
string
ISO date (YYYY-MM-DD) when the tax account was first established with the jurisdiction.
​
first_year_taxable_sale
number
The calendar year when the corporation first made a taxable sale in this jurisdiction.
​
officer_id
number
The ID of the officer responsible for this registration. Must be a valid officer associated with the corporation.
​
intra_community_trade
boolean
Whether the corporation conducts intra-community trade (relevant for EU VAT registrations).
​
imports_or_exports_goods
boolean
Whether the corporation imports or exports goods in this jurisdiction.
​
currency
string
The currency used for transactions in this jurisdiction (ISO 4217 code, e.g., EUR, USD).
curl --request POST \
  --url 'https://transaction-tax.api.in.commenda.io/api/v1/registrations/v2/7c9e6679-7425-40de-944b-e07fc1f90ae7/form-data' \
  --header 'Authorization: Bearer <your_token>' \
  --header 'Content-Type: application/json' \
  --data '{
    "corporation_id": "550e8400-e29b-41d4-a716-446655440000",
    "officer_id": 42,
    "intra_community_trade": true,
    "imports_or_exports_goods": false,
    "currency": "EUR"
  }'

{
  "message": "Form data updated successfully."
}

​
When to use form data

  • EU registrations — Provide cross-border trade declarations (intra_community_trade, imports_or_exports_goods) and the operating currency
  • Managed registrations — Assign a responsible officer and provide tax account history when Commenda is handling the registration on your behalf
  • Task completion — Some registration tasks require you to submit form data before the registration can proceed
All fields in the update request are optional. You can submit partial updates — only the provided fields are changed, and existing values for other fields are preserved.