Country Data API

Returns a list of all published countries with basic info.

Query Parameters

Response

[
  {
    "code": "US",
    "name": "United States",
    "url": "https://joinneo.com/country/united-states/",
    "states": ["US-AL", "US-AK", "..."]  // only with include_states=1
  }
]

Example

curl https://joinneo.com/wp-json/neo/v1/countries
curl https://joinneo.com/wp-json/neo/v1/countries?include_states=1

Returns full employment data for a country — compliance policies, tax rates, income tax brackets, and public holidays.

Path Parameters

Query Parameters

Response

{
  "code": "US",
  "name": "United States",
  "url": "https://joinneo.com/country/united-states/",
  "state": null,
  "policies": {
    "min_salary": { "amount": "57672.00", "currency": "USD", "period": "year" },
    "hourly_rate": { "amount": "7.25", "currency": "USD" },
    "notice_period": { "min_days": 0, "max_days": null },
    "paid_time_off": { "accrual_days": 10, "accrual_rate": "year" },
    "sick_leave": { "accrual_days": 5, "accrual_rate": "year", "...": "..." },
    "probation": { "min_days": null, "max_days": 90 },
    "work_hours": { "hours": 40, "rate": "week" }
  },
  "taxes": {
    "employer": {
      "total_rate": 10.35,
      "components": [
        { "name": "Social Security", "key": "SOCIAL_SECURITY_TAX", "rate": 0.062 },
        { "name": "Medicare", "key": "MEDICARE_BASE_TAX", "rate": 0.0145 }
      ]
    },
    "employee": {
      "total_rate": 7.65,
      "components": [/* same shape */]
    },
    "income_tax_brackets": [
      {
        "key": "default",
        "label": "Standard",
        "tiers": [
          { "min": 0, "max": 11600, "rate": 0.1 },
          { "min": 11601, "max": 47150, "rate": 0.12 }
        ]
      }
    ]
  },
  "holidays": [
    { "name": "New Year's Day", "date": "2026-01-01" }
  ],
  "states": ["US-AL", "US-AK", "..."]
}

Example

# National data
curl https://joinneo.com/wp-json/neo/v1/countries/US

# State-specific data
curl https://joinneo.com/wp-json/neo/v1/countries/US?state=US-CA

Returns all states or regions for a country. Available for United States (51), Australia (8), United Kingdom (4), Canada (13), Switzerland (26), Spain (19), Mexico (32), United Arab Emirates (7).

Path Parameters

Response

[
  { "code": "US-AL", "name": "Alabama" },
  { "code": "US-AK", "name": "Alaska" },
  // ...
]

Example

curl https://joinneo.com/wp-json/neo/v1/countries/US/states
curl https://joinneo.com/wp-json/neo/v1/countries/CH/states

Returns full state-specific employment data. Same response shape as the country endpoint, with state and state_name populated.

Path Parameters

Query Parameters

Response

{
  "code": "US",
  "name": "United States",
  "url": "https://joinneo.com/country/united-states/",
  "state": "US-CA",
  "state_name": "California",
  "policies": { /* state-specific policies */ },
  "taxes": { /* state-specific tax rates */ },
  "holidays": [ /* national + state holidays */ ]
}

Example

curl https://joinneo.com/wp-json/neo/v1/countries/US/states/US-CA
curl https://joinneo.com/wp-json/neo/v1/countries/CH/states/CH-ZH
curl https://joinneo.com/wp-json/neo/v1/countries/MX/states/MX-JAL

Available Fields

Examples

# Get only minimum salary for Germany
curl https://joinneo.com/wp-json/neo/v1/countries/DE?fields=min_salary

# Get minimum salary for California
curl https://joinneo.com/wp-json/neo/v1/countries/US/states/US-CA?fields=min_salary

# Holidays and PTO together
curl https://joinneo.com/wp-json/neo/v1/countries/FR?fields=holidays,paid_time_off

# Only employer tax rates
curl https://joinneo.com/wp-json/neo/v1/countries/GB?fields=employer

# Mix sections and individual fields
curl https://joinneo.com/wp-json/neo/v1/countries/AU?fields=min_salary,employer,holidays

policies object

taxes object

holidays array

cURL

# List all countries
curl https://joinneo.com/wp-json/neo/v1/countries

# Full data for Germany
curl https://joinneo.com/wp-json/neo/v1/countries/DE

# Swiss cantons
curl https://joinneo.com/wp-json/neo/v1/countries/CH/states

# Zurich-specific data
curl https://joinneo.com/wp-json/neo/v1/countries/CH/states/CH-ZH

# Only minimum salary for California
curl https://joinneo.com/wp-json/neo/v1/countries/US/states/US-CA?fields=min_salary

JavaScript

// Get UK employment data
const response = await fetch('https://joinneo.com/wp-json/neo/v1/countries/GB');
const data = await response.json();

console.log(data.policies.paid_time_off);   // { accrual_days: 28, accrual_rate: "year" }
console.log(data.taxes.employer.total_rate); // 15.05
console.log(data.holidays.length);           // 8

Python

import requests

# Get minimum salary in Mexico (Jalisco)
r = requests.get('https://joinneo.com/wp-json/neo/v1/countries/MX/states/MX-JAL',
                 params={'fields': 'min_salary'})
data = r.json()
print(data['min_salary'])  # { amount: "...", currency: "MXN", period: "year" }

Machine-Readable Discovery

Use Cases for LLMs

• "What's the minimum salary in Germany?" → GET /countries/DE?fields=min_salary
• "How many PTO days do employees get in France?" → GET /countries/FR?fields=paid_time_off
• "What are the employer taxes in the UK?" → GET /countries/GB?fields=employer
• "List public holidays in Japan" → GET /countries/JP?fields=holidays
• "What's the notice period in California?" → GET /countries/US/states/US-CA?fields=notice_period

Also Available: EOR Quote API

Need to calculate total cost of employment? The EOR Quote API generates live quotes with employer taxes, statutory contributions, and management fees — returning shareable, branded quote URLs.