Get jurisdiction details

Returns full configuration for a jurisdiction: required employee fields, filing types, statutory benefits, compliance rules, and termination rules.

GET /v1/statutory/jurisdictions/{country_code}

Get jurisdiction details

cURL

curl --request GET \
  --url https://api.cadanapay.com/v1/statutory/jurisdictions/{country_code} \
  --header 'Authorization: Bearer <token>'

200

{
  "countryCode": "MX",
  "countryName": "Mexico",
  "currency": "MXN",
  "status": "live",
  "payrollFrequency": "MONTHLY",
  "employeeFields": {
    "countryCode": "MX",
    "version": 3,
    "fields": [
      {
        "key": "taxId",
        "name": "RFC (Registro Federal de Contribuyentes)",
        "description": "SAT-issued RFC, required on all ISR withholding returns",
        "type": "string",
        "required": true,
        "entity": "person",
        "scope": [
          "calculation",
          "filing"
        ],
        "enum": [
          "<string>"
        ],
        "pattern": "^[A-Z&Ñ]{4}\\d{6}[A-Z0-9]{3}$",
        "condition": {
          "field": "is_pensionable",
          "equals": true
        }
      }
    ],
    "workerType": "employee"
  },
  "employerFields": {
    "countryCode": "MX",
    "version": 3,
    "fields": [
      {
        "key": "taxId",
        "name": "RFC (Registro Federal de Contribuyentes)",
        "description": "SAT-issued RFC, required on all ISR withholding returns",
        "type": "string",
        "required": true,
        "entity": "person",
        "scope": [
          "calculation",
          "filing"
        ],
        "enum": [
          "<string>"
        ],
        "pattern": "^[A-Z&Ñ]{4}\\d{6}[A-Z0-9]{3}$",
        "condition": {
          "field": "is_pensionable",
          "equals": true
        }
      }
    ],
    "workerType": "employee"
  },
  "filingTypes": [
    {
      "id": "ft_mx_isr_monthly",
      "name": "ISR Withholding",
      "description": "ISR income tax withholding return filed monthly with SAT",
      "governmentFormName": "Declaración Provisional ISR",
      "authority": {
        "id": "auth_mx_sat",
        "name": "Servicio de Administración Tributaria",
        "abbreviation": "SAT"
      },
      "frequency": "MONTHLY",
      "dueDay": 10,
      "includesRemittance": true,
      "legislativeReference": "Ley del Impuesto Sobre la Renta (LISR), Artículo 96"
    }
  ],
  "statutoryBenefits": [
    {
      "name": "IMSS Employer-Employee Contributions",
      "description": "Mandatory social security contribution under the Ley del Seguro Social (LSS)",
      "employerRate": 0.1,
      "employeeRate": 0.08,
      "authority": "IMSS",
      "legislativeReference": "Ley del Seguro Social (LSS), Artículo 39"
    }
  ],
  "compliance": {
    "workingHoursPerWeek": 48,
    "annualLeave": "12 working days after 1 year, increasing with seniority",
    "sickLeave": "Up to 52 weeks (60% pay via IMSS after 3-day waiting period)",
    "publicHolidays": "Paid, nationally observed (approx 7 mandatory rest days)",
    "probationPeriod": "30 days (up to 180 days for managerial/technical roles)",
    "onboardingTimeline": "5-10 business days",
    "payrollCutoffs": {
      "inputs": "5 business days before pay date",
      "approval": "3 business days before pay date"
    }
  },
  "termination": {
    "noticeRequired": true,
    "description": "<string>",
    "finalPayIncludes": [
      "<string>"
    ]
  }
}

Authorizations

Authorization · string · header · required

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

Path Parameters

country_code · string · required

ISO 3166-1 alpha-2 country code

Pattern: ^[A-Z]{2}$

Response

200

application/json

Jurisdiction details

countryCode · string

Example:

"MX"

countryName · string

Example:

"Mexico"

currency · string

Example:

"MXN"

status · enum<string>

Available options: live, coming_soon

payrollFrequency · enum<string>

Available options: MONTHLY, BIWEEKLY, SEMI_MONTHLY, WEEKLY

employeeFields · object

Flat list of fields required for tax calculation and/or statutory filing in a jurisdiction. Each field includes its entity (person or business), scope (calculation, filing, or both), and validation rules.

Fields with entity: "person" are worker-level data. Fields with entity: "business" are employer-level data. Use the entity field to build separate onboarding forms for workers and employers.

Show child attributes

employerFields · object

Flat list of fields required for tax calculation and/or statutory filing in a jurisdiction. Each field includes its entity (person or business), scope (calculation, filing, or both), and validation rules.

Fields with entity: "person" are worker-level data. Fields with entity: "business" are employer-level data. Use the entity field to build separate onboarding forms for workers and employers.

Show child attributes

filingTypes · object[]

Show child attributes

statutoryBenefits · object[]

Show child attributes

compliance · object

Show child attributes

termination · object

Show child attributes