🪪 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

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

Registry Validation

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

Related Reports Integration

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

Related API Endpoints

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

Related Documentation

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

RUN Foundation

RUN validation is required for all other Chile reports. Always ensure RUN validation passes before proceeding with criminal records or other verification reports.

Document Types

Chile has two main document types: national ID for citizens and foreigner cards for residents. Specify the correct document_id_type for accurate validation.

Criminal Records Dependency

For successful criminal record checks, a prior RUN Status validation with positive results is crucial. Ensure RUN validation passes before requesting criminal background reports.