curl --request POST \
--url 'https://transaction-tax.api.in.commenda.io/api/v1/corporations' \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '{
"legal_name": "Acme Corporation Inc.",
"jurisdiction": "US",
"email_alias": "acme"
}'
const response = await fetch('https://transaction-tax.api.in.commenda.io/api/v1/corporations', {
method: 'POST',
headers: {
'Authorization': 'Bearer <token>',
'Content-Type': 'application/json'
},
body: JSON.stringify({
legal_name: 'Acme Corporation Inc.',
jurisdiction: 'US',
email_alias: 'acme'
})
});
const data = await response.json();
import requests
response = requests.post(
'https://transaction-tax.api.in.commenda.io/api/v1/corporations',
headers={'Authorization': 'Bearer <token>'},
json={
'legal_name': 'Acme Corporation Inc.',
'jurisdiction': 'US',
'email_alias': 'acme'
}
)
data = response.json()
{
"message": "Corporation created successfully.",
"data": {
"id": "corp_123abc",
"legal_name": "Acme Corporation Inc.",
"created_at": 1704067200,
"jurisdiction": "US",
"email_alias": "acme@filings.commenda.io"
}
}
{
"error": {
"code": "VALIDATION_ERROR",
"message": "Invalid request body",
"details": [
{
"field": "legal_name",
"message": "Legal name is required"
}
]
}
}
{
"error": {
"code": "CORPORATION_ALREADY_EXISTS",
"message": "A corporation with this legal name already exists"
}
}
Corporations
Create corporation
Create a new corporation in your organization
POST
/
corporations
curl --request POST \
--url 'https://transaction-tax.api.in.commenda.io/api/v1/corporations' \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '{
"legal_name": "Acme Corporation Inc.",
"jurisdiction": "US",
"email_alias": "acme"
}'
const response = await fetch('https://transaction-tax.api.in.commenda.io/api/v1/corporations', {
method: 'POST',
headers: {
'Authorization': 'Bearer <token>',
'Content-Type': 'application/json'
},
body: JSON.stringify({
legal_name: 'Acme Corporation Inc.',
jurisdiction: 'US',
email_alias: 'acme'
})
});
const data = await response.json();
import requests
response = requests.post(
'https://transaction-tax.api.in.commenda.io/api/v1/corporations',
headers={'Authorization': 'Bearer <token>'},
json={
'legal_name': 'Acme Corporation Inc.',
'jurisdiction': 'US',
'email_alias': 'acme'
}
)
data = response.json()
{
"message": "Corporation created successfully.",
"data": {
"id": "corp_123abc",
"legal_name": "Acme Corporation Inc.",
"created_at": 1704067200,
"jurisdiction": "US",
"email_alias": "acme@filings.commenda.io"
}
}
{
"error": {
"code": "VALIDATION_ERROR",
"message": "Invalid request body",
"details": [
{
"field": "legal_name",
"message": "Legal name is required"
}
]
}
}
{
"error": {
"code": "CORPORATION_ALREADY_EXISTS",
"message": "A corporation with this legal name already exists"
}
}
Creates a new corporation entity in your organization. A corporation represents a distinct legal entity or business.
string
required
Legal name of the entity, including the type suffix (e.g., “Inc.”, “LLC”).
string
required
The ISO 3166 2-alpha country code where the business entity is registered.
curl --request POST \
--url 'https://transaction-tax.api.in.commenda.io/api/v1/corporations' \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '{
"legal_name": "Acme Corporation Inc.",
"jurisdiction": "US",
"email_alias": "acme"
}'
const response = await fetch('https://transaction-tax.api.in.commenda.io/api/v1/corporations', {
method: 'POST',
headers: {
'Authorization': 'Bearer <token>',
'Content-Type': 'application/json'
},
body: JSON.stringify({
legal_name: 'Acme Corporation Inc.',
jurisdiction: 'US',
email_alias: 'acme'
})
});
const data = await response.json();
import requests
response = requests.post(
'https://transaction-tax.api.in.commenda.io/api/v1/corporations',
headers={'Authorization': 'Bearer <token>'},
json={
'legal_name': 'Acme Corporation Inc.',
'jurisdiction': 'US',
'email_alias': 'acme'
}
)
data = response.json()
{
"message": "Corporation created successfully.",
"data": {
"id": "corp_123abc",
"legal_name": "Acme Corporation Inc.",
"created_at": 1704067200,
"jurisdiction": "US",
"email_alias": "acme@filings.commenda.io"
}
}
{
"error": {
"code": "VALIDATION_ERROR",
"message": "Invalid request body",
"details": [
{
"field": "legal_name",
"message": "Legal name is required"
}
]
}
}
{
"error": {
"code": "CORPORATION_ALREADY_EXISTS",
"message": "A corporation with this legal name already exists"
}
}
Authorizations
Bearer authentication header of the form Bearer <token>, where <token> is your auth token.
Body
application/json
Request body for creating a new corporation.
The legal name of the corporation.
Example:
"Acme Corporation"
Was this page helpful?