> For clean Markdown of any page, append .md to the page URL. > For a complete documentation index, see https://docs.vouch.careers/llms.txt. > For AI client integration (Claude Code, Cursor, etc.), connect to the MCP server at https://docs.vouch.careers/_mcp/server. # Get a position via a career page GET https://vouch.careers/api/v1/career-pages/{id}/positions/{positionId} Reference: https://docs.vouch.careers/api-reference/career-pages/get-career-page-position ## Authentication - `Authorization` header (bearer token, required) — API key created in company settings, sent as `Authorization: Bearer `. ## Request ### Path parameters - `id` (string, required) — The career page's ID (its referral link ID, as returned by GET /career-pages). - `positionId` (string, required) — The position ID. ## Response ### 200 Full position detail (same fields as GET /positions/\{id}) with this career page's link fields flattened in, instead of the sharingLinks/careerPagesLinks arrays. - `data` (CareerPagePosition, required) — A position via one careers page. enableApplication/enableVouch reflect any per-careers-page override for this position, so they can differ from GET /positions/\{id}. ## Errors ### 401 Unauthorized Error Missing or invalid API key. - `error` (string, required) - `code` (string, required) ### 403 Forbidden Error API key does not have access to the requested company or position's data. - `error` (string, required) - `code` (string, required) ### 404 Not Found Error Career page not found, or the position is not live on it. - `error` (string, required) - `code` (string, required) ### 429 Too Many Requests Error Rate limit exceeded. See the Retry-After header for when to retry. - `error` (string, required) - `code` (string, required) ## Types ### CareerPagePosition A position via one careers page. enableApplication/enableVouch reflect any per-careers-page override for this position, so they can differ from GET /positions/\{id}. - `id` (string, required) - `title` (string, required) - `pitch` (string, required, nullable) — One-paragraph pitch/summary for the position — also woven into the opening of contentHtml (on the detail endpoint), not just this field. - `status` (enum, required) — Publish lifecycle status — derived automatically from publish/pause/archive actions and whether the position currently has any live, reachable link (an active sharing link or careers page listing), never set directly. 'DRAFT': never published. 'PUBLISHED': published and currently reachable via at least one active link. 'ACTIVE': published and not paused, but not currently reachable via any active link right now (e.g. every link on it is temporarily inactive). 'PAUSED': published and explicitly paused, not currently reachable. 'ARCHIVED': closed (archived or deleted). - Allowed values: `DRAFT`, `PUBLISHED`, `ACTIVE`, `PAUSED`, `ARCHIVED` - `language` (enum, required) - Allowed values: `NO`, `DK`, `EN`, `SE`, `GB` - `employmentType` (list of enum, required) — Employment type tags for this position (e.g. Full-time, Remote, Internship). - Allowed values: `Full-time`, `Part-time`, `On-site`, `Temporary`, `Internship`, `Volunteer`, `Contract`, `Remote`, `Hybrid` - `listingColor` (string, required, nullable) - `bannerUrl` (string, required, nullable) - `locations` (list of Location, required) - `createdAt` (datetime, required) - `updatedAt` (datetime, required) - `publishedAt` (datetime, required, nullable) - `lastPublishedAt` (datetime, required, nullable) - `firstActivatedAt` (datetime, required, nullable) - `expirationDate` (datetime, required, nullable) - `enableApplication` (boolean, required) - `enableVouch` (boolean, required) - `company` (Company, required) - `highlights` (list of string, required, nullable) - `salary` (CareerPagePositionSalary, required, nullable) - `contentHtml` (string, required) — The position's text-only description as HTML (job-board tag subset). This is what job boards receive: a manually edited text when the position has one, otherwise the text derived from its sections. - `contentHtmlDefault` (string, required) — The text derived from the position's sections, regardless of any manual edit. - `contentHtmlOverride` (string, required, nullable) — The manually edited text, or null when contentHtml is the derived default. - `images` (list of list of string, required) — This position's image gallery sections — contentHtml doesn't include these (a photo gallery has no inline-HTML equivalent), so they're surfaced separately here. One array per image gallery section (in section order), each holding that section's image URLs (in image order), fully resolved and ready to use directly. - `careerPageId` (string, required) — The careers page (its referral link ID) this position was fetched through. - `idForEmbedded` (string, required) — `.` — the value to use for the embedded widget for this position via this careers page. See the Embedded Widget guide. - `jobUrl` (string, required) — Public job position page on this careers page. - `applyUrl` (string, required) — Direct link to the application form via this careers page. - `vouchUrl` (string, required) — Direct link to the referral (vouch) form via this careers page. - `connectUrl` (string, required) — Direct link to the connect-with-company form for this careers page. Company-level (not position-specific) — the same URL applies across all positions on this page. ### Location - `id` (string, required) - `address` (string, required) - `city` (string, required) - `country` (string, required) - `locality` (string, required, nullable) - `postalCode` (string, required, nullable) - `administrativeArea` (string, required, nullable) - `subAdministrativeArea` (string, required, nullable) - `lat` (double, required) - `lng` (double, required) ### Company - `id` (string, required) - `name` (string, required) - `slug` (string, required) - `website` (string, required) - `logoUrl` (string, required, nullable) - `industries` (list of enum, required) - Allowed values: `AKVAKULTUR`, `HAVBRUK`, `FISKERI`, `EMPLOYER_EMPLOYEE_ORGANIZATIONS`, `ARCHITECTURE_AREA`, `ARCHIVE_LIBRARY`, `BANK`, `CHILD_SCHOOL_EDUCATION`, `CAR_VEHICLE_WORKSHOP`, `CAR_PARTS_MANUFACTURING`, `STORE_RETAIL`, `CONSTRUCTION`, `MAINTENANCE_SERVICES`, `ANIMALS_ANIMAL_HEALTH`, `REAL_ESTATE`, `ELECTRONICS`, `EVENTS`, `PHARMACEUTICAL_MEDICINE`, `FINANCE`, `PUBLISHING_PRINTING`, `INSURANCE`, `RESEARCH_EDUCATION_SCIENCE`, `WHOLESALE_IMPORT_EXPORT`, `HR`, `HEALTHCARE`, `HOTEL_ACCOMMODATION`, `INFORMATION_TECHNOLOGY`, `NON_PROFIT_ORGANIZATIONS`, `SPORTS_TRAINING`, `INDUSTRY_MANUFACTURING`, `ONLINE_SERVICES`, `LEGAL_SERVICES`, `CHEMICAL_INDUSTRY`, `CONSULTING_ADVISORY`, `POWER_ENERGY`, `ART_CULTURE`, `AVIATION`, `MARITIME_OFFSHORE`, `MARKET_ANALYSIS`, `MARKETING_ADVERTISING`, `FOOD_PRODUCTION_INDUSTRY`, `MEDIA_CONTENT_PRODUCTION`, `MEDICAL_EQUIPMENT_SUPPLIES`, `ENVIRONMENTAL_SERVICES`, `MUSEUMS_GALLERIES_CULTURAL_HERITAGE`, `MUSIC`, `PUBLIC_ADMINISTRATION`, `OIL_GAS`, `ORGANIZATIONS`, `ORGANIZATION_DEVELOPMENT`, `PR_INFORMATION_COMMUNICATION`, `POLICE_SECURITY`, `TRAVEL_TOURISM`, `RECRUITMENT`, `WASTE_CLEANING`, `RESTAURANT_FOOD_NIGHTLIFE`, `SHIPPING`, `TELECOMMUNICATIONS`, `TRANSPORT_LOGISTICS`, `ENTERTAINMENT`, `ECONOMY_ACCOUNTING`, `VENTURE_CAPITAL`, `SOFTWARE_DEVELOPMENT`, `PRIVATE_EQUITY`, `OTHER`, `SPACE`, `GROUND_STATION` - `country` (string, required) - `language` (enum, required, nullable) - Allowed values: `NO`, `DK`, `EN`, `SE`, `GB` - `brandColor` (string, required, nullable) - `bannerUrl` (string, required, nullable) - `socialMediaLinks` (map from string to string, required) - `contentHtml` (string, required) — The company's text-only description as HTML (job-board tag subset). This is what job boards receive: a manually edited text when the company has one, otherwise the text derived from the company's sections. - `contentHtmlDefault` (string, required) — The text derived from the company sections, regardless of any manual edit. - `contentHtmlOverride` (string, required, nullable) — The manually edited text, or null when contentHtml is the derived default. - `locations` (list of Location, required) - `images` (list of list of string, required) — The company's image gallery sections — contentHtml doesn't include these (a photo gallery has no inline-HTML equivalent), so they're surfaced separately here. One array per image gallery section (in section order), each holding that section's image URLs (in image order), fully resolved and ready to use directly. ### CareerPagePositionSalary - `type` (string, required, nullable) - `currency` (enum, required, nullable) - Allowed values: `NOK`, `SEK`, `DKK`, `EUR`, `GBP`, `USD`, `CAD`, `AUD` - `minSalary` (double, required, nullable) - `maxSalary` (double, required, nullable) - `extra` (string, required, nullable) ## Examples **Request** ```json {} ``` **Response** ```json { "data": { "id": "pos_9f8b7c6d5e4a3b2c1d0e", "title": "Senior Software Engineer", "pitch": "Join our dynamic team to build scalable web applications and innovate in cloud technologies.", "status": "PUBLISHED", "language": "EN", "employmentType": [ "Full-time", "Remote", "Hybrid" ], "listingColor": "#0052cc", "bannerUrl": "https://cdn.vouch.careers/banners/pos_9f8b7c6d5e4a3b2c1d0e.jpg", "locations": [ { "id": "loc_1234567890abcdef", "address": "500 Tech Park Drive", "city": "San Francisco", "country": "USA", "locality": "Bay Area", "postalCode": "94107", "administrativeArea": "CA", "subAdministrativeArea": "San Francisco County", "lat": 37.7749, "lng": -122.4194 } ], "createdAt": "2023-11-01T08:00:00Z", "updatedAt": "2024-04-10T12:00:00Z", "publishedAt": "2024-04-15T09:00:00Z", "lastPublishedAt": "2024-04-15T09:00:00Z", "firstActivatedAt": "2024-04-01T08:00:00Z", "expirationDate": "2024-10-01T23:59:59Z", "enableApplication": true, "enableVouch": true, "company": { "id": "comp_abcdef1234567890", "name": "Innovatech Solutions", "slug": "innovatech-solutions", "website": "https://www.innovatech.com", "logoUrl": "https://cdn.vouch.careers/logos/innovatech.png", "industries": [ "SOFTWARE_DEVELOPMENT", "INFORMATION_TECHNOLOGY" ], "country": "USA", "language": "EN", "brandColor": "#0073e6", "bannerUrl": "https://cdn.vouch.careers/banners/innovatech-banner.jpg", "socialMediaLinks": { "linkedin": "https://linkedin.com/company/innovatech", "twitter": "https://twitter.com/innovatech" }, "contentHtml": "

