API Documentation

Access reliable business data and document generation through our REST API. Get tax rates, company information, compliance screening, loan payoff documents, and more with a single integration.

99.9%

API Uptime

<100ms

Avg Response

200+

Jurisdictions

Authentication

All API requests require authentication using an API key. Include your key in theAuthorization header.

curl -X GET "https://api.dynemo.io/v1/taxes/rates" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json"

Don't have an API key? Contact us to get started.

Base URL

All API requests should be made to:

https://api.dynemo.io

Tax & Fees

Access comprehensive tax rates, fees, and regulatory charges across jurisdictions.

GET/v1/taxes/ratesLive

Get Tax Rates

Retrieve current tax rates for a specific jurisdiction, product category, or transaction type.

Parameters

jurisdictionstringREQUIRED

ISO country/region code (e.g., US-CA, GB, DE)

categorystring

Product category (goods, services, digital)

datestring

Effective date (ISO 8601). Defaults to today.

Example Response

{
  "jurisdiction": "US-CA",
  "rates": [
    {
      "type": "state_sales_tax",
      "rate": 0.0725,
      "name": "California State Sales Tax",
      "effective_date": "2024-01-01"
    },
    {
      "type": "district_tax",
      "rate": 0.0125,
      "name": "Los Angeles District Tax",
      "effective_date": "2024-01-01"
    }
  ],
  "combined_rate": 0.085,
  "last_updated": "2024-12-15T00:00:00Z"
}

POST/v1/taxes/calculateLive

Calculate Tax

Calculate applicable taxes for a transaction based on origin, destination, and line items.

Parameters

from_addressobjectREQUIRED

Origin address object

to_addressobjectREQUIRED

Destination address object

line_itemsarrayREQUIRED

Array of line items with amount and category

Example Response

{
  "transaction_id": "txn_1a2b3c4d5e",
  "subtotal": 150.00,
  "tax_amount": 12.75,
  "total": 162.75,
  "breakdown": [
    {
      "jurisdiction": "US-CA",
      "tax_type": "state_sales_tax",
      "taxable_amount": 150.00,
      "rate": 0.0725,
      "amount": 10.88
    },
    {
      "jurisdiction": "US-CA-LA",
      "tax_type": "district_tax",
      "taxable_amount": 150.00,
      "rate": 0.0125,
      "amount": 1.87
    }
  ]
}

GET/v1/fees/regulatoryLive

Get Regulatory Fees

Retrieve regulatory fees, surcharges, and compliance charges for specific industries.

Parameters

industrystringREQUIRED

Industry code (telecom, energy, finance)

jurisdictionstringREQUIRED

ISO country/region code

Example Response

{
  "industry": "telecom",
  "jurisdiction": "US",
  "fees": [
    {
      "name": "Universal Service Fund",
      "code": "USF",
      "rate": 0.331,
      "basis": "interstate_revenue",
      "effective_date": "2024-Q4"
    },
    {
      "name": "E911 Fee",
      "code": "E911",
      "amount": 1.50,
      "basis": "per_line",
      "jurisdiction": "US-CA"
    }
  ]
}

Rate Limits

API requests are limited based on your plan. The default rate limit is 100 requests per minute. Rate limit headers are included in all responses:X-RateLimit-RemainingandX-RateLimit-Reset.