--- updatedAt: 2026-05-26T22:17:37.000Z agentTools: projectIndex: https://docs.adept-id.com/llms.txt --- # Retrieve Job Posting Retrieves a job posting from a job feed. Use this endpoint to retrieve new a job posting in a job feed. It is used in conjunction with [Create Job Posting](https://docs.adept-id.com/reference/create-job-posting), [Update Job Posting](https://docs.adept-id.com/reference/update-job-posting), [Delete Job Posting](https://docs.adept-id.com/reference/delete-job-posting)\` to manage partner supplied job feeds. **Additional Note:** To access this service and attain a `job_feed_id`, please contact your AdeptID Partner Success team. # OpenAPI definition ```json { "servers": [ { "url": "https://api.adept-id.com", "description": "Production Server" } ], "security": [ { "api_key": [] } ], "paths": { "/jobs/v2/feeds/{job_feed_id}/postings/{posting_id}": { "get": { "parameters": [ { "in": "path", "name": "posting_id", "description": "A unique ID for the job posting.", "schema": { "type": "string" }, "required": true }, { "in": "path", "name": "job_feed_id", "description": "The ID of the job feed to search.", "schema": { "type": "string" }, "required": true } ], "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/JobPostingGetOutput" }, "example": "\n{\n\t\"result\": {\n\t\t\"certifications\": [\n\t\t\t\"AWS Certified Solutions Architect\"\n\t\t],\n\t\t\"custom_attributes\": {\n\t\t\t\"department\": \"Engineering\",\n\t\t\t\"job_function\": \"Development\"\n\t\t},\n\t\t\"education\": [\n\t\t\t{\n\t\t\t\t\"degree_type\": \"Bachelor of Science\",\n\t\t\t\t\"level\": \"BACHELORS\",\n\t\t\t\t\"required\": true,\n\t\t\t\t\"subject\": \"Computer Science\"\n\t\t\t}\n\t\t],\n\t\t\"employer_name\": \"Tech Corp\",\n\t\t\"employment_location_type\": \"REMOTE\",\n\t\t\"employment_term\": {\n\t\t\t\"date_end\": \"01/04/2026\",\n\t\t\t\"date_start\": \"01/04/2025\",\n\t\t\t\"duration\": 365\n\t\t},\n\t\t\"employment_type\": \"FULL_TIME\",\n\t\t\"is_internship\": false,\n\t\t\"is_staffing\": false,\n\t\t\"job_title\": \"Software Engineer\",\n\t\t\"location\": {\n\t\t\t\"city\": \"New York\",\n\t\t\t\"country\": \"US\",\n\t\t\t\"postal_code\": \"10001\",\n\t\t\t\"state\": \"New York\",\n\t\t\t\"street_address\": \"123 Main St\"\n\t\t},\n\t\t\"onet_2019_code\": \"15-1252.00\",\n\t\t\"posting_date\": \"01/03/2025\",\n\t\t\"posting_id\": \"12345\",\n\t\t\"posting_status\": \"active\",\n\t\t\"salary\": {\n\t\t\t\"currency\": \"USD\",\n\t\t\t\"max\": 95000,\n\t\t\t\"min\": 70000,\n\t\t\t\"period\": \"ANNUAL\"\n\t\t},\n\t\t\"shift\": {\n\t\t\t\"hours_end\": 17,\n\t\t\t\"hours_start\": 9\n\t\t},\n\t\t\"skills\": [\n\t\t\t\"Python\",\n\t\t\t\"JavaScript\",\n\t\t\t\"SQL\"\n\t\t],\n\t\t\"summary\": \"Develop innovative software solutions for a global audience.\",\n\t\t\"url\": \"https://techcorp.example.com/careers/12345\",\n\t\t\"years_of_experience\": {\n\t\t\t\"max\": 5,\n\t\t\t\"min\": 2\n\t\t}\n\t},\n\t\"operation_id\": \"c8802c2d46e0403e9f0a49385aee05b2\"\n}\n" } } }, "422": { "$ref": "#/components/responses/UNPROCESSABLE_CONTENT" }, "default": { "$ref": "#/components/responses/DEFAULT_ERROR" } }, "summary": "Retrieve Job Posting", "tags": [ "Job Search" ], "description": "Retrieves a job posting from a job feed.", "operationId": "get-job-posting" }, "parameters": [ { "in": "path", "name": "job_feed_id", "required": true, "schema": { "type": "string", "minLength": 1 } }, { "in": "path", "name": "posting_id", "required": true, "schema": { "type": "string", "minLength": 1 } } ] } }, "info": { "title": "AdeptID API", "version": "v2" }, "tags": [ { "name": "Job Search", "description": "Managing job feeds and job postings" } ], "openapi": "3.0.3", "components": { "schemas": { "Error": { "type": "object", "properties": { "code": { "type": "integer", "description": "Error code" }, "status": { "type": "string", "description": "Error name" }, "message": { "type": "string", "description": "Error message" }, "errors": { "type": "object", "description": "Errors", "additionalProperties": {} } } }, "ExperienceInput": { "type": "object", "properties": { "min": { "type": "integer", "description": "The minimum years of experience a valid candidate can have." }, "max": { "type": "integer", "description": "The maximum years of experience a valid candidate can have." } } }, "JobPostingLocationOutput": { "type": "object", "properties": { "street_address": { "type": "string", "description": "The street address of the job posting." }, "city": { "type": "string", "description": "The city of the job posting." }, "state": { "type": "string", "description": "The state of the job posting. (The system expects 2-letter state abbreviations.)" }, "postal_code": { "type": "string", "description": "The zip code of the job posting." }, "country": { "description": "The country of the job posting. (The system expects ISO 3166-1 alpha-2 code.)", "enum": [ "US" ] }, "distance": { "type": "number", "description": "Distance from the search anchor to this job's location, in the units given by `distance_unit`. Present only when the search request supplied a city + radius anchor and the job has a known geographic point." }, "distance_unit": { "type": "string", "description": "The unit `distance` is expressed in (e.g. `miles`)." } }, "required": [ "city", "country", "state" ] }, "JobSalaryInformation": { "type": "object", "properties": { "min": { "type": "number", "description": "The minimum stated salary." }, "max": { "type": "number", "description": "The maximum stated salary." }, "period": { "description": "The pay period of the job. [annual, monthly, weekly, daily, hourly]", "enum": [ "ANNUAL", "HOURLY", "WEEKLY", "DAILY", "MONTHLY", "UNKNOWN" ] }, "currency": { "description": "The ISO 4217 alphabetic currency code for the salary.", "enum": [ "AED", "AFN", "ALL", "AMD", "ANG", "AOA", "ARS", "AUD", "AWG", "AZN", "BAM", "BBD", "BDT", "BGN", "BHD", "BIF", "BMD", "BND", "BOB", "BOV", "BRL", "BSD", "BTN", "BWP", "BYN", "BZD", "CAD", "CDF", "CHE", "CHF", "CHW", "CLF", "CLP", "CNY", "COP", "COU", "CRC", "CUP", "CVE", "CZK", "DJF", "DKK", "DOP", "DZD", "EGP", "ERN", "ETB", "EUR", "FJD", "FKP", "GBP", "GEL", "GHS", "GIP", "GMD", "GNF", "GTQ", "GYD", "HKD", "HNL", "HTG", "HUF", "IDR", "ILS", "INR", "IQD", "IRR", "ISK", "JMD", "JOD", "JPY", "KES", "KGS", "KHR", "KMF", "KPW", "KRW", "KWD", "KYD", "KZT", "LAK", "LBP", "LKR", "LRD", "LSL", "LYD", "MAD", "MDL", "MGA", "MKD", "MMK", "MNT", "MOP", "MRU", "MUR", "MVR", "MWK", "MXN", "MXV", "MYR", "MZN", "NAD", "NGN", "NIO", "NOK", "NPR", "NZD", "OMR", "PAB", "PEN", "PGK", "PHP", "PKR", "PLN", "PYG", "QAR", "RON", "RSD", "RUB", "RWF", "SAR", "SBD", "SCR", "SDG", "SEK", "SGD", "SHP", "SLE", "SOS", "SRD", "SSP", "STN", "SVC", "SYP", "SZL", "THB", "TJS", "TMT", "TND", "TOP", "TRY", "TTD", "TWD", "TZS", "UAH", "UGX", "USD", "USN", "UYI", "UYU", "UYW", "UZS", "VED", "VES", "VND", "VUV", "WST", "XAF", "XAG", "XAU", "XBA", "XBB", "XBC", "XBD", "XCD", "XDR", "XOF", "XPD", "XPF", "XPT", "XSU", "XTS", "XUA", "XXX", "YER", "ZAR", "ZMW", "ZWG" ] } }, "required": [ "currency", "min", "period" ] }, "Shift": { "type": "object", "properties": { "hours_start": { "type": "integer", "minimum": 0, "maximum": 23, "description": "The start time of the shift in 0-23 hour format." }, "hours_end": { "type": "integer", "minimum": 0, "maximum": 23, "description": "The end time of the shift in 0-23 hour format." }, "type": { "description": "The type of shift. Valid values are: DAY, MID, EVENING, NIGHT, ROTATING, DAY_PER_DIEM.", "enum": [ "DAY", "MID", "EVENING", "NIGHT", "ROTATING", "DAY_PER_DIEM", null ], "nullable": true } }, "required": [ "hours_end", "hours_start" ] }, "EmploymentTerm": { "type": "object", "properties": { "date_start": { "type": "string", "format": "date-time", "description": "The start date of the job (MM/DD/YYYY)." }, "date_end": { "type": "string", "format": "date-time", "description": "The end date of the job (MM/DD/YYYY)." }, "duration": { "type": "integer", "description": "The duration of the job in days." } } }, "JobEducationRequirement": { "type": "object", "properties": { "level": { "type": "string", "enum": [ "DOCTORATE", "MASTERS", "BACHELORS", "ASSOCIATES", "HIGH_SCHOOL", "CERTIFICATE", "UNKNOWN" ], "description": "The education level specified for the job. [DOCTORATE, MASTERS, BACHELORS, ASSOCIATES, HIGH_SCHOOL, CERTIFICATE, UNKNOWN]" }, "degree_type": { "description": "The detailed degree type specified for the job. Acceptable values include common degrees such as BA, BS, MBA, MD, etc. See AdeptID education object documentation for allowable values and more detail.", "enum": [ "GED", "High School Diploma", "Certificate", "Associate of Arts", "Associate of Applied Science", "Associate of Science", "Associate of Nursing", "Associate Degree - General", "Bachelor of Arts", "Bachelor of Science", "Bachelor of Engineering", "Bachelor of Fine Arts", "Bachelor of Nursing", "Bachelor's Degree - General", "Master of Arts", "Master of Science", "Master of Engineering", "Master of Philosophy", "Master of Business Administration", "Master of Public Administration", "Master of Library Science", "Master of Social Work", "Master of Public Health", "Master of Fine Arts", "Master of Education", "Master of Laws", "Master's Degree - General", "Doctor of Chiropractic", "Doctor of Dental Medicine", "Doctor of Dental Surgery", "Juris Doctor", "Doctor of Medicine", "Doctor of Osteopathic Medicine", "Doctor of Optometry", "Doctor of Pharmacy", "Doctor of Podiatry", "Doctor of Veterinary Medicine", "Doctor of Philosophy", "Doctor of Science", "Doctor of Education", "Doctor's Degree - General", "HSD", "Cert", "AA", "AAS", "AS", "ADN", "BA", "BS", "BE", "BFA", "BSN", "MA", "MS", "MEng", "MPhil", "MBA", "MPA", "MLS", "MSW", "MPH", "MFA", "MEd", "LLM", "DC", "DMD", "DDS", "JD", "MD", "DO", "OD", "PharmD", "DPM", "DVM", "PhD", "DSc", "EdD", null ], "nullable": true }, "subject": { "type": "string", "description": "The subject of education specified for the job.", "nullable": true }, "required": { "type": "boolean", "default": false, "description": "Whether or not the specified education is required or preferred/not required (default)." } }, "required": [ "level" ] }, "JobPostingCustomFiltersOutput": { "type": "object", "properties": { "string_1": { "type": "string", "description": "Custom string filter field 1.", "nullable": true }, "string_2": { "type": "string", "description": "Custom string filter field 2.", "nullable": true }, "string_3": { "type": "string", "description": "Custom string filter field 3.", "nullable": true }, "string_4": { "type": "string", "description": "Custom string filter field 4.", "nullable": true }, "string_5": { "type": "string", "description": "Custom string filter field 5.", "nullable": true }, "string_6": { "type": "string", "description": "Custom string filter field 6.", "nullable": true }, "string_7": { "type": "string", "description": "Custom string filter field 7.", "nullable": true }, "string_8": { "type": "string", "description": "Custom string filter field 8.", "nullable": true }, "string_9": { "type": "string", "description": "Custom string filter field 9.", "nullable": true }, "string_10": { "type": "string", "description": "Custom string filter field 10.", "nullable": true }, "integer_1": { "type": "integer", "description": "Custom integer filter field 1.", "nullable": true }, "integer_2": { "type": "integer", "description": "Custom integer filter field 2.", "nullable": true }, "integer_3": { "type": "integer", "description": "Custom integer filter field 3.", "nullable": true }, "integer_4": { "type": "integer", "description": "Custom integer filter field 4.", "nullable": true }, "integer_5": { "type": "integer", "description": "Custom integer filter field 5.", "nullable": true }, "float_1": { "type": "number", "description": "Custom float filter field 1.", "nullable": true }, "float_2": { "type": "number", "description": "Custom float filter field 2.", "nullable": true }, "float_3": { "type": "number", "description": "Custom float filter field 3.", "nullable": true }, "float_4": { "type": "number", "description": "Custom float filter field 4.", "nullable": true }, "float_5": { "type": "number", "description": "Custom float filter field 5.", "nullable": true }, "date_1": { "type": "string", "format": "date", "description": "Custom date filter field 1. Formatted YYYY-MM-DD (ISO 8601).", "nullable": true }, "date_2": { "type": "string", "format": "date", "description": "Custom date filter field 2. Formatted YYYY-MM-DD (ISO 8601).", "nullable": true }, "date_3": { "type": "string", "format": "date", "description": "Custom date filter field 3. Formatted YYYY-MM-DD (ISO 8601).", "nullable": true }, "date_4": { "type": "string", "format": "date", "description": "Custom date filter field 4. Formatted YYYY-MM-DD (ISO 8601).", "nullable": true }, "date_5": { "type": "string", "format": "date", "description": "Custom date filter field 5. Formatted YYYY-MM-DD (ISO 8601).", "nullable": true }, "boolean_1": { "type": "boolean", "description": "Custom boolean filter field 1.", "nullable": true }, "boolean_2": { "type": "boolean", "description": "Custom boolean filter field 2.", "nullable": true }, "boolean_3": { "type": "boolean", "description": "Custom boolean filter field 3.", "nullable": true }, "boolean_4": { "type": "boolean", "description": "Custom boolean filter field 4.", "nullable": true }, "boolean_5": { "type": "boolean", "description": "Custom boolean filter field 5.", "nullable": true } } }, "JobPostingDetailOutput": { "type": "object", "properties": { "job_title": { "type": "string", "description": "The job title." }, "employer_name": { "type": "string", "description": "The name of the employer." }, "employment_type": { "description": "Full- or part-time nature of the role, if known. [full_time, part_time, unknown]", "enum": [ "FULL_TIME", "PART_TIME", "UNKNOWN" ] }, "posting_status": { "description": "The job posting status.", "enum": [ "active", "inactive" ] }, "summary": { "type": "string", "description": "The full text of the job posting." }, "is_internship": { "type": "boolean", "default": false, "description": "Whether or not the job is an internship. Defaults to False (not an internship)." }, "is_staffing": { "type": "boolean", "default": false, "description": "Whether or not the job was posted by a staffing/recruiting firm. Defaults to False." }, "posting_date": { "type": "string", "format": "date-time", "description": "The date when the job was posted." }, "skills": { "type": "array", "description": "The skills stated in the job posting.", "items": { "type": "string" } }, "certifications": { "type": "array", "description": "The certifications stated in the job posting.", "items": { "type": "string" } }, "url": { "type": "string", "description": "The URL for the job posting." }, "employment_location_type": { "description": "The in-person nature of the job. [in_person, hybrid, remote]", "enum": [ "HYBRID", "REMOTE", "IN_PERSON", "UNKNOWN" ] }, "location": { "description": "The location for the job posting.", "allOf": [ { "$ref": "#/components/schemas/JobPostingLocationOutput" } ] }, "salary": { "description": "The salary of the job posting.", "allOf": [ { "$ref": "#/components/schemas/JobSalaryInformation" } ] }, "shift": { "description": "The job's shift details, if applicable.", "allOf": [ { "$ref": "#/components/schemas/Shift" } ] }, "employment_term": { "description": "The job's employment timeline details, if applicable.", "allOf": [ { "$ref": "#/components/schemas/EmploymentTerm" } ] }, "education": { "type": "array", "description": "The education requirements for the job.", "items": { "$ref": "#/components/schemas/JobEducationRequirement" } }, "years_of_experience": { "description": "The experience required for the job.", "allOf": [ { "$ref": "#/components/schemas/ExperienceInput" } ] }, "onet_2019_code": { "type": "string", "description": "The ONET 2019 code for the job." }, "custom_attributes": { "type": "object", "description": "This is a custom data object for the job posting. It is returned on searches but cannot be searched itself.", "additionalProperties": {} }, "custom_filters": { "description": "Job posting values for customer-defined filters.", "allOf": [ { "$ref": "#/components/schemas/JobPostingCustomFiltersOutput" } ] }, "posting_id": { "type": "string" }, "data_status": { "description": "The lifecycle status of the posting. `valid` postings are live and appear in job search; `invalid` postings failed processing and `expired` postings are past their active window. Non-`valid` postings are returned here for visibility but are excluded from job search results.", "enum": [ "valid", "invalid", "expired", "deleted" ] } }, "required": [ "job_title", "posting_id" ] }, "JobPostingGetOutput": { "type": "object", "properties": { "operation_id": { "type": "string", "description": "The operation ID, used internally by AdeptID to track the API call.", "example": "90ccc7cdf3a940ac91fcf4b162dbbed8" }, "result": { "$ref": "#/components/schemas/JobPostingDetailOutput" } } } }, "responses": { "UNPROCESSABLE_CONTENT": { "description": "Unprocessable Content", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "DEFAULT_ERROR": { "description": "Default error response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "securitySchemes": { "api_key": { "type": "apiKey", "in": "header", "name": "X-API-KEY" } } } } ```