Innovatech Solutions is a leading software development company focused on cloud and AI technologies.

", "contentHtmlDefault": "

Innovatech Solutions specializes in delivering innovative software solutions worldwide.

", "contentHtmlOverride": null, "locations": [ { "id": "loc_comp_001", "address": "100 Innovation Way", "city": "San Francisco", "country": "USA", "locality": "Bay Area", "postalCode": "94105", "administrativeArea": "CA", "subAdministrativeArea": "San Francisco County", "lat": 37.789, "lng": -122.401 } ], "images": [ [ "https://cdn.vouch.careers/company/innovatech/office1.jpg", "https://cdn.vouch.careers/company/innovatech/team.jpg" ] ] }, "highlights": [ "Flexible working hours", "Competitive salary and benefits", "Opportunity to work with cutting-edge technology" ], "salary": { "type": "Annual", "currency": "USD", "minSalary": 90000, "maxSalary": 130000, "extra": "Includes stock options and performance bonuses" }, "contentHtml": "

As a Senior Software Engineer, you will design and implement scalable backend services and collaborate with cross-functional teams.

", "contentHtmlDefault": "

This position involves software development, code reviews, and mentoring junior engineers.

", "contentHtmlOverride": null, "images": [ [ "https://cdn.vouch.careers/positions/pos_9f8b7c6d5e4a3b2c1d0e/office.jpg", "https://cdn.vouch.careers/positions/pos_9f8b7c6d5e4a3b2c1d0e/team.jpg" ] ], "careerPageId": "cp_1234abcd5678efgh", "idForEmbedded": "cp_1234abcd5678efgh.pos_9f8b7c6d5e4a3b2c1d0e", "jobUrl": "https://careers.innovatech.com/positions/senior-software-engineer", "applyUrl": "https://careers.innovatech.com/apply/senior-software-engineer", "vouchUrl": "https://careers.innovatech.com/vouch/senior-software-engineer", "connectUrl": "https://careers.innovatech.com/connect" } } ``` **SDK Code** ```python import requests url = "https://vouch.careers/api/v1/career-pages/id/positions/positionId" payload = {} headers = { "Authorization": "Bearer ", "Content-Type": "application/json" } response = requests.get(url, json=payload, headers=headers) print(response.json()) ``` ```javascript const url = 'https://vouch.careers/api/v1/career-pages/id/positions/positionId'; const options = { method: 'GET', headers: {Authorization: 'Bearer ', 'Content-Type': 'application/json'}, body: '{}' }; try { const response = await fetch(url, options); const data = await response.json(); console.log(data); } catch (error) { console.error(error); } ``` ```go package main import ( "fmt" "strings" "net/http" "io" ) func main() { url := "https://vouch.careers/api/v1/career-pages/id/positions/positionId" payload := strings.NewReader("{}") req, _ := http.NewRequest("GET", url, payload) req.Header.Add("Authorization", "Bearer ") req.Header.Add("Content-Type", "application/json") res, _ := http.DefaultClient.Do(req) defer res.Body.Close() body, _ := io.ReadAll(res.Body) fmt.Println(res) fmt.Println(string(body)) } ``` ```ruby require 'uri' require 'net/http' url = URI("https://vouch.careers/api/v1/career-pages/id/positions/positionId") http = Net::HTTP.new(url.host, url.port) http.use_ssl = true request = Net::HTTP::Get.new(url) request["Authorization"] = 'Bearer ' request["Content-Type"] = 'application/json' request.body = "{}" response = http.request(request) puts response.read_body ``` ```java import com.mashape.unirest.http.HttpResponse; import com.mashape.unirest.http.Unirest; HttpResponse response = Unirest.get("https://vouch.careers/api/v1/career-pages/id/positions/positionId") .header("Authorization", "Bearer ") .header("Content-Type", "application/json") .body("{}") .asString(); ``` ```php request('GET', 'https://vouch.careers/api/v1/career-pages/id/positions/positionId', [ 'body' => '{}', 'headers' => [ 'Authorization' => 'Bearer ', 'Content-Type' => 'application/json', ], ]); echo $response->getBody(); ``` ```csharp using RestSharp; var client = new RestClient("https://vouch.careers/api/v1/career-pages/id/positions/positionId"); var request = new RestRequest(Method.GET); request.AddHeader("Authorization", "Bearer "); request.AddHeader("Content-Type", "application/json"); request.AddParameter("application/json", "{}", ParameterType.RequestBody); IRestResponse response = client.Execute(request); ``` ```swift import Foundation let headers = [ "Authorization": "Bearer ", "Content-Type": "application/json" ] let parameters = [] as [String : Any] let postData = JSONSerialization.data(withJSONObject: parameters, options: []) let request = NSMutableURLRequest(url: NSURL(string: "https://vouch.careers/api/v1/career-pages/id/positions/positionId")! as URL, cachePolicy: .useProtocolCachePolicy, timeoutInterval: 10.0) request.httpMethod = "GET" request.allHTTPHeaderFields = headers request.httpBody = postData as Data let session = URLSession.shared let dataTask = session.dataTask(with: request as URLRequest, completionHandler: { (data, response, error) -> Void in if (error != nil) { print(error as Any) } else { let httpResponse = response as? HTTPURLResponse print(httpResponse) } }) dataTask.resume() ```