--- agentTools: projectIndex: https://mantiks-api.readme.io/llms.txt --- # Get Job Person For Persona Returns the best matching person for a specific job and persona. Credits: 1 credit if found. # OpenAPI definition ```json { "openapi": "3.1.0", "info": { "title": "Mantiks API", "version": "2.5", "description": "Public API contract generated from the application endpoint registry." }, "servers": [ { "url": "https://dashboard.mantiks.io/api/v2" } ], "tags": [ { "name": "Jobs" }, { "name": "Webhooks" } ], "components": { "securitySchemes": { "ApiKeyAuth": { "type": "apiKey", "in": "header", "name": "X-API-KEY" } } }, "paths": { "/jobs/{id}/personas/{persona_id}": { "get": { "operationId": "jobPersonaDiscover", "tags": [ "Jobs" ], "summary": "Get Job Person For Persona", "description": "Returns the best matching person for a specific job and persona.\n\nCredits: 1 credit if found.", "x-mantiks-credits": { "cost": 1, "disclaimer": "if found" }, "parameters": [ { "name": "id", "in": "path", "required": true, "description": "Job identifier.", "schema": { "type": "string", "minLength": 1, "description": "Job identifier.", "example": "job_123" }, "example": "job_123" }, { "name": "persona_id", "in": "path", "required": true, "description": "Persona identifier.", "schema": { "type": "string", "minLength": 1, "description": "Persona identifier.", "example": "2BtrB38BbGqJD859d28V" }, "example": "2BtrB38BbGqJD859d28V" } ], "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": { "anyOf": [ { "type": "object", "properties": { "found": { "type": "boolean", "const": true }, "people": { "type": "object", "properties": { "id": { "type": "string" }, "job_title": { "type": "string" }, "full_name": { "type": "string" }, "first_name": { "type": "string" }, "last_name": { "type": "string" }, "civility": { "type": "string" }, "company_id": { "type": "string" }, "linkedin": { "type": "string", "format": "uri" }, "profile_picture_url": { "anyOf": [ { "type": "string", "format": "uri" }, { "type": "null" } ] }, "location": { "anyOf": [ { "type": "object", "properties": { "id": { "type": "string" }, "type": { "type": "string", "enum": [ "city", "region", "department", "country" ] }, "city": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "department": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "country": { "type": "string" }, "region": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "full_name": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "coordinates": { "anyOf": [ { "type": "object", "properties": { "lat": { "type": "number" }, "lon": { "type": "number" } }, "required": [ "lat", "lon" ], "additionalProperties": false }, { "type": "null" } ] } }, "required": [ "id", "type", "city", "country", "region", "coordinates" ], "additionalProperties": false }, { "type": "null" } ] }, "explanation": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "icebreaker": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "icebreaker_object": { "anyOf": [ { "type": "string" }, { "type": "null" } ] } }, "required": [ "id", "job_title", "full_name", "company_id", "linkedin", "location" ], "additionalProperties": false } }, "required": [ "found", "people" ], "additionalProperties": false }, { "type": "object", "properties": { "found": { "type": "boolean", "const": false } }, "required": [ "found" ], "additionalProperties": false } ], "description": "Best-fit person result for the job." }, "example": { "found": true, "people": { "id": "ppl_123", "job_title": "HR Director", "full_name": "Jane Doe", "first_name": "Jane", "last_name": "Doe", "civility": "Ms", "company_id": "cmp_123", "linkedin": "https://www.linkedin.com/in/jane-doe/", "profile_picture_url": "https://media.example.com/jane-doe.jpg", "location": { "id": "3017382", "type": "city", "city": "Paris", "country": "France", "region": "Ile-de-France", "coordinates": { "lat": 48.8534, "lon": 2.3488 } } } } } } }, "400": { "description": "Invalid request payload or parameters.", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "details": { "type": "array", "items": { "type": "object", "properties": { "path": { "type": "string" }, "message": { "type": "string" }, "code": { "type": "string" } }, "required": [ "path", "message", "code" ], "additionalProperties": false } } }, "required": [ "error" ], "additionalProperties": false }, "example": { "error": "Invalid request payload", "details": [ { "path": "job.locations", "message": "Expected array", "code": "invalid_type" } ] } } } }, "401": { "description": "Authentication credentials were not provided.", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "code": { "type": "string" }, "details": {}, "request_id": { "type": "string" } }, "required": [ "error" ], "additionalProperties": false }, "example": { "error": "Authentication credentials were not provided" } } } }, "402": { "description": "The current credit balance does not cover the maximum cost of the request.", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "code": { "type": "string" }, "details": {}, "request_id": { "type": "string" } }, "required": [ "error" ], "additionalProperties": false }, "example": { "error": "no credits left" } } } }, "403": { "description": "You do not have permission to perform this action.", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "code": { "type": "string" }, "details": {}, "request_id": { "type": "string" } }, "required": [ "error" ], "additionalProperties": false }, "example": { "error": "You do not have permission to perform this action" } } } }, "404": { "description": "Resource not found.", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "code": { "type": "string" }, "details": {}, "request_id": { "type": "string" } }, "required": [ "error" ], "additionalProperties": false }, "example": { "error": "Resource not found" } } } }, "500": { "description": "Internal server error.", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "code": { "type": "string" }, "details": {}, "request_id": { "type": "string" } }, "required": [ "error" ], "additionalProperties": false }, "example": { "error": "Internal server error" } } } } }, "security": [ { "ApiKeyAuth": [] } ] } } }, "webhooks": { "exportCompleted": { "post": { "operationId": "exportCompleted", "tags": [ "Webhooks" ], "summary": "Export completed", "description": "Mantiks POSTs this JSON body to `setting.webhook.url` when a search export finishes, and when you trigger a mocked delivery with `POST /searches/webhook/test`. The request uses `Content-Type: application/json`. Redirects are not followed. Respond with HTTP 2xx to acknowledge receipt. If the payload is larger than about 75KB and the destination returns HTTP 413, Mantiks retries as several POSTs with the same envelope and a subset of `leads`; `nb_leads` and `credits_cost` then describe that POST only. Optional lead fields (`reverse_company`, icebreaker fields, CV score fields) appear only when those options are enabled on the search.", "requestBody": { "required": true, "description": "JSON body Mantiks POSTs to the customer webhook URL.", "content": { "application/json": { "schema": { "type": "object", "properties": { "targeting_id": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "description": "Search / schedule identifier that produced the export.", "example": "search_123" }, "report_id": { "type": "string", "description": "Export identifier.", "example": "export_123" }, "report_state": { "type": "string", "description": "Export state at delivery time.", "example": "finish" }, "creation_date": { "type": "string", "description": "Export creation date in ISO 8601 format.", "example": "2026-03-25T09:00:00.000Z" }, "search_name": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "description": "Search name from the configuration.", "example": "Sales in Paris" }, "nb_leads": { "type": "number", "description": "Number of leads in this POST. Large exports may be split across several POSTs." }, "credits_cost": { "type": "number", "description": "Credits consumed for the leads in this POST." }, "leads": { "type": "array", "items": { "type": "object", "properties": { "company_id": { "type": "string", "description": "Company identifier.", "example": "cmp_123" }, "company_name": { "type": "string", "description": "Company display name.", "example": "ACME" }, "company_sectors": { "type": "string", "description": "Comma-separated industries.", "example": "Software, SaaS" }, "company_size": { "type": "string", "description": "Employee-range label.", "example": "51-200" }, "hq_location": { "type": "string", "description": "Headquarters location label.", "example": "Paris France" }, "company_website": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "description": "Company website.", "example": "https://acme.com", "format": "uri" }, "company_description": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "description": "Unused. Always null." }, "company_technologies": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "description": "Unused. Always null." }, "matched_technologies": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "description": "Comma-separated technologies that matched the search." }, "company_revenue": { "type": "string", "description": "Unused. Always an empty string.", "example": "" }, "company_logo_url": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "description": "Company logo URL when available." }, "company_linkedin": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "description": "Company LinkedIn URL.", "format": "uri" }, "matched_keywords": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "description": "Comma-separated keywords that matched the job." }, "job_id": { "type": "string", "description": "Source job identifier.", "example": "job_123" }, "job_offer_title": { "type": "string", "description": "Source job title.", "example": "Sales Manager H/F" }, "job_offer_cleaned_title": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "description": "AI-cleaned job title when icebreaker is enabled, otherwise null." }, "job_offer_description": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "description": "Source job description." }, "job_offer_location": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "description": "Job location label." }, "job_offer_location_id": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "description": "Job location identifier." }, "job_offer_lat": { "anyOf": [ { "type": "number" }, { "type": "null" } ], "description": "Job location latitude." }, "job_offer_lon": { "anyOf": [ { "type": "number" }, { "type": "null" } ], "description": "Job location longitude." }, "job_creation_date": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "description": "Job publication date in ISO 8601 format." }, "job_offer_source": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "description": "Job board name.", "example": "linkedin" }, "job_offer_url": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "description": "Source job URL.", "format": "uri" }, "job_offer_is_reposted": { "type": "boolean", "description": "Whether the job was reposted." }, "job_offer_is_active_more_45_days": { "type": "boolean", "description": "Whether the job had already been active for 45+ days when the lead was created." }, "lead_location": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "description": "Contact location label." }, "lead_civility": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "description": "Contact civility.", "example": "Ms" }, "lead_first_name": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "description": "Contact first name.", "example": "Jane" }, "lead_last_name": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "description": "Contact last name.", "example": "Doe" }, "lead_persona_name": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "description": "Persona used to resolve the contact." }, "lead_job_title": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "description": "Contact job title." }, "lead_email": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "description": "Resolved email.", "format": "email" }, "lead_email_status": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "description": "Email quality status (`ok`, `risky`, `notfound`).", "example": "ok" }, "company_phone": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "description": "Company phone number." }, "lead_phones": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "description": "Comma-separated contact phone numbers." }, "lead_linkedin": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "description": "Contact LinkedIn URL.", "format": "uri" }, "lead_explanation": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "description": "Why this person was selected. Present when icebreaker is enabled." }, "lead_icebreaker": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "description": "Outreach message body. Present when icebreaker is enabled." }, "lead_icebreaker_object": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "description": "Outreach email subject. Present when icebreaker is enabled." }, "score": { "anyOf": [ { "type": "number" }, { "type": "null" } ], "description": "CV matching score. Present when the export includes CV scoring." }, "score_explanation": { "type": "string", "description": "CV matching explanation. Present when the export includes CV scoring." }, "anonymized_cv_url": { "type": "string", "description": "Signed URL to the anonymized CV. Present for CV-matching exports.", "format": "uri" }, "reverse_company": { "type": "object", "properties": { "company_id": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "description": "Reverse-sourced company identifier.", "example": "cmp_456" }, "company_name": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "description": "Reverse-sourced company name.", "example": "Final Client SA" }, "company_sectors": { "type": "string", "description": "Comma-separated industries.", "example": "Manufacturing, Industrial" }, "company_size": { "type": "string", "description": "Employee-range label.", "example": "201-500" }, "hq_location": { "type": "string", "description": "Headquarters location label.", "example": "Lyon France" }, "company_website": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "description": "Company website.", "format": "uri" }, "company_description": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "description": "Unused. Always null." }, "company_technologies": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "description": "Unused. Always null." }, "matched_technologies": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "description": "Comma-separated matched technologies." }, "company_revenue": { "type": "string", "description": "Unused. Always an empty string.", "example": "" }, "company_logo_url": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "description": "Logo URL when available." }, "company_linkedin": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "description": "Company LinkedIn URL.", "format": "uri" }, "company_siret": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "description": "Company SIRET when available." }, "probability": { "anyOf": [ { "type": "number" }, { "type": "null" } ], "description": "Estimated probability that this company is the final client.", "example": 0.87 } }, "required": [ "company_id", "company_name", "company_sectors", "company_size", "hq_location", "company_website", "company_description", "company_technologies", "matched_technologies", "company_revenue", "company_logo_url", "company_linkedin", "company_siret", "probability" ], "additionalProperties": false, "description": "Present when reverse sourcing is enabled on the search." } }, "required": [ "company_id", "company_name", "company_sectors", "company_size", "hq_location", "company_website", "company_description", "company_technologies", "matched_technologies", "company_revenue", "company_logo_url", "company_linkedin", "matched_keywords", "job_id", "job_offer_title", "job_offer_cleaned_title", "job_offer_description", "job_offer_location", "job_offer_location_id", "job_offer_lat", "job_offer_lon", "job_creation_date", "job_offer_source", "job_offer_url", "job_offer_is_reposted", "job_offer_is_active_more_45_days", "lead_location", "lead_civility", "lead_first_name", "lead_last_name", "lead_persona_name", "lead_job_title", "lead_email", "lead_email_status", "company_phone", "lead_phones", "lead_linkedin" ], "additionalProperties": false, "description": "Lead row delivered to the customer webhook." }, "description": "Leads included in this delivery." } }, "required": [ "targeting_id", "report_id", "report_state", "creation_date", "search_name", "nb_leads", "credits_cost", "leads" ], "additionalProperties": false, "description": "JSON body Mantiks POSTs to the customer webhook URL." }, "example": { "targeting_id": "search_123", "report_id": "export_123", "report_state": "finish", "creation_date": "2026-03-25T09:00:00.000Z", "search_name": "Sales in Paris", "nb_leads": 1, "credits_cost": 13, "leads": [ { "company_id": "mock-company-id", "company_name": "Acme Corp", "company_sectors": "Software, SaaS", "company_size": "51-200", "hq_location": "Paris France", "company_website": "https://www.acme.example", "company_description": null, "company_technologies": null, "matched_technologies": "React, Python", "company_revenue": "", "company_logo_url": null, "company_linkedin": "https://www.linkedin.com/company/acme", "matched_keywords": "software engineer", "job_id": "mock-job-id", "job_offer_title": "Senior Software Engineer H/F - React", "job_offer_cleaned_title": "Senior Software Engineer", "job_offer_description": "Join our engineering team...", "job_offer_location": "Paris France", "job_offer_location_id": null, "job_offer_lat": null, "job_offer_lon": null, "job_creation_date": "2026-03-25T09:00:00.000Z", "job_offer_source": "linkedin", "job_offer_url": "https://www.linkedin.com/jobs/view/mock", "job_offer_is_reposted": false, "job_offer_is_active_more_45_days": false, "lead_location": "Paris France", "lead_civility": "Mr", "lead_first_name": "John", "lead_last_name": "Doe", "lead_persona_name": "HR Director", "lead_job_title": "Head of Talent", "lead_email": "john.doe@acme.example", "lead_email_status": "ok", "company_phone": "+33123456789", "lead_phones": "+33612345678", "lead_linkedin": "https://www.linkedin.com/in/johndoe", "lead_explanation": "This lead matches your search criteria.", "lead_icebreaker": "Congrats on the recent hiring push!", "lead_icebreaker_object": "Quick note on your Senior Software Engineer opening", "reverse_company": { "company_id": "mock-reverse-company-id", "company_name": "Final Client SA", "company_sectors": "Manufacturing, Industrial", "company_size": "201-500", "hq_location": "Lyon France", "company_website": "https://www.finalclient.example", "company_description": null, "company_technologies": null, "matched_technologies": "SAP, Salesforce", "company_revenue": "", "company_logo_url": null, "company_linkedin": "https://www.linkedin.com/company/final-client", "company_siret": "12345678900012", "probability": 0.87 } } ] } } } }, "responses": { "200": { "description": "Any HTTP 2xx acknowledges receipt. Non-2xx responses are treated as delivery failures." } } } } }, "x-readme": { "explorer-enabled": true, "proxy-enabled": true }, "_id": { "buffer": { "0": 105, "1": 207, "2": 186, "3": 208, "4": 164, "5": 49, "6": 240, "7": 247, "8": 164, "9": 155, "10": 32, "11": 114 } } } ```