🪪 RUN Status

The RUN Status report validates Chile’s national identification number (Rol Único Nacional) and retrieves associated personal data from the official Servicio de Registro Civil e Identificación database.

Overview

RUN Status validation is the foundation of identity verification in Chile. This report validates the RUN format, confirms its existence in the national registry, and retrieves associated personal information for cross-verification with other reports.

Input Requirements

Required Fields

Field	Type	Description	Example
`document_id`	string	RUN number with check digit	`12345678-9`
`city_locode`	string	UN LOCODE of the city	`CL SCL`

Optional Fields

Field	Type	Description	Default
`document_id_type`	string	Type of RUN document	`national_id`
`full_name`	string	Expected full name for verification	`null`
`date_of_birth`	string	Expected date of birth (YYYY-MM-DD)	`null`

RUN Format Specification

The RUN follows a specific format with a check digit:

12345678-9

Format Breakdown

Component	Description	Example
Base Number	7-8 digits	`12345678`
Check Digit	Single digit or ‘K’	`9` or `K`
Separator	Hyphen	`-`

Document Types

Type	Description	Usage
`national_id`	Cédula de Identidad Chilena	Chilean citizens
`foreigner_card`	Cédula de Identidad a Extranjeros	Foreign residents

Check Digit Algorithm

The RUN uses a specific algorithm to validate the check digit:

// RUN check digit calculation
function validateRUN(run) {
  // Remove formatting and convert to uppercase
  run = run.replace(/[^0-9kK]/g, '').toUpperCase();

  if (run.length < 8 || run.length > 9) return false;

  const body = run.slice(0, -1);
  const checkDigit = run.slice(-1);

  let sum = 0;
  let multiplier = 2;

  // Calculate from right to left
  for (let i = body.length - 1; i >= 0; i--) {
    sum += parseInt(body[i]) * multiplier;
    multiplier = multiplier === 7 ? 2 : multiplier + 1;
  }

  const remainder = sum % 11;
  const calculatedDigit = remainder === 0 ? '0' :
                         remainder === 1 ? 'K' :
                         (11 - remainder).toString();

  return checkDigit === calculatedDigit;
}

Data Source

Registry: Servicio de Registro Civil e Identificación Authority: Ministerio de Justicia y Derechos Humanos Coverage: All Chilean citizens and legal residents Update Frequency: Real-time

Response Schemas

Successful Validation - Active RUN

{
  "id": "beb8716f-34cc-4582-aafa-ef011b1cc6f5",
  "reports": {
    "run_status": {
      "state": "COMPLETED",
      "created_at": "2021-03-30T03:18:31.242613",
      "updated_at": "2021-03-30T03:18:41.915065",
      "outcome": "PASSED",
      "details": {
        "run": "12345678-9",
        "document_type": "national_id",
        "full_name": "JUAN RODRIGUEZ PEREZ",
        "date_of_birth": "1985-03-15",
        "gender": "M",
        "nationality": "CHILEAN",
        "validation": {
          "format_valid": true,
          "check_digit_valid": true,
          "registry_found": true,
          "status": "ACTIVE"
        }
      }
    }
  }
}

Foreigner Card Response

{
  "id": "beb8716f-34cc-4582-aafa-ef011b1cc6f5",
  "reports": {
    "run_status": {
      "state": "COMPLETED",
      "created_at": "2021-03-30T03:18:31.242613",
      "updated_at": "2021-03-30T03:18:41.915065",
      "outcome": "PASSED",
      "details": {
        "run": "25123456-7",
        "document_type": "foreigner_card",
        "full_name": "MARIA ELENA GONZALEZ SILVA",
        "date_of_birth": "1990-07-22",
        "gender": "F",
        "nationality": "COLOMBIAN",
        "residence_status": "PERMANENT_RESIDENT",
        "validation": {
          "format_valid": true,
          "check_digit_valid": true,
          "registry_found": true,
          "status": "ACTIVE"
        }
      }
    }
  }
}

Document Not Found Response

{
  "id": "beb8716f-34cc-4582-aafa-ef011b1cc6f5",
  "reports": {
    "run_status": {
      "state": "COMPLETED",
      "created_at": "2021-03-30T03:18:31.242613",
      "updated_at": "2021-03-30T03:18:41.915065",
      "outcome": "INCOMPLETE",
      "details": {
        "run": "99999999-9",
        "message": "No details found for the provided RUN",
        "validation": {
          "format_valid": true,
          "check_digit_valid": true,
          "registry_found": false,
          "status": "NOT_FOUND"
        }
      }
    }
  }
}

Invalid RUN Response

{
  "id": "beb8716f-34cc-4582-aafa-ef011b1cc6f5",
  "reports": {
    "run_status": {
      "state": "COMPLETED",
      "created_at": "2021-03-30T03:18:31.242613",
      "updated_at": "2021-03-30T03:18:41.915065",
      "outcome": "FAILED",
      "details": {
        "run": "INVALID123",
        "validation": {
          "format_valid": false,
          "check_digit_valid": false,
          "registry_found": false,
          "errors": [
            "Invalid RUN format",
            "Check digit mismatch",
            "Not found in Registro Civil registry"
          ]
        }
      }
    }
  }
}

