---
title: "Read job URL"
method: POST
path: "/v1/read_job_url"
tags: ["jobs"]
---

# Read job URL

`POST /v1/read_job_url`

## Request

- Base URL: `https://api.trylitos.com`
- URL: `https://api.trylitos.com/v1/read_job_url`
- Auth: OAuth 2 (authorization code, authorization URL `https://api.trylitos.com/oauth/authorize`, token URL `https://api.trylitos.com/oauth/token`, scopes: `jobs:read`)

Read a job posting from any https URL the student found elsewhere: returns the description, and the company, role and Litos job_id when it can identify them. Use it before create_application for a posting that is not on the board.

## Request body

- object
  - `job_url` string, uri, required

## Response `200`

The operation's result. Shapes mirror the Litos dashboard routes they proxy.

- object

## Other responses

- `4XX`: A refusal, carrying `error` (a sentence) and usually `code`.

---

[API](https://skmtc.dev/trylitos/apis/litos-api.md) · [All operations](https://skmtc.dev/trylitos/apis/litos-api/llms.txt) · [OpenAPI document](https://skmtc.dev/trylitos/apis/litos-api/revisions/d0ae6f04b1ae?raw)