ContactDB Data Schema

Updated October 2025

{
    "contact_data": {
        "company_address": {
            "accuracy": "string",
            "administrative_area_level_1": "string",
            "administrative_area_level_2": "string",
            "administrative_area_level_3": "string",
            "administrative_area_level_4": "string",
            "administrative_area_level_5": "string",
            "city": "string",
            "confidence_score": "float",
            "continent": "string",
            "country": "string",
            "country_code": "string",
            "county": "string",
            "establishment": "string",
            "formatted_address": "string",
            "last_modified_date": "string (YYYY-MM-DD HH:MM:SS)",
            "lat": "float",
            "lng": "float",
            "locality": "string",
            "place_id": "string",
            "postal_code": "string",
            "postal_town": "string",
            "premise": "string",
            "quality": "string",
            "region": "string",
            "score": "float",
            "state": "string",
            "state_code": "string",
            "street": "string",
            "street_address": "string",
            "street_number": "string",
            "sublocality": "string",
            "subpremise": "string"
        },
        "company_domain": "string",
        "company_employees": {
            "number_of_employees": "integer",
            "number_of_employees_code": "string",
            "number_of_employees_max": "integer",
            "number_of_employees_min": "integer"
        },
        "company_financials": [
            {
                "priority": "integer",
                "yearly_growth": {
                    "code": "string",
                    "percentage": "float",
                    "score": "float",
                    "type": "string",
                    "year": "integer"
                },
                "yearly_revenue": {
                    "code": "string",
                    "currency": "string",
                    "reported_date": "string (YYYY-MM-DD)",
                    "revenue": "integer",
                    "score": "float",
                    "type": "string",
                    "year": "integer"
                }
            }
        ],
        "company_id": "string",
        "company_industries": [
            {
                "activity_priority": "integer",
                "code2": "string",
                "code3": "string",
                "code4": "string",
                "code5": "string",
                "code6": "string",
                "id": "string",
                "name2": "string",
                "name3": "string",
                "name4": "string",
                "name5": "string",
                "name6": "string",
                "priority": "integer",
                "standard": "string"
            }
        ],
        "company_industry": "string",
        "company_logo_url": "string",
        "company_name": "string",
        "company_phones": [
            {
                "carrier": "string",
                "ddi": "boolean",
                "dnc": "boolean",
                "phone": "string",
                "priority": "integer",
                "type": "string"
            }
        ],
        "company_revenue_in_usd": "integer",
        "company_revenue_in_usd_code": "string",
        "company_social_links": {
            "crunchbase": {
                "url": "string"
            },
            "facebook": {
                "url": "string"
            },
            "instagram": {
                "url": "string"
            },
            "linkedin": {
                "url": "string"
            },
            "twitter": {
                "url": "string"
            },
            "yelp": {
                "url": "string"
            },
            "youtube": {
                "url": "string"
            }
        },
        "company_web_address": {
            "rank": "integer",
            "url": "string"
        },
        "contact_address": {
            "accuracy": "string",
            "administrative_area_level_1": "string",
            "administrative_area_level_2": "string",
            "administrative_area_level_3": "string",
            "administrative_area_level_4": "string",
            "administrative_area_level_5": "string",
            "city": "string",
            "confidence_score": "float",
            "continent": "string",
            "country": "string",
            "country_code": "string",
            "county": "string",
            "establishment": "string",
            "formatted_address": "string",
            "last_modified_date": "string (YYYY-MM-DD HH:MM:SS)",
            "lat": "float",
            "lng": "float",
            "locality": "string",
            "place_id": "string",
            "postal_code": "string",
            "postal_town": "string",
            "premise": "string",
            "quality": "string",
            "region": "string",
            "score": "float",
            "state": "string",
            "state_code": "string",
            "street": "string",
            "street_address": "string",
            "street_number": "string",
            "sublocality": "string",
            "subpremise": "string"
        },
        "contact_country": "string",
        "contact_emails": [
            {
                "email": "string",
                "reason": "string",
                "type": "string"
            }
        ],
        "contact_first_name": "string",
        "contact_id": "string",
        "contact_languages": ["string"],
        "contact_last_modified_date": "string (YYYY-MM-DD HH:MM:SS)",
        "contact_last_name": "string",
        "contact_phones": [
            {
                "phone": "string",
                "ddi": "boolean",
                "dnc": "boolean",
                "type": "string",
                "carrier": "string",
                "priority": "integer"
            }
        ],
        "contact_social_links": [
            {
                "name": "string",
                "url": "string"
            },
            {
                "name": "string",
                "url": "string"
            }
        ],
        "contact_still_at_company_status": "string",
        "contact_tags": [
            "string"
        ],
        "job_functions": [
            {
                "level1": {
                    "code": "string",
                    "confidence_score": "float",
                    "name": "string"
                },
                "level2": {
                    "code": "string",
                    "confidence_score": "float",
                    "name": "string"
                },
                "level3": {
                    "code": "string",
                    "confidence_score": "float",
                    "name": "string"
                },
                "priority": "integer"
            }
        ],
        "job_seniority": {
            "job_level": "string"
        },
        "job_title": "string",
        "job_title_details": {
            "normalized_job_title": {
                "id": "integer",
                "job_title": "string"
            },
            "raw_job_title": {
                "job_title": "string",
                "language_code": "string",
                "language_detection_confidence_score": "float"
            },
            "raw_translated_job_title": {
                "job_title": "string",
                "language_code": "string"
            }
        },
        "office_address": {
            "accuracy": "string",
            "administrative_area_level_1": "string",
            "administrative_area_level_2": "string",
            "administrative_area_level_3": "string",
            "administrative_area_level_4": "string",
            "administrative_area_level_5": "string",
            "city": "string",
            "confidence_score": "float",
            "continent": "string",
            "country": "string",
            "country_code": "string",
            "county": "string",
            "establishment": "string",
            "formatted_address": "string",
            "last_modified_date": "string (YYYY-MM-DD HH:MM:SS)",
            "lat": "float",
            "lng": "float",
            "locality": "string",
            "place_id": "string",
            "postal_code": "string",
            "postal_town": "string",
            "premise": "string",
            "quality": "string",
            "region": "string",
            "score": "float",
            "state": "string",
            "state_code": "string",
            "street": "string",
            "street_address": "string",
            "street_number": "string",
            "sublocality": "string",
            "subpremise": "string"
        },
        "office_id": "string",
        "office_industries": [
            {
                "activity_priority": "integer",
                "code2": "string",
                "code3": "string",
                "code4": "string",
                "code5": "string",
                "code6": "string",
                "id": "string",
                "name2": "string",
                "name3": "string",
                "name4": "string",
                "name5": "string",
                "name6": "string",
                "priority": "integer",
                "standard": "string"
            }
        ],
        "office_phones": [
            {
                "phone": "string",
                "ddi": "boolean",
                "dnc": "boolean",
                "type": "string",
                "carrier": "string",
                "status": "string",
                "status_last_verification_date": "string (YYYY-MM-DD HH:MM:SS)",
                "score": "float",
                "priority": "integer"
            }
        ],
        "office_type": "string",
        "priority": "integer",
        "profile_id": "string",
        "raw_location": "string",
        "start_date": "string (YYYY-MM-DD HH:MM:SS)",
        "summary": "string"
    },
    "id": "string"
}