{ "item": [ { "id": "01177b09-9ab5-4610-abc4-d30b2055df30", "name": "candidates", "description": { "content": "Candidate intake and records.\n\n**Identifiers —** `POST` returns a `stagedId`; store it and use it for every follow-up call. On promotion the record gains a durable canonical `id`, but the `stagedId` keeps resolving, so either works on `GET`/`PUT`.\n\n**Idempotency —** send your own `externalId` on create. A retry with the same `externalId` returns the original `stagedId` (no duplicate, no re-fired event). Recover our record any time with `GET /v1/candidates?externalId=`. Re-sync data with `PUT`, not a second `POST`.", "type": "text/plain" }, "item": [ { "id": "d6a6b212-df12-489e-8cec-13c157afaa3a", "name": "Receive a candidate from Worknation", "request": { "name": "Receive a candidate from Worknation", "description": { "content": "Creates a staged candidate in intake and returns a stagedId. Idempotent on your externalId: retrying with the same externalId returns the original stagedId instead of creating a duplicate. Re-sync data with PUT, not a second POST.", "type": "text/plain" }, "url": { "path": [ "v1", "candidates" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" } ], "method": "POST", "auth": null, "body": { "mode": "raw", "raw": "{\n \"externalId\": \"wn-1004\",\n \"firstName\": \"Zoe\",\n \"middleName\": \"Ama\",\n \"preferredName\": \"Zoe\",\n \"lastName\": \"Mensah\",\n \"headline\": \"Senior plumber · 6 yrs municipal water infrastructure\",\n \"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.\",\n \"email\": \"zoe.mensah@example.com\",\n \"phone\": \"+233201234567\",\n \"dateOfBirth\": \"1996-04-21\",\n \"gender\": \"female\",\n \"nationality\": \"GH\",\n \"countryOfResidence\": \"GH\",\n \"address\": {\n \"line1\": \"12 Ring Road Central\",\n \"line2\": \"Apartment 4B\",\n \"city\": \"Accra\",\n \"region\": \"Greater Accra\",\n \"postalCode\": \"GA-123-4567\",\n \"country\": \"GH\"\n },\n \"skills\": [\n {\n \"name\": \"Plumbing\",\n \"yearsExperience\": 6,\n \"proficiency\": \"expert\",\n \"lastUsedYear\": 2026\n }\n ],\n \"workHistory\": [\n {\n \"employer\": \"Accra Waterworks\",\n \"jobTitle\": \"Senior Plumber\",\n \"employmentType\": \"full_time\",\n \"startDate\": \"2019-03-01\",\n \"endDate\": \"2026-06-30\",\n \"isCurrent\": false,\n \"location\": \"Accra, Ghana\",\n \"description\": \"Led a team of five on municipal water-infrastructure projects.\"\n }\n ],\n \"education\": [\n {\n \"institution\": \"Accra Technical University\",\n \"qualification\": \"HND Plumbing & Gas Engineering\",\n \"fieldOfStudy\": \"Plumbing Engineering\",\n \"completionStatus\": \"completed\",\n \"startDate\": \"2014-09-01\",\n \"endDate\": \"2017-06-30\",\n \"grade\": \"Distinction\"\n }\n ],\n \"languages\": [\n {\n \"language\": \"English\",\n \"proficiency\": \"fluent\"\n },\n {\n \"language\": \"Twi\",\n \"proficiency\": \"native\"\n }\n ],\n \"workEligibility\": [\n {\n \"country\": \"GB\",\n \"status\": \"requires_sponsorship\",\n \"visaType\": \"Skilled Worker\",\n \"expiresAt\": \"2028-12-31\"\n }\n ],\n \"jobPreferences\": {\n \"desiredTitles\": [\n \"Plumber\",\n \"Pipefitter\"\n ],\n \"employmentTypes\": [\n \"full_time\",\n \"contract\"\n ],\n \"preferredCountries\": [\n \"GB\",\n \"DE\"\n ],\n \"openToRelocation\": true,\n \"openToRemote\": false,\n \"salaryExpectation\": {\n \"currency\": \"GBP\",\n \"min\": 32000,\n \"max\": 45000,\n \"period\": \"annual\"\n }\n },\n \"referees\": [\n {\n \"name\": \"Kwame Asante\",\n \"relationship\": \"Former manager\",\n \"company\": \"Accra Waterworks\",\n \"email\": \"kwame.asante@example.com\",\n \"phone\": \"+233209876543\"\n }\n ],\n \"tags\": [\n \"trades\",\n \"relocation-ready\",\n \"verified\"\n ],\n \"source\": {\n \"provider\": \"worknation\",\n \"sourceChannel\": \"referral\",\n \"campaign\": \"gca-africa-2026\",\n \"submittedAt\": \"2026-07-14T10:30:00Z\"\n },\n \"documents\": [\n {\n \"documentType\": \"cv\",\n \"label\": \"2024 CV\",\n \"currentVersion\": 2,\n \"versions\": [\n {\n \"version\": 1,\n \"url\": \"https://files.example/zoe-cv-v1.pdf\",\n \"fileName\": \"zoe-cv-v1.pdf\",\n \"contentType\": \"application/pdf\",\n \"sizeBytes\": 184320,\n \"uploadedAt\": \"2026-01-10T09:00:00Z\",\n \"checksum\": \"sha256:9f2b1c7a4e5d6f8091a2b3c4d5e6f708\",\n \"uploadedByExternalId\": \"wn-1004\"\n },\n {\n \"version\": 2,\n \"url\": \"https://files.example/zoe-cv-v2.pdf\",\n \"fileName\": \"zoe-cv-v2.pdf\",\n \"contentType\": \"application/pdf\",\n \"sizeBytes\": 201728,\n \"uploadedAt\": \"2026-06-02T09:00:00Z\",\n \"checksum\": \"sha256:4c1a2b3d4e5f60718293a4b5c6d7e8f9\",\n \"uploadedByExternalId\": \"wn-1004\"\n }\n ]\n },\n {\n \"documentType\": \"identity_document\",\n \"label\": \"Ghana Passport\",\n \"currentVersion\": 1,\n \"versions\": [\n {\n \"version\": 1,\n \"url\": \"https://files.example/zoe-passport.pdf\",\n \"fileName\": \"zoe-passport.pdf\",\n \"contentType\": \"application/pdf\",\n \"sizeBytes\": 512000,\n \"uploadedAt\": \"2026-01-10T09:00:00Z\",\n \"checksum\": \"sha256:aa11bb22cc33dd44ee55ff6677889900\",\n \"uploadedByExternalId\": \"wn-1004\"\n }\n ]\n }\n ],\n \"links\": [\n {\n \"type\": \"linkedin\",\n \"url\": \"https://www.linkedin.com/in/zoe-mensah\",\n \"label\": \"LinkedIn\"\n },\n {\n \"type\": \"portfolio\",\n \"url\": \"https://zoe-mensah.example/work\",\n \"label\": \"Project portfolio\"\n }\n ],\n \"media\": [\n {\n \"kind\": \"intro_video\",\n \"assetKey\": \"wn:media:vid_1004\",\n \"provider\": \"worknation\",\n \"contentType\": \"video/mp4\",\n \"fileName\": \"zoe-intro.mp4\",\n \"sizeBytes\": 4718592,\n \"durationSeconds\": 68,\n \"width\": 1280,\n \"height\": 720,\n \"caption\": \"60-second introduction\",\n \"uploadedAt\": \"2026-06-02T09:05:00Z\"\n },\n {\n \"kind\": \"profile_photo\",\n \"assetKey\": \"wn:media:img_1004\",\n \"provider\": \"worknation\",\n \"contentType\": \"image/jpeg\",\n \"fileName\": \"zoe-headshot.jpg\",\n \"sizeBytes\": 98304,\n \"width\": 800,\n \"height\": 800,\n \"caption\": \"Profile headshot\",\n \"uploadedAt\": \"2026-06-02T09:05:00Z\"\n },\n {\n \"kind\": \"portfolio_image\",\n \"url\": \"https://files.example/zoe-portfolio-1.jpg\",\n \"contentType\": \"image/jpeg\",\n \"fileName\": \"portfolio-1.jpg\",\n \"sizeBytes\": 245760,\n \"width\": 1600,\n \"height\": 1200,\n \"caption\": \"Completed pipework — Accra municipal project\",\n \"uploadedAt\": \"2026-05-30T14:00:00Z\"\n }\n ],\n \"assessments\": [\n {\n \"externalId\": \"kry-88f21\",\n \"provider\": \"kryterion\",\n \"name\": \"Plumbing Work-Readiness\",\n \"status\": \"completed\",\n \"outcome\": \"pass\",\n \"score\": 84,\n \"maxScore\": 100,\n \"scoreBand\": \"Proficient\",\n \"competencies\": [\n {\n \"code\": \"PLM-110\",\n \"label\": \"Pipe Fitting & Joining\",\n \"score\": 90\n },\n {\n \"code\": \"PLM-240\",\n \"label\": \"Water Systems Safety\",\n \"score\": 78\n }\n ],\n \"reportKey\": \"kry:report:88f21\",\n \"completedAt\": \"2026-05-18T13:15:00Z\",\n \"expiresAt\": \"2028-05-18T13:15:00Z\"\n },\n {\n \"externalId\": \"kry-90a12\",\n \"provider\": \"kryterion\",\n \"name\": \"Health & Safety Induction\",\n \"status\": \"completed\",\n \"outcome\": \"pass\",\n \"score\": 95,\n \"maxScore\": 100,\n \"scoreBand\": \"Distinction\",\n \"competencies\": [\n {\n \"code\": \"HS-100\",\n \"label\": \"Site Safety\",\n \"score\": 95\n }\n ],\n \"reportUrl\": \"https://files.example/zoe-hs-report.pdf\",\n \"completedAt\": \"2026-04-02T10:00:00Z\",\n \"expiresAt\": \"2027-04-02T10:00:00Z\"\n }\n ],\n \"consentGiven\": true,\n \"consents\": [\n {\n \"type\": \"data_processing\",\n \"granted\": true,\n \"grantedAt\": \"2026-01-10T08:55:00Z\",\n \"policyVersion\": \"2026-01\"\n },\n {\n \"type\": \"data_sharing_partners\",\n \"granted\": true,\n \"grantedAt\": \"2026-01-10T08:56:00Z\",\n \"policyVersion\": \"2026-01\"\n }\n ]\n}", "options": { "raw": { "language": "json" } } } }, "response": [ { "id": "1890a8cb-2950-4207-bd33-004df8cd5660", "name": "The 201 response to POST /v1/candidates. The record enters intake (not yet promoted). Store the stagedId and use it for follow-up calls (GET/PUT /v1/candidates/{id}); on promotion the record gains a canonical id (cand_...) while the stagedId stays a valid handle. POST is idempotent on (your org, externalId): a retry returns this same stagedId instead of creating a duplicate. You can also look a record up any time with GET /v1/candidates?externalId=.", "originalRequest": { "url": { "path": [ "v1", "candidates" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "X-API-Key", "value": "" }, { "key": "Accept", "value": "application/json" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"externalId\": \"wn-1004\",\n \"firstName\": \"Zoe\",\n \"middleName\": \"Ama\",\n \"preferredName\": \"Zoe\",\n \"lastName\": \"Mensah\",\n \"headline\": \"Senior plumber · 6 yrs municipal water infrastructure\",\n \"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.\",\n \"email\": \"zoe.mensah@example.com\",\n \"phone\": \"+233201234567\",\n \"dateOfBirth\": \"1996-04-21\",\n \"gender\": \"female\",\n \"nationality\": \"GH\",\n \"countryOfResidence\": \"GH\",\n \"address\": {\n \"line1\": \"12 Ring Road Central\",\n \"line2\": \"Apartment 4B\",\n \"city\": \"Accra\",\n \"region\": \"Greater Accra\",\n \"postalCode\": \"GA-123-4567\",\n \"country\": \"GH\"\n },\n \"skills\": [\n {\n \"name\": \"Plumbing\",\n \"yearsExperience\": 6,\n \"proficiency\": \"expert\",\n \"lastUsedYear\": 2026\n }\n ],\n \"workHistory\": [\n {\n \"employer\": \"Accra Waterworks\",\n \"jobTitle\": \"Senior Plumber\",\n \"employmentType\": \"full_time\",\n \"startDate\": \"2019-03-01\",\n \"endDate\": \"2026-06-30\",\n \"isCurrent\": false,\n \"location\": \"Accra, Ghana\",\n \"description\": \"Led a team of five on municipal water-infrastructure projects.\"\n }\n ],\n \"education\": [\n {\n \"institution\": \"Accra Technical University\",\n \"qualification\": \"HND Plumbing & Gas Engineering\",\n \"fieldOfStudy\": \"Plumbing Engineering\",\n \"completionStatus\": \"completed\",\n \"startDate\": \"2014-09-01\",\n \"endDate\": \"2017-06-30\",\n \"grade\": \"Distinction\"\n }\n ],\n \"languages\": [\n {\n \"language\": \"English\",\n \"proficiency\": \"fluent\"\n },\n {\n \"language\": \"Twi\",\n \"proficiency\": \"native\"\n }\n ],\n \"workEligibility\": [\n {\n \"country\": \"GB\",\n \"status\": \"requires_sponsorship\",\n \"visaType\": \"Skilled Worker\",\n \"expiresAt\": \"2028-12-31\"\n }\n ],\n \"jobPreferences\": {\n \"desiredTitles\": [\n \"Plumber\",\n \"Pipefitter\"\n ],\n \"employmentTypes\": [\n \"full_time\",\n \"contract\"\n ],\n \"preferredCountries\": [\n \"GB\",\n \"DE\"\n ],\n \"openToRelocation\": true,\n \"openToRemote\": false,\n \"salaryExpectation\": {\n \"currency\": \"GBP\",\n \"min\": 32000,\n \"max\": 45000,\n \"period\": \"annual\"\n }\n },\n \"referees\": [\n {\n \"name\": \"Kwame Asante\",\n \"relationship\": \"Former manager\",\n \"company\": \"Accra Waterworks\",\n \"email\": \"kwame.asante@example.com\",\n \"phone\": \"+233209876543\"\n }\n ],\n \"tags\": [\n \"trades\",\n \"relocation-ready\",\n \"verified\"\n ],\n \"source\": {\n \"provider\": \"worknation\",\n \"sourceChannel\": \"referral\",\n \"campaign\": \"gca-africa-2026\",\n \"submittedAt\": \"2026-07-14T10:30:00Z\"\n },\n \"documents\": [\n {\n \"documentType\": \"cv\",\n \"label\": \"2024 CV\",\n \"currentVersion\": 2,\n \"versions\": [\n {\n \"version\": 1,\n \"url\": \"https://files.example/zoe-cv-v1.pdf\",\n \"fileName\": \"zoe-cv-v1.pdf\",\n \"contentType\": \"application/pdf\",\n \"sizeBytes\": 184320,\n \"uploadedAt\": \"2026-01-10T09:00:00Z\",\n \"checksum\": \"sha256:9f2b1c7a4e5d6f8091a2b3c4d5e6f708\",\n \"uploadedByExternalId\": \"wn-1004\"\n },\n {\n \"version\": 2,\n \"url\": \"https://files.example/zoe-cv-v2.pdf\",\n \"fileName\": \"zoe-cv-v2.pdf\",\n \"contentType\": \"application/pdf\",\n \"sizeBytes\": 201728,\n \"uploadedAt\": \"2026-06-02T09:00:00Z\",\n \"checksum\": \"sha256:4c1a2b3d4e5f60718293a4b5c6d7e8f9\",\n \"uploadedByExternalId\": \"wn-1004\"\n }\n ]\n },\n {\n \"documentType\": \"identity_document\",\n \"label\": \"Ghana Passport\",\n \"currentVersion\": 1,\n \"versions\": [\n {\n \"version\": 1,\n \"url\": \"https://files.example/zoe-passport.pdf\",\n \"fileName\": \"zoe-passport.pdf\",\n \"contentType\": \"application/pdf\",\n \"sizeBytes\": 512000,\n \"uploadedAt\": \"2026-01-10T09:00:00Z\",\n \"checksum\": \"sha256:aa11bb22cc33dd44ee55ff6677889900\",\n \"uploadedByExternalId\": \"wn-1004\"\n }\n ]\n }\n ],\n \"links\": [\n {\n \"type\": \"linkedin\",\n \"url\": \"https://www.linkedin.com/in/zoe-mensah\",\n \"label\": \"LinkedIn\"\n },\n {\n \"type\": \"portfolio\",\n \"url\": \"https://zoe-mensah.example/work\",\n \"label\": \"Project portfolio\"\n }\n ],\n \"media\": [\n {\n \"kind\": \"intro_video\",\n \"assetKey\": \"wn:media:vid_1004\",\n \"provider\": \"worknation\",\n \"contentType\": \"video/mp4\",\n \"fileName\": \"zoe-intro.mp4\",\n \"sizeBytes\": 4718592,\n \"durationSeconds\": 68,\n \"width\": 1280,\n \"height\": 720,\n \"caption\": \"60-second introduction\",\n \"uploadedAt\": \"2026-06-02T09:05:00Z\"\n },\n {\n \"kind\": \"profile_photo\",\n \"assetKey\": \"wn:media:img_1004\",\n \"provider\": \"worknation\",\n \"contentType\": \"image/jpeg\",\n \"fileName\": \"zoe-headshot.jpg\",\n \"sizeBytes\": 98304,\n \"width\": 800,\n \"height\": 800,\n \"caption\": \"Profile headshot\",\n \"uploadedAt\": \"2026-06-02T09:05:00Z\"\n },\n {\n \"kind\": \"portfolio_image\",\n \"url\": \"https://files.example/zoe-portfolio-1.jpg\",\n \"contentType\": \"image/jpeg\",\n \"fileName\": \"portfolio-1.jpg\",\n \"sizeBytes\": 245760,\n \"width\": 1600,\n \"height\": 1200,\n \"caption\": \"Completed pipework — Accra municipal project\",\n \"uploadedAt\": \"2026-05-30T14:00:00Z\"\n }\n ],\n \"assessments\": [\n {\n \"externalId\": \"kry-88f21\",\n \"provider\": \"kryterion\",\n \"name\": \"Plumbing Work-Readiness\",\n \"status\": \"completed\",\n \"outcome\": \"pass\",\n \"score\": 84,\n \"maxScore\": 100,\n \"scoreBand\": \"Proficient\",\n \"competencies\": [\n {\n \"code\": \"PLM-110\",\n \"label\": \"Pipe Fitting & Joining\",\n \"score\": 90\n },\n {\n \"code\": \"PLM-240\",\n \"label\": \"Water Systems Safety\",\n \"score\": 78\n }\n ],\n \"reportKey\": \"kry:report:88f21\",\n \"completedAt\": \"2026-05-18T13:15:00Z\",\n \"expiresAt\": \"2028-05-18T13:15:00Z\"\n },\n {\n \"externalId\": \"kry-90a12\",\n \"provider\": \"kryterion\",\n \"name\": \"Health & Safety Induction\",\n \"status\": \"completed\",\n \"outcome\": \"pass\",\n \"score\": 95,\n \"maxScore\": 100,\n \"scoreBand\": \"Distinction\",\n \"competencies\": [\n {\n \"code\": \"HS-100\",\n \"label\": \"Site Safety\",\n \"score\": 95\n }\n ],\n \"reportUrl\": \"https://files.example/zoe-hs-report.pdf\",\n \"completedAt\": \"2026-04-02T10:00:00Z\",\n \"expiresAt\": \"2027-04-02T10:00:00Z\"\n }\n ],\n \"consentGiven\": true,\n \"consents\": [\n {\n \"type\": \"data_processing\",\n \"granted\": true,\n \"grantedAt\": \"2026-01-10T08:55:00Z\",\n \"policyVersion\": \"2026-01\"\n },\n {\n \"type\": \"data_sharing_partners\",\n \"granted\": true,\n \"grantedAt\": \"2026-01-10T08:56:00Z\",\n \"policyVersion\": \"2026-01\"\n }\n ]\n}", "options": { "raw": { "language": "json" } } } }, "status": "Created", "code": 201, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"stagedId\": \"staged_01J9Z0...\",\n \"externalId\": \"sint dolore\",\n \"status\": \"dolor reprehenderit fugiat\",\n \"receivedAt\": \"1952-11-30T10:13:31.991Z\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "108f8185-130e-4f60-ad75-d538fc6b9eb1", "name": "Standard error envelope returned for 4xx/5xx.", "originalRequest": { "url": { "path": [ "v1", "candidates" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "X-API-Key", "value": "" }, { "key": "Accept", "value": "application/json" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"externalId\": \"wn-1004\",\n \"firstName\": \"Zoe\",\n \"middleName\": \"Ama\",\n \"preferredName\": \"Zoe\",\n \"lastName\": \"Mensah\",\n \"headline\": \"Senior plumber · 6 yrs municipal water infrastructure\",\n \"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.\",\n \"email\": \"zoe.mensah@example.com\",\n \"phone\": \"+233201234567\",\n \"dateOfBirth\": \"1996-04-21\",\n \"gender\": \"female\",\n \"nationality\": \"GH\",\n \"countryOfResidence\": \"GH\",\n \"address\": {\n \"line1\": \"12 Ring Road Central\",\n \"line2\": \"Apartment 4B\",\n \"city\": \"Accra\",\n \"region\": \"Greater Accra\",\n \"postalCode\": \"GA-123-4567\",\n \"country\": \"GH\"\n },\n \"skills\": [\n {\n \"name\": \"Plumbing\",\n \"yearsExperience\": 6,\n \"proficiency\": \"expert\",\n \"lastUsedYear\": 2026\n }\n ],\n \"workHistory\": [\n {\n \"employer\": \"Accra Waterworks\",\n \"jobTitle\": \"Senior Plumber\",\n \"employmentType\": \"full_time\",\n \"startDate\": \"2019-03-01\",\n \"endDate\": \"2026-06-30\",\n \"isCurrent\": false,\n \"location\": \"Accra, Ghana\",\n \"description\": \"Led a team of five on municipal water-infrastructure projects.\"\n }\n ],\n \"education\": [\n {\n \"institution\": \"Accra Technical University\",\n \"qualification\": \"HND Plumbing & Gas Engineering\",\n \"fieldOfStudy\": \"Plumbing Engineering\",\n \"completionStatus\": \"completed\",\n \"startDate\": \"2014-09-01\",\n \"endDate\": \"2017-06-30\",\n \"grade\": \"Distinction\"\n }\n ],\n \"languages\": [\n {\n \"language\": \"English\",\n \"proficiency\": \"fluent\"\n },\n {\n \"language\": \"Twi\",\n \"proficiency\": \"native\"\n }\n ],\n \"workEligibility\": [\n {\n \"country\": \"GB\",\n \"status\": \"requires_sponsorship\",\n \"visaType\": \"Skilled Worker\",\n \"expiresAt\": \"2028-12-31\"\n }\n ],\n \"jobPreferences\": {\n \"desiredTitles\": [\n \"Plumber\",\n \"Pipefitter\"\n ],\n \"employmentTypes\": [\n \"full_time\",\n \"contract\"\n ],\n \"preferredCountries\": [\n \"GB\",\n \"DE\"\n ],\n \"openToRelocation\": true,\n \"openToRemote\": false,\n \"salaryExpectation\": {\n \"currency\": \"GBP\",\n \"min\": 32000,\n \"max\": 45000,\n \"period\": \"annual\"\n }\n },\n \"referees\": [\n {\n \"name\": \"Kwame Asante\",\n \"relationship\": \"Former manager\",\n \"company\": \"Accra Waterworks\",\n \"email\": \"kwame.asante@example.com\",\n \"phone\": \"+233209876543\"\n }\n ],\n \"tags\": [\n \"trades\",\n \"relocation-ready\",\n \"verified\"\n ],\n \"source\": {\n \"provider\": \"worknation\",\n \"sourceChannel\": \"referral\",\n \"campaign\": \"gca-africa-2026\",\n \"submittedAt\": \"2026-07-14T10:30:00Z\"\n },\n \"documents\": [\n {\n \"documentType\": \"cv\",\n \"label\": \"2024 CV\",\n \"currentVersion\": 2,\n \"versions\": [\n {\n \"version\": 1,\n \"url\": \"https://files.example/zoe-cv-v1.pdf\",\n \"fileName\": \"zoe-cv-v1.pdf\",\n \"contentType\": \"application/pdf\",\n \"sizeBytes\": 184320,\n \"uploadedAt\": \"2026-01-10T09:00:00Z\",\n \"checksum\": \"sha256:9f2b1c7a4e5d6f8091a2b3c4d5e6f708\",\n \"uploadedByExternalId\": \"wn-1004\"\n },\n {\n \"version\": 2,\n \"url\": \"https://files.example/zoe-cv-v2.pdf\",\n \"fileName\": \"zoe-cv-v2.pdf\",\n \"contentType\": \"application/pdf\",\n \"sizeBytes\": 201728,\n \"uploadedAt\": \"2026-06-02T09:00:00Z\",\n \"checksum\": \"sha256:4c1a2b3d4e5f60718293a4b5c6d7e8f9\",\n \"uploadedByExternalId\": \"wn-1004\"\n }\n ]\n },\n {\n \"documentType\": \"identity_document\",\n \"label\": \"Ghana Passport\",\n \"currentVersion\": 1,\n \"versions\": [\n {\n \"version\": 1,\n \"url\": \"https://files.example/zoe-passport.pdf\",\n \"fileName\": \"zoe-passport.pdf\",\n \"contentType\": \"application/pdf\",\n \"sizeBytes\": 512000,\n \"uploadedAt\": \"2026-01-10T09:00:00Z\",\n \"checksum\": \"sha256:aa11bb22cc33dd44ee55ff6677889900\",\n \"uploadedByExternalId\": \"wn-1004\"\n }\n ]\n }\n ],\n \"links\": [\n {\n \"type\": \"linkedin\",\n \"url\": \"https://www.linkedin.com/in/zoe-mensah\",\n \"label\": \"LinkedIn\"\n },\n {\n \"type\": \"portfolio\",\n \"url\": \"https://zoe-mensah.example/work\",\n \"label\": \"Project portfolio\"\n }\n ],\n \"media\": [\n {\n \"kind\": \"intro_video\",\n \"assetKey\": \"wn:media:vid_1004\",\n \"provider\": \"worknation\",\n \"contentType\": \"video/mp4\",\n \"fileName\": \"zoe-intro.mp4\",\n \"sizeBytes\": 4718592,\n \"durationSeconds\": 68,\n \"width\": 1280,\n \"height\": 720,\n \"caption\": \"60-second introduction\",\n \"uploadedAt\": \"2026-06-02T09:05:00Z\"\n },\n {\n \"kind\": \"profile_photo\",\n \"assetKey\": \"wn:media:img_1004\",\n \"provider\": \"worknation\",\n \"contentType\": \"image/jpeg\",\n \"fileName\": \"zoe-headshot.jpg\",\n \"sizeBytes\": 98304,\n \"width\": 800,\n \"height\": 800,\n \"caption\": \"Profile headshot\",\n \"uploadedAt\": \"2026-06-02T09:05:00Z\"\n },\n {\n \"kind\": \"portfolio_image\",\n \"url\": \"https://files.example/zoe-portfolio-1.jpg\",\n \"contentType\": \"image/jpeg\",\n \"fileName\": \"portfolio-1.jpg\",\n \"sizeBytes\": 245760,\n \"width\": 1600,\n \"height\": 1200,\n \"caption\": \"Completed pipework — Accra municipal project\",\n \"uploadedAt\": \"2026-05-30T14:00:00Z\"\n }\n ],\n \"assessments\": [\n {\n \"externalId\": \"kry-88f21\",\n \"provider\": \"kryterion\",\n \"name\": \"Plumbing Work-Readiness\",\n \"status\": \"completed\",\n \"outcome\": \"pass\",\n \"score\": 84,\n \"maxScore\": 100,\n \"scoreBand\": \"Proficient\",\n \"competencies\": [\n {\n \"code\": \"PLM-110\",\n \"label\": \"Pipe Fitting & Joining\",\n \"score\": 90\n },\n {\n \"code\": \"PLM-240\",\n \"label\": \"Water Systems Safety\",\n \"score\": 78\n }\n ],\n \"reportKey\": \"kry:report:88f21\",\n \"completedAt\": \"2026-05-18T13:15:00Z\",\n \"expiresAt\": \"2028-05-18T13:15:00Z\"\n },\n {\n \"externalId\": \"kry-90a12\",\n \"provider\": \"kryterion\",\n \"name\": \"Health & Safety Induction\",\n \"status\": \"completed\",\n \"outcome\": \"pass\",\n \"score\": 95,\n \"maxScore\": 100,\n \"scoreBand\": \"Distinction\",\n \"competencies\": [\n {\n \"code\": \"HS-100\",\n \"label\": \"Site Safety\",\n \"score\": 95\n }\n ],\n \"reportUrl\": \"https://files.example/zoe-hs-report.pdf\",\n \"completedAt\": \"2026-04-02T10:00:00Z\",\n \"expiresAt\": \"2027-04-02T10:00:00Z\"\n }\n ],\n \"consentGiven\": true,\n \"consents\": [\n {\n \"type\": \"data_processing\",\n \"granted\": true,\n \"grantedAt\": \"2026-01-10T08:55:00Z\",\n \"policyVersion\": \"2026-01\"\n },\n {\n \"type\": \"data_sharing_partners\",\n \"granted\": true,\n \"grantedAt\": \"2026-01-10T08:56:00Z\",\n \"policyVersion\": \"2026-01\"\n }\n ]\n}", "options": { "raw": { "language": "json" } } } }, "status": "Bad Request", "code": 400, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"error\": \"unauthorized\",\n \"message\": \"ex non\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "bdf3f91b-24cf-4f8f-9ea8-4754a46aa1fe", "name": "Standard error envelope returned for 4xx/5xx.", "originalRequest": { "url": { "path": [ "v1", "candidates" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "X-API-Key", "value": "" }, { "key": "Accept", "value": "application/json" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"externalId\": \"wn-1004\",\n \"firstName\": \"Zoe\",\n \"middleName\": \"Ama\",\n \"preferredName\": \"Zoe\",\n \"lastName\": \"Mensah\",\n \"headline\": \"Senior plumber · 6 yrs municipal water infrastructure\",\n \"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.\",\n \"email\": \"zoe.mensah@example.com\",\n \"phone\": \"+233201234567\",\n \"dateOfBirth\": \"1996-04-21\",\n \"gender\": \"female\",\n \"nationality\": \"GH\",\n \"countryOfResidence\": \"GH\",\n \"address\": {\n \"line1\": \"12 Ring Road Central\",\n \"line2\": \"Apartment 4B\",\n \"city\": \"Accra\",\n \"region\": \"Greater Accra\",\n \"postalCode\": \"GA-123-4567\",\n \"country\": \"GH\"\n },\n \"skills\": [\n {\n \"name\": \"Plumbing\",\n \"yearsExperience\": 6,\n \"proficiency\": \"expert\",\n \"lastUsedYear\": 2026\n }\n ],\n \"workHistory\": [\n {\n \"employer\": \"Accra Waterworks\",\n \"jobTitle\": \"Senior Plumber\",\n \"employmentType\": \"full_time\",\n \"startDate\": \"2019-03-01\",\n \"endDate\": \"2026-06-30\",\n \"isCurrent\": false,\n \"location\": \"Accra, Ghana\",\n \"description\": \"Led a team of five on municipal water-infrastructure projects.\"\n }\n ],\n \"education\": [\n {\n \"institution\": \"Accra Technical University\",\n \"qualification\": \"HND Plumbing & Gas Engineering\",\n \"fieldOfStudy\": \"Plumbing Engineering\",\n \"completionStatus\": \"completed\",\n \"startDate\": \"2014-09-01\",\n \"endDate\": \"2017-06-30\",\n \"grade\": \"Distinction\"\n }\n ],\n \"languages\": [\n {\n \"language\": \"English\",\n \"proficiency\": \"fluent\"\n },\n {\n \"language\": \"Twi\",\n \"proficiency\": \"native\"\n }\n ],\n \"workEligibility\": [\n {\n \"country\": \"GB\",\n \"status\": \"requires_sponsorship\",\n \"visaType\": \"Skilled Worker\",\n \"expiresAt\": \"2028-12-31\"\n }\n ],\n \"jobPreferences\": {\n \"desiredTitles\": [\n \"Plumber\",\n \"Pipefitter\"\n ],\n \"employmentTypes\": [\n \"full_time\",\n \"contract\"\n ],\n \"preferredCountries\": [\n \"GB\",\n \"DE\"\n ],\n \"openToRelocation\": true,\n \"openToRemote\": false,\n \"salaryExpectation\": {\n \"currency\": \"GBP\",\n \"min\": 32000,\n \"max\": 45000,\n \"period\": \"annual\"\n }\n },\n \"referees\": [\n {\n \"name\": \"Kwame Asante\",\n \"relationship\": \"Former manager\",\n \"company\": \"Accra Waterworks\",\n \"email\": \"kwame.asante@example.com\",\n \"phone\": \"+233209876543\"\n }\n ],\n \"tags\": [\n \"trades\",\n \"relocation-ready\",\n \"verified\"\n ],\n \"source\": {\n \"provider\": \"worknation\",\n \"sourceChannel\": \"referral\",\n \"campaign\": \"gca-africa-2026\",\n \"submittedAt\": \"2026-07-14T10:30:00Z\"\n },\n \"documents\": [\n {\n \"documentType\": \"cv\",\n \"label\": \"2024 CV\",\n \"currentVersion\": 2,\n \"versions\": [\n {\n \"version\": 1,\n \"url\": \"https://files.example/zoe-cv-v1.pdf\",\n \"fileName\": \"zoe-cv-v1.pdf\",\n \"contentType\": \"application/pdf\",\n \"sizeBytes\": 184320,\n \"uploadedAt\": \"2026-01-10T09:00:00Z\",\n \"checksum\": \"sha256:9f2b1c7a4e5d6f8091a2b3c4d5e6f708\",\n \"uploadedByExternalId\": \"wn-1004\"\n },\n {\n \"version\": 2,\n \"url\": \"https://files.example/zoe-cv-v2.pdf\",\n \"fileName\": \"zoe-cv-v2.pdf\",\n \"contentType\": \"application/pdf\",\n \"sizeBytes\": 201728,\n \"uploadedAt\": \"2026-06-02T09:00:00Z\",\n \"checksum\": \"sha256:4c1a2b3d4e5f60718293a4b5c6d7e8f9\",\n \"uploadedByExternalId\": \"wn-1004\"\n }\n ]\n },\n {\n \"documentType\": \"identity_document\",\n \"label\": \"Ghana Passport\",\n \"currentVersion\": 1,\n \"versions\": [\n {\n \"version\": 1,\n \"url\": \"https://files.example/zoe-passport.pdf\",\n \"fileName\": \"zoe-passport.pdf\",\n \"contentType\": \"application/pdf\",\n \"sizeBytes\": 512000,\n \"uploadedAt\": \"2026-01-10T09:00:00Z\",\n \"checksum\": \"sha256:aa11bb22cc33dd44ee55ff6677889900\",\n \"uploadedByExternalId\": \"wn-1004\"\n }\n ]\n }\n ],\n \"links\": [\n {\n \"type\": \"linkedin\",\n \"url\": \"https://www.linkedin.com/in/zoe-mensah\",\n \"label\": \"LinkedIn\"\n },\n {\n \"type\": \"portfolio\",\n \"url\": \"https://zoe-mensah.example/work\",\n \"label\": \"Project portfolio\"\n }\n ],\n \"media\": [\n {\n \"kind\": \"intro_video\",\n \"assetKey\": \"wn:media:vid_1004\",\n \"provider\": \"worknation\",\n \"contentType\": \"video/mp4\",\n \"fileName\": \"zoe-intro.mp4\",\n \"sizeBytes\": 4718592,\n \"durationSeconds\": 68,\n \"width\": 1280,\n \"height\": 720,\n \"caption\": \"60-second introduction\",\n \"uploadedAt\": \"2026-06-02T09:05:00Z\"\n },\n {\n \"kind\": \"profile_photo\",\n \"assetKey\": \"wn:media:img_1004\",\n \"provider\": \"worknation\",\n \"contentType\": \"image/jpeg\",\n \"fileName\": \"zoe-headshot.jpg\",\n \"sizeBytes\": 98304,\n \"width\": 800,\n \"height\": 800,\n \"caption\": \"Profile headshot\",\n \"uploadedAt\": \"2026-06-02T09:05:00Z\"\n },\n {\n \"kind\": \"portfolio_image\",\n \"url\": \"https://files.example/zoe-portfolio-1.jpg\",\n \"contentType\": \"image/jpeg\",\n \"fileName\": \"portfolio-1.jpg\",\n \"sizeBytes\": 245760,\n \"width\": 1600,\n \"height\": 1200,\n \"caption\": \"Completed pipework — Accra municipal project\",\n \"uploadedAt\": \"2026-05-30T14:00:00Z\"\n }\n ],\n \"assessments\": [\n {\n \"externalId\": \"kry-88f21\",\n \"provider\": \"kryterion\",\n \"name\": \"Plumbing Work-Readiness\",\n \"status\": \"completed\",\n \"outcome\": \"pass\",\n \"score\": 84,\n \"maxScore\": 100,\n \"scoreBand\": \"Proficient\",\n \"competencies\": [\n {\n \"code\": \"PLM-110\",\n \"label\": \"Pipe Fitting & Joining\",\n \"score\": 90\n },\n {\n \"code\": \"PLM-240\",\n \"label\": \"Water Systems Safety\",\n \"score\": 78\n }\n ],\n \"reportKey\": \"kry:report:88f21\",\n \"completedAt\": \"2026-05-18T13:15:00Z\",\n \"expiresAt\": \"2028-05-18T13:15:00Z\"\n },\n {\n \"externalId\": \"kry-90a12\",\n \"provider\": \"kryterion\",\n \"name\": \"Health & Safety Induction\",\n \"status\": \"completed\",\n \"outcome\": \"pass\",\n \"score\": 95,\n \"maxScore\": 100,\n \"scoreBand\": \"Distinction\",\n \"competencies\": [\n {\n \"code\": \"HS-100\",\n \"label\": \"Site Safety\",\n \"score\": 95\n }\n ],\n \"reportUrl\": \"https://files.example/zoe-hs-report.pdf\",\n \"completedAt\": \"2026-04-02T10:00:00Z\",\n \"expiresAt\": \"2027-04-02T10:00:00Z\"\n }\n ],\n \"consentGiven\": true,\n \"consents\": [\n {\n \"type\": \"data_processing\",\n \"granted\": true,\n \"grantedAt\": \"2026-01-10T08:55:00Z\",\n \"policyVersion\": \"2026-01\"\n },\n {\n \"type\": \"data_sharing_partners\",\n \"granted\": true,\n \"grantedAt\": \"2026-01-10T08:56:00Z\",\n \"policyVersion\": \"2026-01\"\n }\n ]\n}", "options": { "raw": { "language": "json" } } } }, "status": "Unauthorized", "code": 401, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"error\": \"unauthorized\",\n \"message\": \"ex non\"\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } }, { "id": "983b7187-6f8d-4eed-a36f-5ea034319ff4", "name": "Find a candidate by your externalId", "request": { "name": "Find a candidate by your externalId", "description": { "content": "Resolve the candidate you created (within your org) from the externalId you supplied on POST — useful for idempotent retries or if you no longer have our id.", "type": "text/plain" }, "url": { "path": [ "v1", "candidates" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "key": "externalId", "value": "in id mollit officia", "description": "(Required) " } ], "variable": [] }, "header": [ { "key": "Accept", "value": "application/json" } ], "method": "GET", "auth": null }, "response": [ { "id": "95cf1c3d-4382-4b4a-a740-890af360764a", "name": "The recruiter/partner-safe projection. Excludes PII/sensitive data: email, phone, date of birth, gender, full address, referees, and sensitive document types (identity_document, right_to_work, police_clearance, medical_certificate).", "originalRequest": { "url": { "path": [ "v1", "candidates" ], "host": [ "{{baseUrl}}" ], "query": [ { "key": "externalId", "value": "in id mollit officia" } ], "variable": [] }, "header": [ { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "X-API-Key", "value": "" }, { "key": "Accept", "value": "application/json" } ], "method": "GET", "body": {} }, "status": "OK", "code": 200, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"id\": \"laboris qui\",\n \"externalId\": \"do sint\",\n \"firstName\": \"dolor non e\",\n \"lastName\": \"enim amet officia in Duis\",\n \"countryOfResidence\": \"NG\",\n \"skills\": [\n {\n \"name\": \"Welding\",\n \"yearsExperience\": 4,\n \"proficiency\": \"expert\",\n \"lastUsedYear\": 2051\n },\n {\n \"name\": \"Welding\",\n \"yearsExperience\": 4,\n \"proficiency\": \"advanced\",\n \"lastUsedYear\": 1968\n }\n ],\n \"status\": \"verified\",\n \"workReadinessScore\": null,\n \"updatedAt\": \"1948-03-24T13:03:03.106Z\",\n \"middleName\": null,\n \"preferredName\": null,\n \"headline\": null,\n \"summary\": null,\n \"nationality\": \"NG\",\n \"availabilityStatus\": \"pending\",\n \"verificationStatus\": \"in_review\",\n \"jobPreferences\": {\n \"openToRelocation\": null,\n \"openToRemote\": null,\n \"salaryExpectation\": {\n \"currency\": \"PCH\",\n \"min\": null,\n \"max\": null,\n \"period\": \"annual\"\n }\n },\n \"workHistory\": [\n {\n \"employer\": \"esse aute dolor dolore\",\n \"jobTitle\": \"eiusmod dolor\",\n \"startDate\": \"1996-04-21\",\n \"employmentType\": \"internship\",\n \"endDate\": null,\n \"isCurrent\": false,\n \"location\": null,\n \"description\": null\n },\n {\n \"employer\": \"in adipisicing voluptate\",\n \"jobTitle\": \"non velit elit\",\n \"startDate\": \"1996-04-21\",\n \"employmentType\": \"temporary\",\n \"endDate\": null,\n \"isCurrent\": false,\n \"location\": null,\n \"description\": null\n }\n ],\n \"education\": [\n {\n \"institution\": \"elit ullamco\",\n \"qualification\": null,\n \"fieldOfStudy\": null,\n \"completionStatus\": \"incomplete\",\n \"startDate\": null,\n \"endDate\": null,\n \"grade\": null\n },\n {\n \"institution\": \"pariatur aliqua ad veniam id\",\n \"qualification\": null,\n \"fieldOfStudy\": null,\n \"completionStatus\": \"completed\",\n \"startDate\": null,\n \"endDate\": null,\n \"grade\": null\n }\n ],\n \"languages\": [\n {\n \"language\": \"English\",\n \"proficiency\": \"professional\"\n },\n {\n \"language\": \"English\",\n \"proficiency\": \"professional\"\n }\n ],\n \"workEligibility\": [\n {\n \"country\": \"NG\",\n \"status\": \"citizen\",\n \"visaType\": null,\n \"expiresAt\": null\n },\n {\n \"country\": \"NG\",\n \"status\": \"requires_sponsorship\",\n \"visaType\": null,\n \"expiresAt\": null\n }\n ],\n \"tags\": [\n \"veniam laborum\",\n \"do\"\n ],\n \"documents\": [\n {\n \"documentType\": \"resume_supplement\",\n \"currentVersion\": 64484480,\n \"versions\": [\n {\n \"version\": 99582082,\n \"url\": \"http://xERObpdCPmEWbbYiUgAftNMxuogZO.vsY8htj+5rmuh8zn5Dw1OXA\",\n \"uploadedAt\": \"1981-06-25T05:16:48.520Z\",\n \"fileName\": null,\n \"contentType\": null,\n \"sizeBytes\": null,\n \"checksum\": null,\n \"uploadedByExternalId\": null\n }\n ],\n \"label\": null\n },\n {\n \"documentType\": \"work_sample\",\n \"currentVersion\": 62092812,\n \"versions\": [\n {\n \"version\": 15354592,\n \"url\": \"http://QELyonwwtGSCDLyGkECBrBk.yrEsNvg,wyycXiSE.pIGXY,M1Yz2zeoH.ilYH,GwWzM.\",\n \"uploadedAt\": \"2002-09-18T17:15:09.830Z\",\n \"fileName\": null,\n \"contentType\": null,\n \"sizeBytes\": null,\n \"checksum\": null,\n \"uploadedByExternalId\": null\n }\n ],\n \"label\": null\n }\n ],\n \"links\": [\n {\n \"type\": \"linkedin\",\n \"url\": \"https://www.linkedin.com/in/amaka-obi\",\n \"label\": null\n },\n {\n \"type\": \"website\",\n \"url\": \"https://www.linkedin.com/in/amaka-obi\",\n \"label\": null\n }\n ],\n \"media\": [\n {\n \"kind\": \"intro_video\",\n \"assetKey\": null,\n \"provider\": \"worknation\",\n \"url\": null,\n \"contentType\": null,\n \"fileName\": null,\n \"sizeBytes\": null,\n \"durationSeconds\": null,\n \"width\": null,\n \"height\": null,\n \"caption\": null,\n \"uploadedAt\": null\n },\n {\n \"kind\": \"audio\",\n \"assetKey\": null,\n \"provider\": \"worknation\",\n \"url\": null,\n \"contentType\": null,\n \"fileName\": null,\n \"sizeBytes\": null,\n \"durationSeconds\": null,\n \"width\": null,\n \"height\": null,\n \"caption\": null,\n \"uploadedAt\": null\n }\n ],\n \"assessments\": [\n {\n \"provider\": \"worknation\",\n \"name\": \"Welding Work-Readiness\",\n \"status\": \"scheduled\",\n \"externalId\": null,\n \"outcome\": \"inconclusive\",\n \"score\": null,\n \"maxScore\": null,\n \"scoreBand\": null,\n \"reportKey\": null,\n \"reportUrl\": null,\n \"completedAt\": null,\n \"expiresAt\": null\n },\n {\n \"provider\": \"worknation\",\n \"name\": \"Welding Work-Readiness\",\n \"status\": \"expired\",\n \"externalId\": null,\n \"outcome\": \"fail\",\n \"score\": null,\n \"maxScore\": null,\n \"scoreBand\": null,\n \"reportKey\": null,\n \"reportUrl\": null,\n \"completedAt\": null,\n \"expiresAt\": null\n }\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "ea15b639-a30d-49a4-8a93-c77ee0914c8e", "name": "Standard error envelope returned for 4xx/5xx.", "originalRequest": { "url": { "path": [ "v1", "candidates" ], "host": [ "{{baseUrl}}" ], "query": [ { "key": "externalId", "value": "in id mollit officia" } ], "variable": [] }, "header": [ { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "X-API-Key", "value": "" }, { "key": "Accept", "value": "application/json" } ], "method": "GET", "body": {} }, "status": "Bad Request", "code": 400, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"error\": \"unauthorized\",\n \"message\": \"ex non\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "2632e4d1-06cb-4a55-9b43-f2643dd3c385", "name": "Standard error envelope returned for 4xx/5xx.", "originalRequest": { "url": { "path": [ "v1", "candidates" ], "host": [ "{{baseUrl}}" ], "query": [ { "key": "externalId", "value": "in id mollit officia" } ], "variable": [] }, "header": [ { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "X-API-Key", "value": "" }, { "key": "Accept", "value": "application/json" } ], "method": "GET", "body": {} }, "status": "Unauthorized", "code": 401, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"error\": \"unauthorized\",\n \"message\": \"ex non\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "cbadef10-5fa4-4620-9c56-dc5039cb2818", "name": "Standard error envelope returned for 4xx/5xx.", "originalRequest": { "url": { "path": [ "v1", "candidates" ], "host": [ "{{baseUrl}}" ], "query": [ { "key": "externalId", "value": "in id mollit officia" } ], "variable": [] }, "header": [ { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "X-API-Key", "value": "" }, { "key": "Accept", "value": "application/json" } ], "method": "GET", "body": {} }, "status": "Not Found", "code": 404, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"error\": \"unauthorized\",\n \"message\": \"ex non\"\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } }, { "id": "3958b81a-631e-4932-ae19-9068bb75ddea", "name": "Fetch a candidate record", "request": { "name": "Fetch a candidate record", "description": { "content": "Accepts either the stagedId from POST or the canonical candidate id — both resolve to the same record through promotion.", "type": "text/plain" }, "url": { "path": [ "v1", "candidates", ":id" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "type": "any", "value": "deserunt cupidatat culpa", "key": "id", "description": "(Required) " } ] }, "header": [ { "key": "Accept", "value": "application/json" } ], "method": "GET", "auth": null }, "response": [ { "id": "e0db718d-e26e-44ae-bd25-847a283d749c", "name": "The recruiter/partner-safe projection. Excludes PII/sensitive data: email, phone, date of birth, gender, full address, referees, and sensitive document types (identity_document, right_to_work, police_clearance, medical_certificate).", "originalRequest": { "url": { "path": [ "v1", "candidates", ":id" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "type": "any", "value": "deserunt cupidatat culpa", "key": "id", "description": "(Required) " } ] }, "header": [ { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "X-API-Key", "value": "" }, { "key": "Accept", "value": "application/json" } ], "method": "GET", "body": {} }, "status": "OK", "code": 200, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"id\": \"cand_01J9Z0ABCXYZ\",\n \"externalId\": \"wn-1004\",\n \"firstName\": \"Zoe\",\n \"middleName\": \"Ama\",\n \"preferredName\": \"Zoe\",\n \"lastName\": \"Mensah\",\n \"headline\": \"Senior plumber · 6 yrs municipal water infrastructure\",\n \"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.\",\n \"nationality\": \"GH\",\n \"countryOfResidence\": \"GH\",\n \"skills\": [\n {\n \"name\": \"Plumbing\",\n \"yearsExperience\": 6,\n \"proficiency\": \"expert\",\n \"lastUsedYear\": 2026\n }\n ],\n \"workHistory\": [\n {\n \"employer\": \"Accra Waterworks\",\n \"jobTitle\": \"Senior Plumber\",\n \"employmentType\": \"full_time\",\n \"startDate\": \"2019-03-01\",\n \"endDate\": \"2026-06-30\",\n \"isCurrent\": false,\n \"location\": \"Accra, Ghana\",\n \"description\": \"Led a team of five on municipal water-infrastructure projects.\"\n }\n ],\n \"education\": [\n {\n \"institution\": \"Accra Technical University\",\n \"qualification\": \"HND Plumbing & Gas Engineering\",\n \"fieldOfStudy\": \"Plumbing Engineering\",\n \"completionStatus\": \"completed\",\n \"startDate\": \"2014-09-01\",\n \"endDate\": \"2017-06-30\",\n \"grade\": \"Distinction\"\n }\n ],\n \"languages\": [\n {\n \"language\": \"English\",\n \"proficiency\": \"fluent\"\n },\n {\n \"language\": \"Twi\",\n \"proficiency\": \"native\"\n }\n ],\n \"workEligibility\": [\n {\n \"country\": \"GB\",\n \"status\": \"requires_sponsorship\",\n \"visaType\": \"Skilled Worker\",\n \"expiresAt\": \"2028-12-31\"\n }\n ],\n \"jobPreferences\": {\n \"desiredTitles\": [\n \"Plumber\",\n \"Pipefitter\"\n ],\n \"employmentTypes\": [\n \"full_time\",\n \"contract\"\n ],\n \"preferredCountries\": [\n \"GB\",\n \"DE\"\n ],\n \"openToRelocation\": true,\n \"openToRemote\": false,\n \"salaryExpectation\": {\n \"currency\": \"GBP\",\n \"min\": 32000,\n \"max\": 45000,\n \"period\": \"annual\"\n }\n },\n \"tags\": [\n \"trades\",\n \"relocation-ready\",\n \"verified\"\n ],\n \"documents\": [\n {\n \"documentType\": \"cv\",\n \"label\": \"2024 CV\",\n \"currentVersion\": 2,\n \"versions\": [\n {\n \"version\": 1,\n \"url\": \"https://files.example/zoe-cv-v1.pdf\",\n \"fileName\": \"zoe-cv-v1.pdf\",\n \"contentType\": \"application/pdf\",\n \"sizeBytes\": 184320,\n \"uploadedAt\": \"2026-01-10T09:00:00Z\",\n \"checksum\": \"sha256:9f2b1c7a4e5d6f8091a2b3c4d5e6f708\",\n \"uploadedByExternalId\": \"wn-1004\"\n },\n {\n \"version\": 2,\n \"url\": \"https://files.example/zoe-cv-v2.pdf\",\n \"fileName\": \"zoe-cv-v2.pdf\",\n \"contentType\": \"application/pdf\",\n \"sizeBytes\": 201728,\n \"uploadedAt\": \"2026-06-02T09:00:00Z\",\n \"checksum\": \"sha256:4c1a2b3d4e5f60718293a4b5c6d7e8f9\",\n \"uploadedByExternalId\": \"wn-1004\"\n }\n ]\n }\n ],\n \"links\": [\n {\n \"type\": \"linkedin\",\n \"url\": \"https://www.linkedin.com/in/zoe-mensah\",\n \"label\": \"LinkedIn\"\n },\n {\n \"type\": \"portfolio\",\n \"url\": \"https://zoe-mensah.example/work\",\n \"label\": \"Project portfolio\"\n }\n ],\n \"media\": [\n {\n \"kind\": \"intro_video\",\n \"assetKey\": \"wn:media:vid_1004\",\n \"provider\": \"worknation\",\n \"contentType\": \"video/mp4\",\n \"fileName\": \"zoe-intro.mp4\",\n \"sizeBytes\": 4718592,\n \"durationSeconds\": 68,\n \"width\": 1280,\n \"height\": 720,\n \"caption\": \"60-second introduction\",\n \"uploadedAt\": \"2026-06-02T09:05:00Z\"\n },\n {\n \"kind\": \"profile_photo\",\n \"assetKey\": \"wn:media:img_1004\",\n \"provider\": \"worknation\",\n \"contentType\": \"image/jpeg\",\n \"fileName\": \"zoe-headshot.jpg\",\n \"sizeBytes\": 98304,\n \"width\": 800,\n \"height\": 800,\n \"caption\": \"Profile headshot\",\n \"uploadedAt\": \"2026-06-02T09:05:00Z\"\n },\n {\n \"kind\": \"portfolio_image\",\n \"url\": \"https://files.example/zoe-portfolio-1.jpg\",\n \"contentType\": \"image/jpeg\",\n \"fileName\": \"portfolio-1.jpg\",\n \"sizeBytes\": 245760,\n \"width\": 1600,\n \"height\": 1200,\n \"caption\": \"Completed pipework — Accra municipal project\",\n \"uploadedAt\": \"2026-05-30T14:00:00Z\"\n }\n ],\n \"assessments\": [\n {\n \"externalId\": \"kry-88f21\",\n \"provider\": \"kryterion\",\n \"name\": \"Plumbing Work-Readiness\",\n \"status\": \"completed\",\n \"outcome\": \"pass\",\n \"score\": 84,\n \"maxScore\": 100,\n \"scoreBand\": \"Proficient\",\n \"competencies\": [\n {\n \"code\": \"PLM-110\",\n \"label\": \"Pipe Fitting & Joining\",\n \"score\": 90\n },\n {\n \"code\": \"PLM-240\",\n \"label\": \"Water Systems Safety\",\n \"score\": 78\n }\n ],\n \"reportKey\": \"kry:report:88f21\",\n \"completedAt\": \"2026-05-18T13:15:00Z\",\n \"expiresAt\": \"2028-05-18T13:15:00Z\"\n },\n {\n \"externalId\": \"kry-90a12\",\n \"provider\": \"kryterion\",\n \"name\": \"Health & Safety Induction\",\n \"status\": \"completed\",\n \"outcome\": \"pass\",\n \"score\": 95,\n \"maxScore\": 100,\n \"scoreBand\": \"Distinction\",\n \"competencies\": [\n {\n \"code\": \"HS-100\",\n \"label\": \"Site Safety\",\n \"score\": 95\n }\n ],\n \"reportUrl\": \"https://files.example/zoe-hs-report.pdf\",\n \"completedAt\": \"2026-04-02T10:00:00Z\",\n \"expiresAt\": \"2027-04-02T10:00:00Z\"\n }\n ],\n \"status\": \"promoted\",\n \"availabilityStatus\": \"available\",\n \"verificationStatus\": \"verified\",\n \"workReadinessScore\": 82,\n \"updatedAt\": \"2026-07-15T09:00:00Z\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "fc9e5b3b-902e-47be-87e6-21e43534ff88", "name": "Standard error envelope returned for 4xx/5xx.", "originalRequest": { "url": { "path": [ "v1", "candidates", ":id" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "type": "any", "value": "deserunt cupidatat culpa", "key": "id", "description": "(Required) " } ] }, "header": [ { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "X-API-Key", "value": "" }, { "key": "Accept", "value": "application/json" } ], "method": "GET", "body": {} }, "status": "Unauthorized", "code": 401, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"error\": \"unauthorized\",\n \"message\": \"ex non\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "25e0f631-bcc6-446b-a9f7-dd81dd3bac25", "name": "Standard error envelope returned for 4xx/5xx.", "originalRequest": { "url": { "path": [ "v1", "candidates", ":id" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "type": "any", "value": "deserunt cupidatat culpa", "key": "id", "description": "(Required) " } ] }, "header": [ { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "X-API-Key", "value": "" }, { "key": "Accept", "value": "application/json" } ], "method": "GET", "body": {} }, "status": "Not Found", "code": 404, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"error\": \"unauthorized\",\n \"message\": \"ex non\"\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } }, { "id": "309e5032-e007-40b5-9bf1-6d4d0eb2ab7e", "name": "Amend limited candidate fields", "request": { "name": "Amend limited candidate fields", "description": {}, "url": { "path": [ "v1", "candidates", ":id" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "type": "any", "value": "deserunt cupidatat culpa", "key": "id", "description": "(Required) " } ] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" } ], "method": "PUT", "auth": null, "body": { "mode": "raw", "raw": "{\n \"firstName\": \"Lorem ea non in\",\n \"middleName\": \"Duis laboris fugiat dolor\",\n \"preferredName\": \"dolore Lorem officia\",\n \"lastName\": \"exercitati\",\n \"headline\": \"incididunt magna eiusmod\",\n \"summary\": \"voluptate cupidatat ipsum\",\n \"phone\": \"sit minim occaecat\",\n \"consentGiven\": false,\n \"address\": {\n \"country\": \"NG\",\n \"line1\": \"Lorem do Excepteur\",\n \"line2\": \"et occaecat\",\n \"city\": \"Ut do reprehenderit sunt c\",\n \"region\": \"eiusmod incididunt anim\",\n \"postalCode\": \"quis ad\"\n },\n \"jobPreferences\": {\n \"openToRelocation\": false,\n \"openToRemote\": true,\n \"salaryExpectation\": {\n \"currency\": \"XRE\",\n \"min\": 80949699.90583672,\n \"max\": 63739598.890022874,\n \"period\": \"annual\"\n }\n },\n \"skills\": [\n {\n \"name\": \"Welding\",\n \"yearsExperience\": 4,\n \"proficiency\": \"expert\",\n \"lastUsedYear\": 1988\n },\n {\n \"name\": \"Welding\",\n \"yearsExperience\": 4,\n \"proficiency\": \"expert\",\n \"lastUsedYear\": 2045\n }\n ],\n \"workHistory\": [\n {\n \"employer\": \"Lorem in\",\n \"jobTitle\": \"commodo quis in cupidatat voluptate\",\n \"startDate\": \"1996-04-21\",\n \"employmentType\": \"contract\",\n \"endDate\": \"1992-04-19\",\n \"isCurrent\": false,\n \"location\": \"sed cillum laborum culpa\",\n \"description\": \"labore adipisicing in deserunt\"\n },\n {\n \"employer\": \"aliquip occaecat sint quis culpa\",\n \"jobTitle\": \"qu\",\n \"startDate\": \"1996-04-21\",\n \"employmentType\": \"volunteer\",\n \"endDate\": \"1953-10-13\",\n \"isCurrent\": false,\n \"location\": \"sit consectetur est\",\n \"description\": \"ea ullamco sunt\"\n }\n ],\n \"education\": [\n {\n \"institution\": \"exercitation officia ex \",\n \"qualification\": \"aliquip anim qui sunt\",\n \"fieldOfStudy\": \"nostru\",\n \"completionStatus\": \"completed\",\n \"startDate\": \"1958-03-31\",\n \"endDate\": \"1953-11-10\",\n \"grade\": \"eu labo\"\n },\n {\n \"institution\": \"consectetur est velit et\",\n \"qualification\": \"deserunt\",\n \"fieldOfStudy\": \"anim consectetur adipisicing ipsum ea\",\n \"completionStatus\": \"completed\",\n \"startDate\": \"1947-08-28\",\n \"endDate\": \"1960-02-01\",\n \"grade\": \"aliqua\"\n }\n ],\n \"languages\": [\n {\n \"language\": \"English\",\n \"proficiency\": \"basic\"\n },\n {\n \"language\": \"English\",\n \"proficiency\": \"fluent\"\n }\n ],\n \"workEligibility\": [\n {\n \"country\": \"NG\",\n \"status\": \"not_eligible\",\n \"visaType\": \"ipsum\",\n \"expiresAt\": \"1950-12-04\"\n },\n {\n \"country\": \"NG\",\n \"status\": \"not_eligible\",\n \"visaType\": \"non qui dolore\",\n \"expiresAt\": \"1949-02-17\"\n }\n ],\n \"documents\": [\n {\n \"documentType\": \"resume_supplement\",\n \"currentVersion\": 9338642,\n \"versions\": [\n {\n \"version\": 70912723,\n \"url\": \"https://DkRpDixYNhdoUYRusIBkUQITcjpg.lduG3y9BlveVxo6OZl8hHQOA9c1fyHS\",\n \"uploadedAt\": \"1986-09-04T21:18:12.270Z\",\n \"fileName\": \"ipsum offici\",\n \"contentType\": \"laboris enim dolor tempor\",\n \"sizeBytes\": 357741979,\n \"checksum\": \"Lorem commodo\",\n \"uploadedByExternalId\": \"i\"\n }\n ],\n \"label\": \"2024 CV\"\n },\n {\n \"documentType\": \"academic_transcript\",\n \"currentVersion\": 55461147,\n \"versions\": [\n {\n \"version\": 15034801,\n \"url\": \"http://GTzyAGHCGtWMyWUJJdPFzvQMta.reGy2PKzFapKYJIjvmYhtgSZa5+RhMaF+-KG\",\n \"uploadedAt\": \"1972-04-13T07:46:57.983Z\",\n \"fileName\": \"velit Excepteur in esse\",\n \"contentType\": \"cupidatat officia consequat\",\n \"sizeBytes\": 351939839,\n \"checksum\": \"ut\",\n \"uploadedByExternalId\": \"magna\"\n }\n ],\n \"label\": \"2024 CV\"\n }\n ],\n \"links\": [\n {\n \"type\": \"github\",\n \"url\": \"https://www.linkedin.com/in/amaka-obi\",\n \"label\": \"LinkedIn\"\n },\n {\n \"type\": \"linkedin\",\n \"url\": \"https://www.linkedin.com/in/amaka-obi\",\n \"label\": \"LinkedIn\"\n }\n ],\n \"media\": [\n {\n \"kind\": \"profile_photo\",\n \"assetKey\": \"wn:media:vid_88213\",\n \"provider\": \"worknation\",\n \"url\": \"https://files.example/intro.mp4\",\n \"contentType\": \"video/mp4\",\n \"fileName\": \"intro.mp4\",\n \"sizeBytes\": 4718592,\n \"durationSeconds\": 68,\n \"width\": 1280,\n \"height\": 720,\n \"caption\": \"60-second introduction\",\n \"uploadedAt\": \"2026-06-02T09:05:00Z\"\n },\n {\n \"kind\": \"profile_photo\",\n \"assetKey\": \"wn:media:vid_88213\",\n \"provider\": \"worknation\",\n \"url\": \"https://files.example/intro.mp4\",\n \"contentType\": \"video/mp4\",\n \"fileName\": \"intro.mp4\",\n \"sizeBytes\": 4718592,\n \"durationSeconds\": 68,\n \"width\": 1280,\n \"height\": 720,\n \"caption\": \"60-second introduction\",\n \"uploadedAt\": \"2026-06-02T09:05:00Z\"\n }\n ],\n \"assessments\": [\n {\n \"provider\": \"worknation\",\n \"name\": \"Welding Work-Readiness\",\n \"status\": \"in_progress\",\n \"externalId\": \"kry-4f2a9\",\n \"outcome\": \"pass\",\n \"score\": 82,\n \"maxScore\": 100,\n \"scoreBand\": \"Proficient\",\n \"reportKey\": \"kry:report:88f21\",\n \"reportUrl\": \"https://files.example/report.pdf\",\n \"completedAt\": \"2026-05-18T13:15:00Z\",\n \"expiresAt\": \"2028-05-18T13:15:00Z\"\n },\n {\n \"provider\": \"worknation\",\n \"name\": \"Welding Work-Readiness\",\n \"status\": \"expired\",\n \"externalId\": \"kry-4f2a9\",\n \"outcome\": \"inconclusive\",\n \"score\": 82,\n \"maxScore\": 100,\n \"scoreBand\": \"Proficient\",\n \"reportKey\": \"kry:report:88f21\",\n \"reportUrl\": \"https://files.example/report.pdf\",\n \"completedAt\": \"2026-05-18T13:15:00Z\",\n \"expiresAt\": \"2028-05-18T13:15:00Z\"\n }\n ],\n \"consents\": [\n {\n \"type\": \"data_sharing_partners\",\n \"granted\": false,\n \"grantedAt\": \"1973-04-05T05:58:49.455Z\",\n \"policyVersion\": \"lab\"\n },\n {\n \"type\": \"marketing\",\n \"granted\": false,\n \"grantedAt\": \"1998-09-11T22:42:36.106Z\",\n \"policyVersion\": \"elit laborum dolore i\"\n }\n ]\n}", "options": { "raw": { "language": "json" } } } }, "response": [ { "id": "50f0f64e-134d-4187-80dd-c6e38ee55039", "name": "The recruiter/partner-safe projection. Excludes PII/sensitive data: email, phone, date of birth, gender, full address, referees, and sensitive document types (identity_document, right_to_work, police_clearance, medical_certificate).", "originalRequest": { "url": { "path": [ "v1", "candidates", ":id" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "type": "any", "value": "deserunt cupidatat culpa", "key": "id", "description": "(Required) " } ] }, "header": [ { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "X-API-Key", "value": "" }, { "key": "Accept", "value": "application/json" } ], "method": "PUT", "body": { "mode": "raw", "raw": "{\n \"firstName\": \"Lorem ea non in\",\n \"middleName\": \"Duis laboris fugiat dolor\",\n \"preferredName\": \"dolore Lorem officia\",\n \"lastName\": \"exercitati\",\n \"headline\": \"incididunt magna eiusmod\",\n \"summary\": \"voluptate cupidatat ipsum\",\n \"phone\": \"sit minim occaecat\",\n \"consentGiven\": false,\n \"address\": {\n \"country\": \"NG\",\n \"line1\": \"Lorem do Excepteur\",\n \"line2\": \"et occaecat\",\n \"city\": \"Ut do reprehenderit sunt c\",\n \"region\": \"eiusmod incididunt anim\",\n \"postalCode\": \"quis ad\"\n },\n \"jobPreferences\": {\n \"openToRelocation\": false,\n \"openToRemote\": true,\n \"salaryExpectation\": {\n \"currency\": \"XRE\",\n \"min\": 80949699.90583672,\n \"max\": 63739598.890022874,\n \"period\": \"annual\"\n }\n },\n \"skills\": [\n {\n \"name\": \"Welding\",\n \"yearsExperience\": 4,\n \"proficiency\": \"expert\",\n \"lastUsedYear\": 1988\n },\n {\n \"name\": \"Welding\",\n \"yearsExperience\": 4,\n \"proficiency\": \"expert\",\n \"lastUsedYear\": 2045\n }\n ],\n \"workHistory\": [\n {\n \"employer\": \"Lorem in\",\n \"jobTitle\": \"commodo quis in cupidatat voluptate\",\n \"startDate\": \"1996-04-21\",\n \"employmentType\": \"contract\",\n \"endDate\": \"1992-04-19\",\n \"isCurrent\": false,\n \"location\": \"sed cillum laborum culpa\",\n \"description\": \"labore adipisicing in deserunt\"\n },\n {\n \"employer\": \"aliquip occaecat sint quis culpa\",\n \"jobTitle\": \"qu\",\n \"startDate\": \"1996-04-21\",\n \"employmentType\": \"volunteer\",\n \"endDate\": \"1953-10-13\",\n \"isCurrent\": false,\n \"location\": \"sit consectetur est\",\n \"description\": \"ea ullamco sunt\"\n }\n ],\n \"education\": [\n {\n \"institution\": \"exercitation officia ex \",\n \"qualification\": \"aliquip anim qui sunt\",\n \"fieldOfStudy\": \"nostru\",\n \"completionStatus\": \"completed\",\n \"startDate\": \"1958-03-31\",\n \"endDate\": \"1953-11-10\",\n \"grade\": \"eu labo\"\n },\n {\n \"institution\": \"consectetur est velit et\",\n \"qualification\": \"deserunt\",\n \"fieldOfStudy\": \"anim consectetur adipisicing ipsum ea\",\n \"completionStatus\": \"completed\",\n \"startDate\": \"1947-08-28\",\n \"endDate\": \"1960-02-01\",\n \"grade\": \"aliqua\"\n }\n ],\n \"languages\": [\n {\n \"language\": \"English\",\n \"proficiency\": \"basic\"\n },\n {\n \"language\": \"English\",\n \"proficiency\": \"fluent\"\n }\n ],\n \"workEligibility\": [\n {\n \"country\": \"NG\",\n \"status\": \"not_eligible\",\n \"visaType\": \"ipsum\",\n \"expiresAt\": \"1950-12-04\"\n },\n {\n \"country\": \"NG\",\n \"status\": \"not_eligible\",\n \"visaType\": \"non qui dolore\",\n \"expiresAt\": \"1949-02-17\"\n }\n ],\n \"documents\": [\n {\n \"documentType\": \"resume_supplement\",\n \"currentVersion\": 9338642,\n \"versions\": [\n {\n \"version\": 70912723,\n \"url\": \"https://DkRpDixYNhdoUYRusIBkUQITcjpg.lduG3y9BlveVxo6OZl8hHQOA9c1fyHS\",\n \"uploadedAt\": \"1986-09-04T21:18:12.270Z\",\n \"fileName\": \"ipsum offici\",\n \"contentType\": \"laboris enim dolor tempor\",\n \"sizeBytes\": 357741979,\n \"checksum\": \"Lorem commodo\",\n \"uploadedByExternalId\": \"i\"\n }\n ],\n \"label\": \"2024 CV\"\n },\n {\n \"documentType\": \"academic_transcript\",\n \"currentVersion\": 55461147,\n \"versions\": [\n {\n \"version\": 15034801,\n \"url\": \"http://GTzyAGHCGtWMyWUJJdPFzvQMta.reGy2PKzFapKYJIjvmYhtgSZa5+RhMaF+-KG\",\n \"uploadedAt\": \"1972-04-13T07:46:57.983Z\",\n \"fileName\": \"velit Excepteur in esse\",\n \"contentType\": \"cupidatat officia consequat\",\n \"sizeBytes\": 351939839,\n \"checksum\": \"ut\",\n \"uploadedByExternalId\": \"magna\"\n }\n ],\n \"label\": \"2024 CV\"\n }\n ],\n \"links\": [\n {\n \"type\": \"github\",\n \"url\": \"https://www.linkedin.com/in/amaka-obi\",\n \"label\": \"LinkedIn\"\n },\n {\n \"type\": \"linkedin\",\n \"url\": \"https://www.linkedin.com/in/amaka-obi\",\n \"label\": \"LinkedIn\"\n }\n ],\n \"media\": [\n {\n \"kind\": \"profile_photo\",\n \"assetKey\": \"wn:media:vid_88213\",\n \"provider\": \"worknation\",\n \"url\": \"https://files.example/intro.mp4\",\n \"contentType\": \"video/mp4\",\n \"fileName\": \"intro.mp4\",\n \"sizeBytes\": 4718592,\n \"durationSeconds\": 68,\n \"width\": 1280,\n \"height\": 720,\n \"caption\": \"60-second introduction\",\n \"uploadedAt\": \"2026-06-02T09:05:00Z\"\n },\n {\n \"kind\": \"profile_photo\",\n \"assetKey\": \"wn:media:vid_88213\",\n \"provider\": \"worknation\",\n \"url\": \"https://files.example/intro.mp4\",\n \"contentType\": \"video/mp4\",\n \"fileName\": \"intro.mp4\",\n \"sizeBytes\": 4718592,\n \"durationSeconds\": 68,\n \"width\": 1280,\n \"height\": 720,\n \"caption\": \"60-second introduction\",\n \"uploadedAt\": \"2026-06-02T09:05:00Z\"\n }\n ],\n \"assessments\": [\n {\n \"provider\": \"worknation\",\n \"name\": \"Welding Work-Readiness\",\n \"status\": \"in_progress\",\n \"externalId\": \"kry-4f2a9\",\n \"outcome\": \"pass\",\n \"score\": 82,\n \"maxScore\": 100,\n \"scoreBand\": \"Proficient\",\n \"reportKey\": \"kry:report:88f21\",\n \"reportUrl\": \"https://files.example/report.pdf\",\n \"completedAt\": \"2026-05-18T13:15:00Z\",\n \"expiresAt\": \"2028-05-18T13:15:00Z\"\n },\n {\n \"provider\": \"worknation\",\n \"name\": \"Welding Work-Readiness\",\n \"status\": \"expired\",\n \"externalId\": \"kry-4f2a9\",\n \"outcome\": \"inconclusive\",\n \"score\": 82,\n \"maxScore\": 100,\n \"scoreBand\": \"Proficient\",\n \"reportKey\": \"kry:report:88f21\",\n \"reportUrl\": \"https://files.example/report.pdf\",\n \"completedAt\": \"2026-05-18T13:15:00Z\",\n \"expiresAt\": \"2028-05-18T13:15:00Z\"\n }\n ],\n \"consents\": [\n {\n \"type\": \"data_sharing_partners\",\n \"granted\": false,\n \"grantedAt\": \"1973-04-05T05:58:49.455Z\",\n \"policyVersion\": \"lab\"\n },\n {\n \"type\": \"marketing\",\n \"granted\": false,\n \"grantedAt\": \"1998-09-11T22:42:36.106Z\",\n \"policyVersion\": \"elit laborum dolore i\"\n }\n ]\n}", "options": { "raw": { "language": "json" } } } }, "status": "OK", "code": 200, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"id\": \"laboris qui\",\n \"externalId\": \"do sint\",\n \"firstName\": \"dolor non e\",\n \"lastName\": \"enim amet officia in Duis\",\n \"countryOfResidence\": \"NG\",\n \"skills\": [\n {\n \"name\": \"Welding\",\n \"yearsExperience\": 4,\n \"proficiency\": \"expert\",\n \"lastUsedYear\": 2051\n },\n {\n \"name\": \"Welding\",\n \"yearsExperience\": 4,\n \"proficiency\": \"advanced\",\n \"lastUsedYear\": 1968\n }\n ],\n \"status\": \"verified\",\n \"workReadinessScore\": null,\n \"updatedAt\": \"1948-03-24T13:03:03.106Z\",\n \"middleName\": null,\n \"preferredName\": null,\n \"headline\": null,\n \"summary\": null,\n \"nationality\": \"NG\",\n \"availabilityStatus\": \"pending\",\n \"verificationStatus\": \"in_review\",\n \"jobPreferences\": {\n \"openToRelocation\": null,\n \"openToRemote\": null,\n \"salaryExpectation\": {\n \"currency\": \"PCH\",\n \"min\": null,\n \"max\": null,\n \"period\": \"annual\"\n }\n },\n \"workHistory\": [\n {\n \"employer\": \"esse aute dolor dolore\",\n \"jobTitle\": \"eiusmod dolor\",\n \"startDate\": \"1996-04-21\",\n \"employmentType\": \"internship\",\n \"endDate\": null,\n \"isCurrent\": false,\n \"location\": null,\n \"description\": null\n },\n {\n \"employer\": \"in adipisicing voluptate\",\n \"jobTitle\": \"non velit elit\",\n \"startDate\": \"1996-04-21\",\n \"employmentType\": \"temporary\",\n \"endDate\": null,\n \"isCurrent\": false,\n \"location\": null,\n \"description\": null\n }\n ],\n \"education\": [\n {\n \"institution\": \"elit ullamco\",\n \"qualification\": null,\n \"fieldOfStudy\": null,\n \"completionStatus\": \"incomplete\",\n \"startDate\": null,\n \"endDate\": null,\n \"grade\": null\n },\n {\n \"institution\": \"pariatur aliqua ad veniam id\",\n \"qualification\": null,\n \"fieldOfStudy\": null,\n \"completionStatus\": \"completed\",\n \"startDate\": null,\n \"endDate\": null,\n \"grade\": null\n }\n ],\n \"languages\": [\n {\n \"language\": \"English\",\n \"proficiency\": \"professional\"\n },\n {\n \"language\": \"English\",\n \"proficiency\": \"professional\"\n }\n ],\n \"workEligibility\": [\n {\n \"country\": \"NG\",\n \"status\": \"citizen\",\n \"visaType\": null,\n \"expiresAt\": null\n },\n {\n \"country\": \"NG\",\n \"status\": \"requires_sponsorship\",\n \"visaType\": null,\n \"expiresAt\": null\n }\n ],\n \"tags\": [\n \"veniam laborum\",\n \"do\"\n ],\n \"documents\": [\n {\n \"documentType\": \"resume_supplement\",\n \"currentVersion\": 64484480,\n \"versions\": [\n {\n \"version\": 99582082,\n \"url\": \"http://xERObpdCPmEWbbYiUgAftNMxuogZO.vsY8htj+5rmuh8zn5Dw1OXA\",\n \"uploadedAt\": \"1981-06-25T05:16:48.520Z\",\n \"fileName\": null,\n \"contentType\": null,\n \"sizeBytes\": null,\n \"checksum\": null,\n \"uploadedByExternalId\": null\n }\n ],\n \"label\": null\n },\n {\n \"documentType\": \"work_sample\",\n \"currentVersion\": 62092812,\n \"versions\": [\n {\n \"version\": 15354592,\n \"url\": \"http://QELyonwwtGSCDLyGkECBrBk.yrEsNvg,wyycXiSE.pIGXY,M1Yz2zeoH.ilYH,GwWzM.\",\n \"uploadedAt\": \"2002-09-18T17:15:09.830Z\",\n \"fileName\": null,\n \"contentType\": null,\n \"sizeBytes\": null,\n \"checksum\": null,\n \"uploadedByExternalId\": null\n }\n ],\n \"label\": null\n }\n ],\n \"links\": [\n {\n \"type\": \"linkedin\",\n \"url\": \"https://www.linkedin.com/in/amaka-obi\",\n \"label\": null\n },\n {\n \"type\": \"website\",\n \"url\": \"https://www.linkedin.com/in/amaka-obi\",\n \"label\": null\n }\n ],\n \"media\": [\n {\n \"kind\": \"intro_video\",\n \"assetKey\": null,\n \"provider\": \"worknation\",\n \"url\": null,\n \"contentType\": null,\n \"fileName\": null,\n \"sizeBytes\": null,\n \"durationSeconds\": null,\n \"width\": null,\n \"height\": null,\n \"caption\": null,\n \"uploadedAt\": null\n },\n {\n \"kind\": \"audio\",\n \"assetKey\": null,\n \"provider\": \"worknation\",\n \"url\": null,\n \"contentType\": null,\n \"fileName\": null,\n \"sizeBytes\": null,\n \"durationSeconds\": null,\n \"width\": null,\n \"height\": null,\n \"caption\": null,\n \"uploadedAt\": null\n }\n ],\n \"assessments\": [\n {\n \"provider\": \"worknation\",\n \"name\": \"Welding Work-Readiness\",\n \"status\": \"scheduled\",\n \"externalId\": null,\n \"outcome\": \"inconclusive\",\n \"score\": null,\n \"maxScore\": null,\n \"scoreBand\": null,\n \"reportKey\": null,\n \"reportUrl\": null,\n \"completedAt\": null,\n \"expiresAt\": null\n },\n {\n \"provider\": \"worknation\",\n \"name\": \"Welding Work-Readiness\",\n \"status\": \"expired\",\n \"externalId\": null,\n \"outcome\": \"fail\",\n \"score\": null,\n \"maxScore\": null,\n \"scoreBand\": null,\n \"reportKey\": null,\n \"reportUrl\": null,\n \"completedAt\": null,\n \"expiresAt\": null\n }\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "e99444db-cfcc-4c15-a1f6-5d80c715da81", "name": "Standard error envelope returned for 4xx/5xx.", "originalRequest": { "url": { "path": [ "v1", "candidates", ":id" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "type": "any", "value": "deserunt cupidatat culpa", "key": "id", "description": "(Required) " } ] }, "header": [ { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "X-API-Key", "value": "" }, { "key": "Accept", "value": "application/json" } ], "method": "PUT", "body": { "mode": "raw", "raw": "{\n \"firstName\": \"Lorem ea non in\",\n \"middleName\": \"Duis laboris fugiat dolor\",\n \"preferredName\": \"dolore Lorem officia\",\n \"lastName\": \"exercitati\",\n \"headline\": \"incididunt magna eiusmod\",\n \"summary\": \"voluptate cupidatat ipsum\",\n \"phone\": \"sit minim occaecat\",\n \"consentGiven\": false,\n \"address\": {\n \"country\": \"NG\",\n \"line1\": \"Lorem do Excepteur\",\n \"line2\": \"et occaecat\",\n \"city\": \"Ut do reprehenderit sunt c\",\n \"region\": \"eiusmod incididunt anim\",\n \"postalCode\": \"quis ad\"\n },\n \"jobPreferences\": {\n \"openToRelocation\": false,\n \"openToRemote\": true,\n \"salaryExpectation\": {\n \"currency\": \"XRE\",\n \"min\": 80949699.90583672,\n \"max\": 63739598.890022874,\n \"period\": \"annual\"\n }\n },\n \"skills\": [\n {\n \"name\": \"Welding\",\n \"yearsExperience\": 4,\n \"proficiency\": \"expert\",\n \"lastUsedYear\": 1988\n },\n {\n \"name\": \"Welding\",\n \"yearsExperience\": 4,\n \"proficiency\": \"expert\",\n \"lastUsedYear\": 2045\n }\n ],\n \"workHistory\": [\n {\n \"employer\": \"Lorem in\",\n \"jobTitle\": \"commodo quis in cupidatat voluptate\",\n \"startDate\": \"1996-04-21\",\n \"employmentType\": \"contract\",\n \"endDate\": \"1992-04-19\",\n \"isCurrent\": false,\n \"location\": \"sed cillum laborum culpa\",\n \"description\": \"labore adipisicing in deserunt\"\n },\n {\n \"employer\": \"aliquip occaecat sint quis culpa\",\n \"jobTitle\": \"qu\",\n \"startDate\": \"1996-04-21\",\n \"employmentType\": \"volunteer\",\n \"endDate\": \"1953-10-13\",\n \"isCurrent\": false,\n \"location\": \"sit consectetur est\",\n \"description\": \"ea ullamco sunt\"\n }\n ],\n \"education\": [\n {\n \"institution\": \"exercitation officia ex \",\n \"qualification\": \"aliquip anim qui sunt\",\n \"fieldOfStudy\": \"nostru\",\n \"completionStatus\": \"completed\",\n \"startDate\": \"1958-03-31\",\n \"endDate\": \"1953-11-10\",\n \"grade\": \"eu labo\"\n },\n {\n \"institution\": \"consectetur est velit et\",\n \"qualification\": \"deserunt\",\n \"fieldOfStudy\": \"anim consectetur adipisicing ipsum ea\",\n \"completionStatus\": \"completed\",\n \"startDate\": \"1947-08-28\",\n \"endDate\": \"1960-02-01\",\n \"grade\": \"aliqua\"\n }\n ],\n \"languages\": [\n {\n \"language\": \"English\",\n \"proficiency\": \"basic\"\n },\n {\n \"language\": \"English\",\n \"proficiency\": \"fluent\"\n }\n ],\n \"workEligibility\": [\n {\n \"country\": \"NG\",\n \"status\": \"not_eligible\",\n \"visaType\": \"ipsum\",\n \"expiresAt\": \"1950-12-04\"\n },\n {\n \"country\": \"NG\",\n \"status\": \"not_eligible\",\n \"visaType\": \"non qui dolore\",\n \"expiresAt\": \"1949-02-17\"\n }\n ],\n \"documents\": [\n {\n \"documentType\": \"resume_supplement\",\n \"currentVersion\": 9338642,\n \"versions\": [\n {\n \"version\": 70912723,\n \"url\": \"https://DkRpDixYNhdoUYRusIBkUQITcjpg.lduG3y9BlveVxo6OZl8hHQOA9c1fyHS\",\n \"uploadedAt\": \"1986-09-04T21:18:12.270Z\",\n \"fileName\": \"ipsum offici\",\n \"contentType\": \"laboris enim dolor tempor\",\n \"sizeBytes\": 357741979,\n \"checksum\": \"Lorem commodo\",\n \"uploadedByExternalId\": \"i\"\n }\n ],\n \"label\": \"2024 CV\"\n },\n {\n \"documentType\": \"academic_transcript\",\n \"currentVersion\": 55461147,\n \"versions\": [\n {\n \"version\": 15034801,\n \"url\": \"http://GTzyAGHCGtWMyWUJJdPFzvQMta.reGy2PKzFapKYJIjvmYhtgSZa5+RhMaF+-KG\",\n \"uploadedAt\": \"1972-04-13T07:46:57.983Z\",\n \"fileName\": \"velit Excepteur in esse\",\n \"contentType\": \"cupidatat officia consequat\",\n \"sizeBytes\": 351939839,\n \"checksum\": \"ut\",\n \"uploadedByExternalId\": \"magna\"\n }\n ],\n \"label\": \"2024 CV\"\n }\n ],\n \"links\": [\n {\n \"type\": \"github\",\n \"url\": \"https://www.linkedin.com/in/amaka-obi\",\n \"label\": \"LinkedIn\"\n },\n {\n \"type\": \"linkedin\",\n \"url\": \"https://www.linkedin.com/in/amaka-obi\",\n \"label\": \"LinkedIn\"\n }\n ],\n \"media\": [\n {\n \"kind\": \"profile_photo\",\n \"assetKey\": \"wn:media:vid_88213\",\n \"provider\": \"worknation\",\n \"url\": \"https://files.example/intro.mp4\",\n \"contentType\": \"video/mp4\",\n \"fileName\": \"intro.mp4\",\n \"sizeBytes\": 4718592,\n \"durationSeconds\": 68,\n \"width\": 1280,\n \"height\": 720,\n \"caption\": \"60-second introduction\",\n \"uploadedAt\": \"2026-06-02T09:05:00Z\"\n },\n {\n \"kind\": \"profile_photo\",\n \"assetKey\": \"wn:media:vid_88213\",\n \"provider\": \"worknation\",\n \"url\": \"https://files.example/intro.mp4\",\n \"contentType\": \"video/mp4\",\n \"fileName\": \"intro.mp4\",\n \"sizeBytes\": 4718592,\n \"durationSeconds\": 68,\n \"width\": 1280,\n \"height\": 720,\n \"caption\": \"60-second introduction\",\n \"uploadedAt\": \"2026-06-02T09:05:00Z\"\n }\n ],\n \"assessments\": [\n {\n \"provider\": \"worknation\",\n \"name\": \"Welding Work-Readiness\",\n \"status\": \"in_progress\",\n \"externalId\": \"kry-4f2a9\",\n \"outcome\": \"pass\",\n \"score\": 82,\n \"maxScore\": 100,\n \"scoreBand\": \"Proficient\",\n \"reportKey\": \"kry:report:88f21\",\n \"reportUrl\": \"https://files.example/report.pdf\",\n \"completedAt\": \"2026-05-18T13:15:00Z\",\n \"expiresAt\": \"2028-05-18T13:15:00Z\"\n },\n {\n \"provider\": \"worknation\",\n \"name\": \"Welding Work-Readiness\",\n \"status\": \"expired\",\n \"externalId\": \"kry-4f2a9\",\n \"outcome\": \"inconclusive\",\n \"score\": 82,\n \"maxScore\": 100,\n \"scoreBand\": \"Proficient\",\n \"reportKey\": \"kry:report:88f21\",\n \"reportUrl\": \"https://files.example/report.pdf\",\n \"completedAt\": \"2026-05-18T13:15:00Z\",\n \"expiresAt\": \"2028-05-18T13:15:00Z\"\n }\n ],\n \"consents\": [\n {\n \"type\": \"data_sharing_partners\",\n \"granted\": false,\n \"grantedAt\": \"1973-04-05T05:58:49.455Z\",\n \"policyVersion\": \"lab\"\n },\n {\n \"type\": \"marketing\",\n \"granted\": false,\n \"grantedAt\": \"1998-09-11T22:42:36.106Z\",\n \"policyVersion\": \"elit laborum dolore i\"\n }\n ]\n}", "options": { "raw": { "language": "json" } } } }, "status": "Unauthorized", "code": 401, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"error\": \"unauthorized\",\n \"message\": \"ex non\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "58156251-2544-4c5c-a4ef-b926f365b334", "name": "Standard error envelope returned for 4xx/5xx.", "originalRequest": { "url": { "path": [ "v1", "candidates", ":id" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "type": "any", "value": "deserunt cupidatat culpa", "key": "id", "description": "(Required) " } ] }, "header": [ { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "X-API-Key", "value": "" }, { "key": "Accept", "value": "application/json" } ], "method": "PUT", "body": { "mode": "raw", "raw": "{\n \"firstName\": \"Lorem ea non in\",\n \"middleName\": \"Duis laboris fugiat dolor\",\n \"preferredName\": \"dolore Lorem officia\",\n \"lastName\": \"exercitati\",\n \"headline\": \"incididunt magna eiusmod\",\n \"summary\": \"voluptate cupidatat ipsum\",\n \"phone\": \"sit minim occaecat\",\n \"consentGiven\": false,\n \"address\": {\n \"country\": \"NG\",\n \"line1\": \"Lorem do Excepteur\",\n \"line2\": \"et occaecat\",\n \"city\": \"Ut do reprehenderit sunt c\",\n \"region\": \"eiusmod incididunt anim\",\n \"postalCode\": \"quis ad\"\n },\n \"jobPreferences\": {\n \"openToRelocation\": false,\n \"openToRemote\": true,\n \"salaryExpectation\": {\n \"currency\": \"XRE\",\n \"min\": 80949699.90583672,\n \"max\": 63739598.890022874,\n \"period\": \"annual\"\n }\n },\n \"skills\": [\n {\n \"name\": \"Welding\",\n \"yearsExperience\": 4,\n \"proficiency\": \"expert\",\n \"lastUsedYear\": 1988\n },\n {\n \"name\": \"Welding\",\n \"yearsExperience\": 4,\n \"proficiency\": \"expert\",\n \"lastUsedYear\": 2045\n }\n ],\n \"workHistory\": [\n {\n \"employer\": \"Lorem in\",\n \"jobTitle\": \"commodo quis in cupidatat voluptate\",\n \"startDate\": \"1996-04-21\",\n \"employmentType\": \"contract\",\n \"endDate\": \"1992-04-19\",\n \"isCurrent\": false,\n \"location\": \"sed cillum laborum culpa\",\n \"description\": \"labore adipisicing in deserunt\"\n },\n {\n \"employer\": \"aliquip occaecat sint quis culpa\",\n \"jobTitle\": \"qu\",\n \"startDate\": \"1996-04-21\",\n \"employmentType\": \"volunteer\",\n \"endDate\": \"1953-10-13\",\n \"isCurrent\": false,\n \"location\": \"sit consectetur est\",\n \"description\": \"ea ullamco sunt\"\n }\n ],\n \"education\": [\n {\n \"institution\": \"exercitation officia ex \",\n \"qualification\": \"aliquip anim qui sunt\",\n \"fieldOfStudy\": \"nostru\",\n \"completionStatus\": \"completed\",\n \"startDate\": \"1958-03-31\",\n \"endDate\": \"1953-11-10\",\n \"grade\": \"eu labo\"\n },\n {\n \"institution\": \"consectetur est velit et\",\n \"qualification\": \"deserunt\",\n \"fieldOfStudy\": \"anim consectetur adipisicing ipsum ea\",\n \"completionStatus\": \"completed\",\n \"startDate\": \"1947-08-28\",\n \"endDate\": \"1960-02-01\",\n \"grade\": \"aliqua\"\n }\n ],\n \"languages\": [\n {\n \"language\": \"English\",\n \"proficiency\": \"basic\"\n },\n {\n \"language\": \"English\",\n \"proficiency\": \"fluent\"\n }\n ],\n \"workEligibility\": [\n {\n \"country\": \"NG\",\n \"status\": \"not_eligible\",\n \"visaType\": \"ipsum\",\n \"expiresAt\": \"1950-12-04\"\n },\n {\n \"country\": \"NG\",\n \"status\": \"not_eligible\",\n \"visaType\": \"non qui dolore\",\n \"expiresAt\": \"1949-02-17\"\n }\n ],\n \"documents\": [\n {\n \"documentType\": \"resume_supplement\",\n \"currentVersion\": 9338642,\n \"versions\": [\n {\n \"version\": 70912723,\n \"url\": \"https://DkRpDixYNhdoUYRusIBkUQITcjpg.lduG3y9BlveVxo6OZl8hHQOA9c1fyHS\",\n \"uploadedAt\": \"1986-09-04T21:18:12.270Z\",\n \"fileName\": \"ipsum offici\",\n \"contentType\": \"laboris enim dolor tempor\",\n \"sizeBytes\": 357741979,\n \"checksum\": \"Lorem commodo\",\n \"uploadedByExternalId\": \"i\"\n }\n ],\n \"label\": \"2024 CV\"\n },\n {\n \"documentType\": \"academic_transcript\",\n \"currentVersion\": 55461147,\n \"versions\": [\n {\n \"version\": 15034801,\n \"url\": \"http://GTzyAGHCGtWMyWUJJdPFzvQMta.reGy2PKzFapKYJIjvmYhtgSZa5+RhMaF+-KG\",\n \"uploadedAt\": \"1972-04-13T07:46:57.983Z\",\n \"fileName\": \"velit Excepteur in esse\",\n \"contentType\": \"cupidatat officia consequat\",\n \"sizeBytes\": 351939839,\n \"checksum\": \"ut\",\n \"uploadedByExternalId\": \"magna\"\n }\n ],\n \"label\": \"2024 CV\"\n }\n ],\n \"links\": [\n {\n \"type\": \"github\",\n \"url\": \"https://www.linkedin.com/in/amaka-obi\",\n \"label\": \"LinkedIn\"\n },\n {\n \"type\": \"linkedin\",\n \"url\": \"https://www.linkedin.com/in/amaka-obi\",\n \"label\": \"LinkedIn\"\n }\n ],\n \"media\": [\n {\n \"kind\": \"profile_photo\",\n \"assetKey\": \"wn:media:vid_88213\",\n \"provider\": \"worknation\",\n \"url\": \"https://files.example/intro.mp4\",\n \"contentType\": \"video/mp4\",\n \"fileName\": \"intro.mp4\",\n \"sizeBytes\": 4718592,\n \"durationSeconds\": 68,\n \"width\": 1280,\n \"height\": 720,\n \"caption\": \"60-second introduction\",\n \"uploadedAt\": \"2026-06-02T09:05:00Z\"\n },\n {\n \"kind\": \"profile_photo\",\n \"assetKey\": \"wn:media:vid_88213\",\n \"provider\": \"worknation\",\n \"url\": \"https://files.example/intro.mp4\",\n \"contentType\": \"video/mp4\",\n \"fileName\": \"intro.mp4\",\n \"sizeBytes\": 4718592,\n \"durationSeconds\": 68,\n \"width\": 1280,\n \"height\": 720,\n \"caption\": \"60-second introduction\",\n \"uploadedAt\": \"2026-06-02T09:05:00Z\"\n }\n ],\n \"assessments\": [\n {\n \"provider\": \"worknation\",\n \"name\": \"Welding Work-Readiness\",\n \"status\": \"in_progress\",\n \"externalId\": \"kry-4f2a9\",\n \"outcome\": \"pass\",\n \"score\": 82,\n \"maxScore\": 100,\n \"scoreBand\": \"Proficient\",\n \"reportKey\": \"kry:report:88f21\",\n \"reportUrl\": \"https://files.example/report.pdf\",\n \"completedAt\": \"2026-05-18T13:15:00Z\",\n \"expiresAt\": \"2028-05-18T13:15:00Z\"\n },\n {\n \"provider\": \"worknation\",\n \"name\": \"Welding Work-Readiness\",\n \"status\": \"expired\",\n \"externalId\": \"kry-4f2a9\",\n \"outcome\": \"inconclusive\",\n \"score\": 82,\n \"maxScore\": 100,\n \"scoreBand\": \"Proficient\",\n \"reportKey\": \"kry:report:88f21\",\n \"reportUrl\": \"https://files.example/report.pdf\",\n \"completedAt\": \"2026-05-18T13:15:00Z\",\n \"expiresAt\": \"2028-05-18T13:15:00Z\"\n }\n ],\n \"consents\": [\n {\n \"type\": \"data_sharing_partners\",\n \"granted\": false,\n \"grantedAt\": \"1973-04-05T05:58:49.455Z\",\n \"policyVersion\": \"lab\"\n },\n {\n \"type\": \"marketing\",\n \"granted\": false,\n \"grantedAt\": \"1998-09-11T22:42:36.106Z\",\n \"policyVersion\": \"elit laborum dolore i\"\n }\n ]\n}", "options": { "raw": { "language": "json" } } } }, "status": "Not Found", "code": 404, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"error\": \"unauthorized\",\n \"message\": \"ex non\"\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } } ], "event": [] }, { "id": "8dc3078d-a2ba-44e9-8a73-f6da1ea78889", "name": "webhooks", "description": { "content": "Subscribe to candidate-lifecycle events", "type": "text/plain" }, "item": [ { "id": "c6378475-2134-4bb3-95ac-fc97d462db5c", "name": "Register a webhook endpoint", "request": { "name": "Register a webhook endpoint", "description": {}, "url": { "path": [ "v1", "webhook-endpoints" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" } ], "method": "POST", "auth": null, "body": { "mode": "raw", "raw": "{\n \"url\": \"https://wn.example/gca-hooks\",\n \"eventTypes\": [\n \"candidate.consent_revoked\"\n ],\n \"description\": \"cillum tempor ut\"\n}", "options": { "raw": { "language": "json" } } } }, "response": [ { "id": "ebc79299-3162-4ebe-896f-d26cf75693c2", "name": "Returned ONCE on create/rotate — the signingSecret is not retrievable later.", "originalRequest": { "url": { "path": [ "v1", "webhook-endpoints" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "X-API-Key", "value": "" }, { "key": "Accept", "value": "application/json" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"url\": \"https://wn.example/gca-hooks\",\n \"eventTypes\": [\n \"candidate.consent_revoked\"\n ],\n \"description\": \"cillum tempor ut\"\n}", "options": { "raw": { "language": "json" } } } }, "status": "Created", "code": 201, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"id\": \"pariatur\",\n \"url\": \"http://UvClodwNiNMGKHxAnGUHTOEhwjWHGapY.qjdxVtvdESiyPi+ZeMFT2Tj5RfZZvfwNsRDBmRO\",\n \"eventTypes\": [\n \"candidate.validation_failed\",\n \"candidate.consent_revoked\"\n ],\n \"active\": false,\n \"createdAt\": \"1975-10-09T21:50:59.158Z\",\n \"signingSecret\": \"whsec_3f9a...redacted\",\n \"description\": null\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "58874a80-7a48-4c71-b10f-c3651700ee68", "name": "Standard error envelope returned for 4xx/5xx.", "originalRequest": { "url": { "path": [ "v1", "webhook-endpoints" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "X-API-Key", "value": "" }, { "key": "Accept", "value": "application/json" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"url\": \"https://wn.example/gca-hooks\",\n \"eventTypes\": [\n \"candidate.consent_revoked\"\n ],\n \"description\": \"cillum tempor ut\"\n}", "options": { "raw": { "language": "json" } } } }, "status": "Bad Request", "code": 400, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"error\": \"unauthorized\",\n \"message\": \"ex non\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "9ee1a63c-0649-488c-8fb3-499cb870b600", "name": "Standard error envelope returned for 4xx/5xx.", "originalRequest": { "url": { "path": [ "v1", "webhook-endpoints" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "X-API-Key", "value": "" }, { "key": "Accept", "value": "application/json" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"url\": \"https://wn.example/gca-hooks\",\n \"eventTypes\": [\n \"candidate.consent_revoked\"\n ],\n \"description\": \"cillum tempor ut\"\n}", "options": { "raw": { "language": "json" } } } }, "status": "Unauthorized", "code": 401, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"error\": \"unauthorized\",\n \"message\": \"ex non\"\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } }, { "id": "079841a3-7a6e-49fc-a5c2-a1c3b62dea3e", "name": "List webhook endpoints", "request": { "name": "List webhook endpoints", "description": {}, "url": { "path": [ "v1", "webhook-endpoints" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Accept", "value": "application/json" } ], "method": "GET", "auth": null }, "response": [ { "id": "12945a6a-cdc2-4095-a5fb-3522613527a7", "name": "Default Response", "originalRequest": { "url": { "path": [ "v1", "webhook-endpoints" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "X-API-Key", "value": "" }, { "key": "Accept", "value": "application/json" } ], "method": "GET", "body": {} }, "status": "OK", "code": 200, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"data\": [\n {\n \"id\": \"whe_01J9Z0\",\n \"url\": \"http://rNpTIGzMAtaVoLZxYuCpZbhuElyX.rouzZxLxiMlKKApjpyLkwzAi.oxC3bfN.Cs3qUC75FUuG0V5HoTMKi6Fnz6m0JCKpIyEd\",\n \"eventTypes\": [\n \"candidate.erased\",\n \"candidate.received\"\n ],\n \"active\": false,\n \"createdAt\": \"1998-01-06T23:15:26.768Z\",\n \"description\": null\n },\n {\n \"id\": \"whe_01J9Z0\",\n \"url\": \"https://nPKjthEXLin.mucXub,jTT2e7GV5o\",\n \"eventTypes\": [\n \"candidate.received\",\n \"candidate.erased\"\n ],\n \"active\": true,\n \"createdAt\": \"2023-06-01T12:33:24.296Z\",\n \"description\": null\n }\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "6711c2b7-dda0-4063-be94-9ab3c171082d", "name": "Standard error envelope returned for 4xx/5xx.", "originalRequest": { "url": { "path": [ "v1", "webhook-endpoints" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "X-API-Key", "value": "" }, { "key": "Accept", "value": "application/json" } ], "method": "GET", "body": {} }, "status": "Unauthorized", "code": 401, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"error\": \"unauthorized\",\n \"message\": \"ex non\"\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } }, { "id": "5921970d-8ac2-4fa2-ac32-37b0400affed", "name": "Fetch a webhook endpoint", "request": { "name": "Fetch a webhook endpoint", "description": {}, "url": { "path": [ "v1", "webhook-endpoints", ":id" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "type": "any", "value": "deserunt cupidatat culpa", "key": "id", "description": "(Required) " } ] }, "header": [ { "key": "Accept", "value": "application/json" } ], "method": "GET", "auth": null }, "response": [ { "id": "ba452143-3ae3-4ec9-96e1-00bc86abf3a4", "name": "A registered webhook endpoint (signing secret is never returned here).", "originalRequest": { "url": { "path": [ "v1", "webhook-endpoints", ":id" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "type": "any", "value": "deserunt cupidatat culpa", "key": "id", "description": "(Required) " } ] }, "header": [ { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "X-API-Key", "value": "" }, { "key": "Accept", "value": "application/json" } ], "method": "GET", "body": {} }, "status": "OK", "code": 200, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"id\": \"whe_01J9Z0\",\n \"url\": \"https://iQQPSZIsCZ.ughmaE4ah3qNpgoCz2ONvkLVmscwmFCGZEpkEno+Phr\",\n \"eventTypes\": [\n \"candidate.received\",\n \"candidate.verified\"\n ],\n \"active\": false,\n \"createdAt\": \"1995-11-27T15:20:58.959Z\",\n \"description\": null\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "dd2cbb52-dff6-4977-899c-440be5f4f054", "name": "Standard error envelope returned for 4xx/5xx.", "originalRequest": { "url": { "path": [ "v1", "webhook-endpoints", ":id" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "type": "any", "value": "deserunt cupidatat culpa", "key": "id", "description": "(Required) " } ] }, "header": [ { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "X-API-Key", "value": "" }, { "key": "Accept", "value": "application/json" } ], "method": "GET", "body": {} }, "status": "Unauthorized", "code": 401, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"error\": \"unauthorized\",\n \"message\": \"ex non\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "9a3ae3c5-b271-4ac1-851b-85d9eb381662", "name": "Standard error envelope returned for 4xx/5xx.", "originalRequest": { "url": { "path": [ "v1", "webhook-endpoints", ":id" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "type": "any", "value": "deserunt cupidatat culpa", "key": "id", "description": "(Required) " } ] }, "header": [ { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "X-API-Key", "value": "" }, { "key": "Accept", "value": "application/json" } ], "method": "GET", "body": {} }, "status": "Not Found", "code": 404, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"error\": \"unauthorized\",\n \"message\": \"ex non\"\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } }, { "id": "92da5a65-cb62-4023-b82c-23573b05b723", "name": "Delete a webhook endpoint", "request": { "name": "Delete a webhook endpoint", "description": {}, "url": { "path": [ "v1", "webhook-endpoints", ":id" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "type": "any", "value": "deserunt cupidatat culpa", "key": "id", "description": "(Required) " } ] }, "header": [ { "key": "Accept", "value": "application/json" } ], "method": "DELETE", "auth": null }, "response": [ { "id": "27b8be5a-fa06-478c-8792-7b86deb170f9", "name": "Default Response", "originalRequest": { "url": { "path": [ "v1", "webhook-endpoints", ":id" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "type": "any", "value": "deserunt cupidatat culpa", "key": "id", "description": "(Required) " } ] }, "header": [ { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "X-API-Key", "value": "" } ], "method": "DELETE", "body": {} }, "status": "No Content", "code": 204, "header": [ { "key": "Content-Type", "value": "text/plain" } ], "body": "", "cookie": [], "_postman_previewlanguage": "text" }, { "id": "f9c466fc-f921-4673-a2b2-48134a2c0d64", "name": "Standard error envelope returned for 4xx/5xx.", "originalRequest": { "url": { "path": [ "v1", "webhook-endpoints", ":id" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "type": "any", "value": "deserunt cupidatat culpa", "key": "id", "description": "(Required) " } ] }, "header": [ { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "X-API-Key", "value": "" }, { "key": "Accept", "value": "application/json" } ], "method": "DELETE", "body": {} }, "status": "Unauthorized", "code": 401, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"error\": \"unauthorized\",\n \"message\": \"ex non\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "a0236c60-b221-401e-9515-1f0a69e85a54", "name": "Standard error envelope returned for 4xx/5xx.", "originalRequest": { "url": { "path": [ "v1", "webhook-endpoints", ":id" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "type": "any", "value": "deserunt cupidatat culpa", "key": "id", "description": "(Required) " } ] }, "header": [ { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "X-API-Key", "value": "" }, { "key": "Accept", "value": "application/json" } ], "method": "DELETE", "body": {} }, "status": "Not Found", "code": 404, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"error\": \"unauthorized\",\n \"message\": \"ex non\"\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } }, { "id": "e72b4d51-e5ae-4367-808b-3973c3bd00de", "name": "Send a sample event to this endpoint", "request": { "name": "Send a sample event to this endpoint", "description": {}, "url": { "path": [ "v1", "webhook-endpoints", ":id", "test" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "type": "any", "value": "deserunt cupidatat culpa", "key": "id", "description": "(Required) " } ] }, "header": [ { "key": "Accept", "value": "application/json" } ], "method": "POST", "auth": null }, "response": [ { "id": "3d1ab0c2-d12d-479d-8fa0-8a3b2370dcdd", "name": "Default Response", "originalRequest": { "url": { "path": [ "v1", "webhook-endpoints", ":id", "test" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "type": "any", "value": "deserunt cupidatat culpa", "key": "id", "description": "(Required) " } ] }, "header": [ { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "X-API-Key", "value": "" } ], "method": "POST", "body": {} }, "status": "Accepted", "code": 202, "header": [ { "key": "Content-Type", "value": "text/plain" } ], "body": "", "cookie": [], "_postman_previewlanguage": "text" }, { "id": "d8f9ddfb-f339-4521-9a0e-6a4606003b7a", "name": "Standard error envelope returned for 4xx/5xx.", "originalRequest": { "url": { "path": [ "v1", "webhook-endpoints", ":id", "test" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "type": "any", "value": "deserunt cupidatat culpa", "key": "id", "description": "(Required) " } ] }, "header": [ { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "X-API-Key", "value": "" }, { "key": "Accept", "value": "application/json" } ], "method": "POST", "body": {} }, "status": "Unauthorized", "code": 401, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"error\": \"unauthorized\",\n \"message\": \"ex non\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "1fa8204c-c31c-4cc3-901f-c31c6e677350", "name": "Standard error envelope returned for 4xx/5xx.", "originalRequest": { "url": { "path": [ "v1", "webhook-endpoints", ":id", "test" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "type": "any", "value": "deserunt cupidatat culpa", "key": "id", "description": "(Required) " } ] }, "header": [ { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "X-API-Key", "value": "" }, { "key": "Accept", "value": "application/json" } ], "method": "POST", "body": {} }, "status": "Not Found", "code": 404, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"error\": \"unauthorized\",\n \"message\": \"ex non\"\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } } ], "event": [] } ], "event": [], "variable": [ { "key": "baseUrl", "value": "http://localhost:3000" }, { "key": "apiKey", "value": "REPLACE_WITH_YOUR_KEY" } ], "auth": { "type": "apikey", "apikey": [ { "key": "key", "value": "X-API-Key" }, { "key": "value", "value": "{{apiKey}}" }, { "key": "in", "value": "header" } ] }, "info": { "_postman_id": "18b25cbd-39a6-4fa7-a201-65d10a3d5621", "name": "GCA CMP REST API", "schema": "https://schema.getpostman.com/json/collection/v2.1.0/collection.json", "description": { "content": "**[← Developer Portal](/)** · [Interactive docs (Swagger)](/docs) · [OpenAPI spec](/openapi.json) · [Postman](/portal/postman.json)\n\nExternal REST surface for the GCA Candidate Management Platform. Worknation candidate intake and record access. Authenticate with the X-API-Key header.\n\nCompatibility: changes are backward-compatible within v1. Breaking changes ship only in a new major version (e.g. /v2), never within v1.", "type": "text/plain" } } }