{
  "schema": "WorknationCandidatePayload",
  "operation": "POST /v1/candidates (request)",
  "order": 1,
  "summary": "Full ATS candidate — every field and nested attribute populated. Per-field examples are derived from this.",
  "value": {
    "externalId": "wn-1004",
    "firstName": "Zoe",
    "middleName": "Ama",
    "preferredName": "Zoe",
    "lastName": "Mensah",
    "headline": "Senior plumber · 6 yrs municipal water infrastructure",
    "summary": "HND-qualified plumber with six years on municipal water-infrastructure projects in Accra. Led five-person crews; relocation-ready and open to sponsored roles in the UK and Germany.",
    "email": "zoe.mensah@example.com",
    "phone": "+233201234567",
    "dateOfBirth": "1996-04-21",
    "gender": "female",
    "nationality": "GH",
    "countryOfResidence": "GH",
    "address": {
      "line1": "12 Ring Road Central",
      "line2": "Apartment 4B",
      "city": "Accra",
      "region": "Greater Accra",
      "postalCode": "GA-123-4567",
      "country": "GH"
    },
    "skills": [
      {
        "name": "Plumbing",
        "yearsExperience": 6,
        "proficiency": "expert",
        "lastUsedYear": 2026
      }
    ],
    "workHistory": [
      {
        "employer": "Accra Waterworks",
        "jobTitle": "Senior Plumber",
        "employmentType": "full_time",
        "startDate": "2019-03-01",
        "endDate": "2026-06-30",
        "isCurrent": false,
        "location": "Accra, Ghana",
        "description": "Led a team of five on municipal water-infrastructure projects."
      }
    ],
    "education": [
      {
        "institution": "Accra Technical University",
        "qualification": "HND Plumbing & Gas Engineering",
        "fieldOfStudy": "Plumbing Engineering",
        "completionStatus": "completed",
        "startDate": "2014-09-01",
        "endDate": "2017-06-30",
        "grade": "Distinction"
      }
    ],
    "languages": [
      {
        "language": "English",
        "proficiency": "fluent"
      },
      {
        "language": "Twi",
        "proficiency": "native"
      }
    ],
    "workEligibility": [
      {
        "country": "GB",
        "status": "requires_sponsorship",
        "visaType": "Skilled Worker",
        "expiresAt": "2028-12-31"
      }
    ],
    "jobPreferences": {
      "desiredTitles": [
        "Plumber",
        "Pipefitter"
      ],
      "employmentTypes": [
        "full_time",
        "contract"
      ],
      "preferredCountries": [
        "GB",
        "DE"
      ],
      "openToRelocation": true,
      "openToRemote": false,
      "salaryExpectation": {
        "currency": "GBP",
        "min": 32000,
        "max": 45000,
        "period": "annual"
      }
    },
    "referees": [
      {
        "name": "Kwame Asante",
        "relationship": "Former manager",
        "company": "Accra Waterworks",
        "email": "kwame.asante@example.com",
        "phone": "+233209876543"
      }
    ],
    "tags": [
      "trades",
      "relocation-ready",
      "verified"
    ],
    "source": {
      "provider": "worknation",
      "sourceChannel": "referral",
      "campaign": "gca-africa-2026",
      "submittedAt": "2026-07-14T10:30:00Z"
    },
    "documents": [
      {
        "documentType": "cv",
        "label": "2024 CV",
        "currentVersion": 2,
        "versions": [
          {
            "version": 1,
            "url": "https://files.example/zoe-cv-v1.pdf",
            "fileName": "zoe-cv-v1.pdf",
            "contentType": "application/pdf",
            "sizeBytes": 184320,
            "uploadedAt": "2026-01-10T09:00:00Z",
            "checksum": "sha256:9f2b1c7a4e5d6f8091a2b3c4d5e6f708",
            "uploadedByExternalId": "wn-1004"
          },
          {
            "version": 2,
            "url": "https://files.example/zoe-cv-v2.pdf",
            "fileName": "zoe-cv-v2.pdf",
            "contentType": "application/pdf",
            "sizeBytes": 201728,
            "uploadedAt": "2026-06-02T09:00:00Z",
            "checksum": "sha256:4c1a2b3d4e5f60718293a4b5c6d7e8f9",
            "uploadedByExternalId": "wn-1004"
          }
        ]
      },
      {
        "documentType": "identity_document",
        "label": "Ghana Passport",
        "currentVersion": 1,
        "versions": [
          {
            "version": 1,
            "url": "https://files.example/zoe-passport.pdf",
            "fileName": "zoe-passport.pdf",
            "contentType": "application/pdf",
            "sizeBytes": 512000,
            "uploadedAt": "2026-01-10T09:00:00Z",
            "checksum": "sha256:aa11bb22cc33dd44ee55ff6677889900",
            "uploadedByExternalId": "wn-1004"
          }
        ]
      }
    ],
    "links": [
      {
        "type": "linkedin",
        "url": "https://www.linkedin.com/in/zoe-mensah",
        "label": "LinkedIn"
      },
      {
        "type": "portfolio",
        "url": "https://zoe-mensah.example/work",
        "label": "Project portfolio"
      }
    ],
    "media": [
      {
        "kind": "intro_video",
        "assetKey": "wn:media:vid_1004",
        "provider": "worknation",
        "contentType": "video/mp4",
        "fileName": "zoe-intro.mp4",
        "sizeBytes": 4718592,
        "durationSeconds": 68,
        "width": 1280,
        "height": 720,
        "caption": "60-second introduction",
        "uploadedAt": "2026-06-02T09:05:00Z"
      },
      {
        "kind": "profile_photo",
        "assetKey": "wn:media:img_1004",
        "provider": "worknation",
        "contentType": "image/jpeg",
        "fileName": "zoe-headshot.jpg",
        "sizeBytes": 98304,
        "width": 800,
        "height": 800,
        "caption": "Profile headshot",
        "uploadedAt": "2026-06-02T09:05:00Z"
      },
      {
        "kind": "portfolio_image",
        "url": "https://files.example/zoe-portfolio-1.jpg",
        "contentType": "image/jpeg",
        "fileName": "portfolio-1.jpg",
        "sizeBytes": 245760,
        "width": 1600,
        "height": 1200,
        "caption": "Completed pipework — Accra municipal project",
        "uploadedAt": "2026-05-30T14:00:00Z"
      }
    ],
    "assessments": [
      {
        "externalId": "kry-88f21",
        "provider": "kryterion",
        "name": "Plumbing Work-Readiness",
        "status": "completed",
        "outcome": "pass",
        "score": 84,
        "maxScore": 100,
        "scoreBand": "Proficient",
        "competencies": [
          {
            "code": "PLM-110",
            "label": "Pipe Fitting & Joining",
            "score": 90
          },
          {
            "code": "PLM-240",
            "label": "Water Systems Safety",
            "score": 78
          }
        ],
        "reportKey": "kry:report:88f21",
        "completedAt": "2026-05-18T13:15:00Z",
        "expiresAt": "2028-05-18T13:15:00Z"
      },
      {
        "externalId": "kry-90a12",
        "provider": "kryterion",
        "name": "Health & Safety Induction",
        "status": "completed",
        "outcome": "pass",
        "score": 95,
        "maxScore": 100,
        "scoreBand": "Distinction",
        "competencies": [
          {
            "code": "HS-100",
            "label": "Site Safety",
            "score": 95
          }
        ],
        "reportUrl": "https://files.example/zoe-hs-report.pdf",
        "completedAt": "2026-04-02T10:00:00Z",
        "expiresAt": "2027-04-02T10:00:00Z"
      }
    ],
    "consentGiven": true,
    "consents": [
      {
        "type": "data_processing",
        "granted": true,
        "grantedAt": "2026-01-10T08:55:00Z",
        "policyVersion": "2026-01"
      },
      {
        "type": "data_sharing_partners",
        "granted": true,
        "grantedAt": "2026-01-10T08:56:00Z",
        "policyVersion": "2026-01"
      }
    ]
  }
}