Validation Outcomes

PASSED Status

Meaning: RUN is valid and found in registry
Conditions: Format valid, check digit correct, registry found
Data Available: Full personal information retrieved

INCOMPLETE Status

Meaning: RUN format is valid but not found in registry
Conditions: Format valid, check digit correct, but no registry match
Data Available: Limited to validation information

FAILED Status

Meaning: RUN format is invalid or check digit incorrect
Conditions: Format invalid or check digit mismatch
Data Available: Error information only

PENDING Status

Meaning: Initial check inconclusive, automatic retry in progress
Conditions: Temporary registry unavailability or processing delay
Data Available: Status information only

Validation Process

Format Validation Steps

Length Check: Must be 8-9 characters (including check digit)
Character Validation: Numeric digits plus optional ‘K’ check digit
Separator Check: Proper hyphen placement (optional in input)
Check Digit Validation: Verify using Chilean algorithm
Range Validation: Ensure RUN is within valid ranges

Registry Validation

Registro Civil Lookup: Check existence in official database
Document Type Verification: Confirm national ID vs foreigner card
Status Check: Verify current validity and status
Data Retrieval: Extract associated personal information
Cross-Reference: Validate against provided data if available

RUN Status enables and validates other Chile reports:

Criminal Records Report

Validates identity before criminal background check:

{
  "criminal": {
    "outcome": "PASSED",
    "details": {
      "records_found": false,
      "search_scope": "NATIONAL_COURTS",
      "verification_status": "VERIFIED"
    }
  }
}

Justice Certificate Report

Provides official criminal record certificate:

{
  "justice_certificate": {
    "outcome": "PASSED",
    "details": {
      "certificate_number": "JC123456789",
      "issue_date": "2021-03-30",
      "validity_period": "90_DAYS",
      "criminal_records": false
    }
  }
}

API Integration Examples

Create Person with RUN Validation

curl -X POST "https://api.emptor.io/v3/cl/persons" \
  -H "X-Api-Key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "document_id": "12345678-9",
    "document_id_type": "national_id",
    "city_locode": "CL SCL",
    "pipeline": {
      "name": "basic_background_check"
    }
  }'

Foreigner Card Validation

curl -X POST "https://api.emptor.io/v3/cl/persons" \
  -H "X-Api-Key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "document_id": "25123456-7",
    "document_id_type": "foreigner_card",
    "city_locode": "CL SCL",
    "full_name": "MARIA ELENA GONZALEZ",
    "pipeline": {
      "name": "basic_background_check"
    }
  }'

Get RUN Report Details

curl -X GET "https://api.emptor.io/v3/cl/details/{person_id}/run_status" \
  -H "X-Api-Key: YOUR_API_KEY"

Common Validation Errors

Error Type	Description	Resolution
`INVALID_FORMAT`	RUN doesn’t match Chilean format	Verify RUN format (12345678-9)
`INVALID_CHECK_DIGIT`	Check digit calculation fails	Verify RUN was entered correctly
`INVALID_LENGTH`	RUN length incorrect	Check digit count (7-8 digits + check)
`NOT_FOUND_IN_REGISTRY`	RUN not found in Registro Civil	Verify RUN exists and is issued
`REGISTRY_TIMEOUT`	Registro Civil database timeout	Retry after a few minutes
`UNSUPPORTED_DOCUMENT_TYPE`	Document type not supported	Use national_id or foreigner_card

Document Type Considerations

National ID (Cédula de Identidad Chilena)

Target Population: Chilean citizens
Number Range: Typically 1,000,000 to 25,000,000
Data Available: Full personal and civil information
Usage: All Chilean government and private services

Foreigner Card (Cédula de Identidad a Extranjeros)

Target Population: Foreign residents in Chile
Number Range: Typically 25,000,000+
Data Available: Personal information plus residency status
Usage: Legal residents with work/study authorization

Use Cases and Applications

Primary Applications

Identity Verification: Primary identity check for Chilean residents
Employment Screening: Verify candidate identity and work authorization
Financial Services: Account opening and KYC compliance
Government Services: Citizen and resident service verification
Legal Proceedings: Court and legal document verification

Integration Workflows

Basic Identity Check

RUN Status → Criminal Records → License Status

Standard Background Check

RUN Status → Criminal Records → Justice Certificate → Employment History

Enhanced Verification

RUN Status → Criminal Records → Justice Certificate → Financial Records → International Sanctions

Create Person - Initiate RUN validation
Get Reports - Retrieve RUN results
Get Report Details - Detailed RUN data
Update Reports - Refresh RUN validation

Criminal Records Reference - Criminal background checks
State Records Reference - State-level criminal records
Chile Country Guide - Chile-specific information
Legal Glossary - Legal terminology