{
  "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",
    "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"
          }
        ]
      }
    ],
    "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"
      }
    ]
  }
}