List registrations

Retrieve sales tax registrations

curl --request GET \
  --url https://base_url/api/v1/registrations \
  --header 'Authorization: Bearer <token>'

{
  "data": {
    "registrations": [
      {
        "registration_id": "ec6d3db8-fd31-4303-8687-3ff98fb10ebf",
        "corporation_id": "2535af08-a139-4d0c-9827-1651e46dfbcf",
        "country": "US",
        "country_specific_details": {
          "legal_name": "Example Inc.",
          "state": "CA",
          "state_specific_details": {
            "payment_interval": "<string>",
            "sales_tax_id": "<string>",
            "username": "<string>",
            "password": "<string>",
            "pin": "<string>",
            "web_file_number": "<string>",
            "tax_types": [
              "RSST"
            ]
          }
        },
        "registered_at": "2023-12-25",
        "validation_status": "PENDING",
        "registration_status": "REGISTRATION_IN_PROGRESS",
        "business_activity_status": "VALID",
        "registration_type": "SALES_TAX_REGISTRATION",
        "jurisdiction": "CA",
        "filing_status": "FILING"
      }
    ]
  },
  "message": "Successfully fetched registrations."
}

GET

registrations

Retrieve sales tax registrations

curl --request GET \
  --url https://base_url/api/v1/registrations \
  --header 'Authorization: Bearer <token>'

{
  "data": {
    "registrations": [
      {
        "registration_id": "ec6d3db8-fd31-4303-8687-3ff98fb10ebf",
        "corporation_id": "2535af08-a139-4d0c-9827-1651e46dfbcf",
        "country": "US",
        "country_specific_details": {
          "legal_name": "Example Inc.",
          "state": "CA",
          "state_specific_details": {
            "payment_interval": "<string>",
            "sales_tax_id": "<string>",
            "username": "<string>",
            "password": "<string>",
            "pin": "<string>",
            "web_file_number": "<string>",
            "tax_types": [
              "RSST"
            ]
          }
        },
        "registered_at": "2023-12-25",
        "validation_status": "PENDING",
        "registration_status": "REGISTRATION_IN_PROGRESS",
        "business_activity_status": "VALID",
        "registration_type": "SALES_TAX_REGISTRATION",
        "jurisdiction": "CA",
        "filing_status": "FILING"
      }
    ]
  },
  "message": "Successfully fetched registrations."
}

Authorizations

Authorization

string

header

required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Query Parameters

corporation_id

string

required

The unique identifier of the corporation for which to retrieve data.

Response

Sales tax registration response

data

object

Show child attributes

data.registrations

object[]

required

Show child attributes

data.registrations.registration_id

string

required

The unique identifier for the registration.

Example:

"ec6d3db8-fd31-4303-8687-3ff98fb10ebf"

data.registrations.corporation_id

string

required

The unique identifier for a corporation.

Example:

"2535af08-a139-4d0c-9827-1651e46dfbcf"

data.registrations.country

string

required

ISO 3166 2-letter country code. Ex: US, IN, GB.

Example:

"US"

data.registrations.country_specific_details

object

required

Show child attributes

data.registrations.country_specific_details.legal_name

string

required

The legal name of the entity being registered.

Example:

"Example Inc."

data.registrations.country_specific_details.state

string

required

2-letter code for each state. Suffix of the ISO 3166-2 code. Ex: CA, NY, TX.

Example:

"CA"

data.registrations.country_specific_details.state_specific_details

object

Show child attributes

data.registrations.country_specific_details.state_specific_details.payment_interval

string

Payment interval for sales tax.

data.registrations.country_specific_details.state_specific_details.sales_tax_id

string

Sales tax ID.

data.registrations.country_specific_details.state_specific_details.username

string

Username for tax filing.

data.registrations.country_specific_details.state_specific_details.password

string

Password for tax filing.

data.registrations.country_specific_details.state_specific_details.pin

string

PIN for tax filing.

data.registrations.country_specific_details.state_specific_details.web_file_number

string

Web file number for tax filing.

data.registrations.country_specific_details.state_specific_details.tax_types

enum<string>[]

Enum representing different types of taxes applicable in various jurisdictions.

Available options:

RSST,

RST,

RUT,

SSUT,

GRT,

VUT,

RTPT,

TPT,

DTT,

RDF,

SUT,

GET,

ROT,

CUT,

RSSUT,

BAO

data.registrations.registered_at

string<date>

required

ISO 8601 date only string, identifying the date when the state registration occurred.

data.registrations.validation_status

enum<string>

required

Reflects whether Commenda has validated the seller's registration details.

Available options:

PENDING,

VALIDATION_IN_PROGRESS,

INVALID,

VALID

data.registrations.registration_status

enum<string>

required

Reflects the current stage of the registration process.

Available options:

REGISTRATION_IN_PROGRESS,

REGISTERED

data.registrations.business_activity_status

enum<string>

required

Reflects whether the registration is active and the business is operating in a given State.

Available options:

VALID,

INVALID,

PENDING,

VALIDATION_IN_PROGRESS

data.registrations.registration_type

enum<string>

required

Type of registration. Request additional types from the Commenda team as required.

Available options:

SALES_TAX_REGISTRATION

data.registrations.jurisdiction

string

required

The two letter identifier of the jurisdiction this registration applies to.

Example:

"CA"

data.registrations.filing_status

enum<string>

Indicates whether Commenda is automatically filing taxes for this tax registration.

Available options:

FILING,

NOT_FILING

message

string

Example:

"Successfully fetched registrations."

Create registration Get registration

⌘I

Sales Tax API

Core Concepts

Corporations

Calculate

Transactions

Nexus

Registrations

Filings

Products

Customers

Exemption Certificates

Files

Webhooks

Authorizations

Query Parameters

Response