# Retrieve licensed job content

`GET /v0/jobs/{jobId}/content`

Returns a currently distributable employer-authored description. Company verification alone does not grant description rights.

## Authentication

`bearerAuth` (http bearer) — Organisation API key supplied only through the Authorization header. Required scopes: `jobs:read`.

## Request

### cURL

```shell
curl --request GET \
  --url "https://api.luranta.com/v0/jobs/jobId/content" \
  --header "Authorization: Bearer $LURANTA_API_KEY" \
  --header "Accept: application/json"
```

### TypeScript

```ts
import { Client } from "@luranta/sdk"

const client = new Client({
  apiKey: process.env.LURANTA_API_KEY!,
  baseUrl: "https://api.luranta.com",
  maxRetries: 2,
})

const result = await client.jobs.list()
```

### Python

```python
import os
from luranta import Client

client = Client(
    api_key=os.environ["LURANTA_API_KEY"],
    base_url="https://api.luranta.com",
    timeout=30,
)

result = client.jobs.list()
```

## Path parameters

### `jobId`

`string` · required

UUIDv7 identifier of a currently published open job.

- Type: `string`
  - Description: UUIDv7 identifier of a currently published open job.
  - Format uuid · Pattern ^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-7[0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12})$
  - Format: `uuid`
  - Pattern: `^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-7[0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12})$`

## Responses

### 200

The current approved description and its canonical job identity.

#### Headers

##### `Luranta-Cost-USD`

`string` · optional

Credit consumed as a USD decimal string. Present only on successful billable responses.

- Type: `string`
  - Pattern ^(?:0|[1-9]\d*)\.\d{2,6}$
  - Pattern: `^(?:0|[1-9]\d*)\.\d{2,6}$`

##### `Luranta-Credit-Balance-USD`

`string` · optional

Organisation credit remaining after settlement. Present only on successful billable responses.

- Type: `string`
  - Pattern ^(?:0|[1-9]\d*)\.\d{2,6}$
  - Pattern: `^(?:0|[1-9]\d*)\.\d{2,6}$`

##### `Luranta-Resources-Returned`

`integer` · optional

Number of resources returned and charged. Present only on successful billable responses.

- Type: `integer`
  - Range 0 2147483647
  - Maximum: `2147483647`
  - Minimum: `0`

##### `traceparent`

`string` · required

W3C trace context generated for this request attempt.

- Type: `string`
  - Pattern ^00-[0-9a-f]{32}-[0-9a-f]{16}-[0-9a-f]{2}$
  - Pattern: `^00-[0-9a-f]{32}-[0-9a-f]{16}-[0-9a-f]{2}$`

##### `X-Request-Id`

`string` · required

Unique UUIDv7 identifier for this request attempt.

- Type: `string`
  - Format uuid
  - Format: `uuid`

#### application/json

- Type: `object`
  - Properties:
    - `description` (required):
      - Type: `string`
    - `format` (required):
      - Type: `enum`
        - Constant: `markdown`
    - `jobId` (required):
      - Type: `string`
        - Format uuid · Pattern ^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$
        - Format: `uuid`
        - Pattern: `^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$`
    - `license` (required):
      - Type: `enum`
        - Constant: `employer_publishing_agreement`
    - `postingId` (required):
      - Type: `string`
        - Format uuid · Pattern ^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$
        - Format: `uuid`
        - Pattern: `^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$`
    - `revision` (required):
      - Type: `integer`
        - Maximum 9007199254740991 · Exclusive minimum 0
        - Exclusive minimum: `0`
        - Maximum: `9007199254740991`

### 400

The request contains an invalid parameter, parameter combination, or cursor.

This response uses [Problem Details](/reference/problem-details).

#### Headers

##### `traceparent`

`string` · required

W3C trace context generated for this request attempt.

- Type: `string`
  - Pattern ^00-[0-9a-f]{32}-[0-9a-f]{16}-[0-9a-f]{2}$
  - Pattern: `^00-[0-9a-f]{32}-[0-9a-f]{16}-[0-9a-f]{2}$`

##### `X-Request-Id`

`string` · required

Unique UUIDv7 identifier for this request attempt.

- Type: `string`
  - Format uuid
  - Format: `uuid`

#### application/problem+json

Errors follow [Problem Details](/reference/problem-details).

- Type: `object`
  - Properties:
    - `availableCreditUsd` (optional):
      - Type: `string`
        - Pattern ^(?:0|[1-9]\d*)\.\d{2,6}$
        - Pattern: `^(?:0|[1-9]\d*)\.\d{2,6}$`
    - `code` (required):
      - Type: `string`
        - Range 1 80
        - Maximum length: `80`
        - Minimum length: `1`
    - `detail` (required):
      - Type: `string`
        - Range 1 1000
        - Maximum length: `1000`
        - Minimum length: `1`
    - `errors` (required):
      - Type: `object[]`
        - Range 1 100
        - Maximum items: `100`
        - Minimum items: `1`
        - Items:
          - Type: `object`
            - Properties:
              - `code` (required):
                - Type: `string`
                  - Range 1 80
                  - Maximum length: `80`
                  - Minimum length: `1`
              - `message` (required):
                - Type: `string`
                  - Range 1 500
                  - Maximum length: `500`
                  - Minimum length: `1`
              - `pointer` (required):
                - Type: `string`
                  - Format starts_with · Pattern ^\/.*
                  - Format: `starts_with`
                  - Pattern: `^\/.*`
    - `instance` (required):
      - Type: `string`
        - Format starts_with · Pattern ^\/.*
        - Format: `starts_with`
        - Pattern: `^\/.*`
    - `param` (optional):
      - Type: `string`
        - Range 1 160
        - Maximum length: `160`
        - Minimum length: `1`
    - `requestId` (required):
      - Type: `string`
        - Format uuid · Pattern ^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-7[0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12})$
        - Format: `uuid`
        - Pattern: `^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-7[0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12})$`
    - `requiredCreditUsd` (optional):
      - Type: `string`
        - Pattern ^(?:0|[1-9]\d*)\.\d{2,6}$
        - Pattern: `^(?:0|[1-9]\d*)\.\d{2,6}$`
    - `retryable` (required):
      - Type: `boolean`
    - `status` (required):
      - Type: `integer`
        - Range 400 599
        - Maximum: `599`
        - Minimum: `400`
    - `title` (required):
      - Type: `string`
        - Range 1 120
        - Maximum length: `120`
        - Minimum length: `1`
    - `topUpUrl` (optional):
      - Type: `string`
        - Format uri · Maximum length 2048
        - Format: `uri`
        - Maximum length: `2048`
    - `type` (required):
      - Type: `string`
        - Format uri · Maximum length 2048
        - Format: `uri`
        - Maximum length: `2048`

Example — Invalid request

```json
{
  "code": "invalid_request",
  "detail": "The query cannot be processed as a whole, including conflicting ranges.",
  "errors": [
    {
      "code": "invalid_request",
      "message": "The query cannot be processed as a whole, including conflicting ranges.",
      "pointer": "/"
    }
  ],
  "instance": "/v0/jobs/019faa81-0b1a-77b1-9758-51ff24ab51ae/content",
  "requestId": "019faa81-0b1a-77b1-9758-51ff24ab51ae",
  "retryable": false,
  "status": 400,
  "title": "Invalid request",
  "type": "https://docs.luranta.com/errors/invalid-request"
}
```

### 401

The organisation API key is missing, invalid, expired, or revoked.

This response uses [Problem Details](/reference/problem-details).

#### Headers

##### `traceparent`

`string` · required

W3C trace context generated for this request attempt.

- Type: `string`
  - Pattern ^00-[0-9a-f]{32}-[0-9a-f]{16}-[0-9a-f]{2}$
  - Pattern: `^00-[0-9a-f]{32}-[0-9a-f]{16}-[0-9a-f]{2}$`

##### `X-Request-Id`

`string` · required

Unique UUIDv7 identifier for this request attempt.

- Type: `string`
  - Format uuid
  - Format: `uuid`

#### application/problem+json

Errors follow [Problem Details](/reference/problem-details).

- Type: `object`
  - Properties:
    - `availableCreditUsd` (optional):
      - Type: `string`
        - Pattern ^(?:0|[1-9]\d*)\.\d{2,6}$
        - Pattern: `^(?:0|[1-9]\d*)\.\d{2,6}$`
    - `code` (required):
      - Type: `string`
        - Range 1 80
        - Maximum length: `80`
        - Minimum length: `1`
    - `detail` (required):
      - Type: `string`
        - Range 1 1000
        - Maximum length: `1000`
        - Minimum length: `1`
    - `errors` (required):
      - Type: `object[]`
        - Range 1 100
        - Maximum items: `100`
        - Minimum items: `1`
        - Items:
          - Type: `object`
            - Properties:
              - `code` (required):
                - Type: `string`
                  - Range 1 80
                  - Maximum length: `80`
                  - Minimum length: `1`
              - `message` (required):
                - Type: `string`
                  - Range 1 500
                  - Maximum length: `500`
                  - Minimum length: `1`
              - `pointer` (required):
                - Type: `string`
                  - Format starts_with · Pattern ^\/.*
                  - Format: `starts_with`
                  - Pattern: `^\/.*`
    - `instance` (required):
      - Type: `string`
        - Format starts_with · Pattern ^\/.*
        - Format: `starts_with`
        - Pattern: `^\/.*`
    - `param` (optional):
      - Type: `string`
        - Range 1 160
        - Maximum length: `160`
        - Minimum length: `1`
    - `requestId` (required):
      - Type: `string`
        - Format uuid · Pattern ^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-7[0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12})$
        - Format: `uuid`
        - Pattern: `^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-7[0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12})$`
    - `requiredCreditUsd` (optional):
      - Type: `string`
        - Pattern ^(?:0|[1-9]\d*)\.\d{2,6}$
        - Pattern: `^(?:0|[1-9]\d*)\.\d{2,6}$`
    - `retryable` (required):
      - Type: `boolean`
    - `status` (required):
      - Type: `integer`
        - Range 400 599
        - Maximum: `599`
        - Minimum: `400`
    - `title` (required):
      - Type: `string`
        - Range 1 120
        - Maximum length: `120`
        - Minimum length: `1`
    - `topUpUrl` (optional):
      - Type: `string`
        - Format uri · Maximum length 2048
        - Format: `uri`
        - Maximum length: `2048`
    - `type` (required):
      - Type: `string`
        - Format uri · Maximum length 2048
        - Format: `uri`
        - Maximum length: `2048`

Example — Invalid API key

```json
{
  "code": "invalid_api_key",
  "detail": "The Authorization Bearer token is missing, malformed, expired, or revoked.",
  "errors": [
    {
      "code": "invalid_api_key",
      "message": "The Authorization Bearer token is missing, malformed, expired, or revoked.",
      "pointer": "/"
    }
  ],
  "instance": "/v0/jobs/019faa81-0b1a-77b1-9758-51ff24ab51ae/content",
  "requestId": "019faa81-0b1a-77b1-9758-51ff24ab51ae",
  "retryable": false,
  "status": 401,
  "title": "Invalid API key",
  "type": "https://docs.luranta.com/errors/invalid-api-key"
}
```

### 402

The organisation does not have enough credit to reserve this operation.

This response uses [Problem Details](/reference/problem-details).

#### Headers

##### `traceparent`

`string` · required

W3C trace context generated for this request attempt.

- Type: `string`
  - Pattern ^00-[0-9a-f]{32}-[0-9a-f]{16}-[0-9a-f]{2}$
  - Pattern: `^00-[0-9a-f]{32}-[0-9a-f]{16}-[0-9a-f]{2}$`

##### `X-Request-Id`

`string` · required

Unique UUIDv7 identifier for this request attempt.

- Type: `string`
  - Format uuid
  - Format: `uuid`

#### application/problem+json

Errors follow [Problem Details](/reference/problem-details).

- Type: `object`
  - Properties:
    - `availableCreditUsd` (optional):
      - Type: `string`
        - Pattern ^(?:0|[1-9]\d*)\.\d{2,6}$
        - Pattern: `^(?:0|[1-9]\d*)\.\d{2,6}$`
    - `code` (required):
      - Type: `string`
        - Range 1 80
        - Maximum length: `80`
        - Minimum length: `1`
    - `detail` (required):
      - Type: `string`
        - Range 1 1000
        - Maximum length: `1000`
        - Minimum length: `1`
    - `errors` (required):
      - Type: `object[]`
        - Range 1 100
        - Maximum items: `100`
        - Minimum items: `1`
        - Items:
          - Type: `object`
            - Properties:
              - `code` (required):
                - Type: `string`
                  - Range 1 80
                  - Maximum length: `80`
                  - Minimum length: `1`
              - `message` (required):
                - Type: `string`
                  - Range 1 500
                  - Maximum length: `500`
                  - Minimum length: `1`
              - `pointer` (required):
                - Type: `string`
                  - Format starts_with · Pattern ^\/.*
                  - Format: `starts_with`
                  - Pattern: `^\/.*`
    - `instance` (required):
      - Type: `string`
        - Format starts_with · Pattern ^\/.*
        - Format: `starts_with`
        - Pattern: `^\/.*`
    - `param` (optional):
      - Type: `string`
        - Range 1 160
        - Maximum length: `160`
        - Minimum length: `1`
    - `requestId` (required):
      - Type: `string`
        - Format uuid · Pattern ^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-7[0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12})$
        - Format: `uuid`
        - Pattern: `^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-7[0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12})$`
    - `requiredCreditUsd` (optional):
      - Type: `string`
        - Pattern ^(?:0|[1-9]\d*)\.\d{2,6}$
        - Pattern: `^(?:0|[1-9]\d*)\.\d{2,6}$`
    - `retryable` (required):
      - Type: `boolean`
    - `status` (required):
      - Type: `integer`
        - Range 400 599
        - Maximum: `599`
        - Minimum: `400`
    - `title` (required):
      - Type: `string`
        - Range 1 120
        - Maximum length: `120`
        - Minimum length: `1`
    - `topUpUrl` (optional):
      - Type: `string`
        - Format uri · Maximum length 2048
        - Format: `uri`
        - Maximum length: `2048`
    - `type` (required):
      - Type: `string`
        - Format uri · Maximum length 2048
        - Format: `uri`
        - Maximum length: `2048`

Example — Insufficient credits

```json
{
  "availableCreditUsd": "0.000000",
  "code": "insufficient_credits",
  "detail": "The organisation wallet cannot fund the maximum resources requested.",
  "errors": [
    {
      "code": "insufficient_credits",
      "message": "The organisation wallet cannot fund the maximum resources requested.",
      "pointer": "/"
    }
  ],
  "instance": "/v0/jobs/019faa81-0b1a-77b1-9758-51ff24ab51ae/content",
  "requestId": "019faa81-0b1a-77b1-9758-51ff24ab51ae",
  "requiredCreditUsd": "0.020000",
  "retryable": false,
  "status": 402,
  "title": "Insufficient credits",
  "topUpUrl": "https://luranta.com/settings",
  "type": "https://docs.luranta.com/errors/insufficient-credits"
}
```

### 403

The authenticated organisation lacks the required scope, or the browser origin is not allowed.

This response uses [Problem Details](/reference/problem-details).

#### Headers

##### `traceparent`

`string` · required

W3C trace context generated for this request attempt.

- Type: `string`
  - Pattern ^00-[0-9a-f]{32}-[0-9a-f]{16}-[0-9a-f]{2}$
  - Pattern: `^00-[0-9a-f]{32}-[0-9a-f]{16}-[0-9a-f]{2}$`

##### `X-Request-Id`

`string` · required

Unique UUIDv7 identifier for this request attempt.

- Type: `string`
  - Format uuid
  - Format: `uuid`

#### application/problem+json

Errors follow [Problem Details](/reference/problem-details).

- Type: `object`
  - Properties:
    - `availableCreditUsd` (optional):
      - Type: `string`
        - Pattern ^(?:0|[1-9]\d*)\.\d{2,6}$
        - Pattern: `^(?:0|[1-9]\d*)\.\d{2,6}$`
    - `code` (required):
      - Type: `string`
        - Range 1 80
        - Maximum length: `80`
        - Minimum length: `1`
    - `detail` (required):
      - Type: `string`
        - Range 1 1000
        - Maximum length: `1000`
        - Minimum length: `1`
    - `errors` (required):
      - Type: `object[]`
        - Range 1 100
        - Maximum items: `100`
        - Minimum items: `1`
        - Items:
          - Type: `object`
            - Properties:
              - `code` (required):
                - Type: `string`
                  - Range 1 80
                  - Maximum length: `80`
                  - Minimum length: `1`
              - `message` (required):
                - Type: `string`
                  - Range 1 500
                  - Maximum length: `500`
                  - Minimum length: `1`
              - `pointer` (required):
                - Type: `string`
                  - Format starts_with · Pattern ^\/.*
                  - Format: `starts_with`
                  - Pattern: `^\/.*`
    - `instance` (required):
      - Type: `string`
        - Format starts_with · Pattern ^\/.*
        - Format: `starts_with`
        - Pattern: `^\/.*`
    - `param` (optional):
      - Type: `string`
        - Range 1 160
        - Maximum length: `160`
        - Minimum length: `1`
    - `requestId` (required):
      - Type: `string`
        - Format uuid · Pattern ^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-7[0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12})$
        - Format: `uuid`
        - Pattern: `^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-7[0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12})$`
    - `requiredCreditUsd` (optional):
      - Type: `string`
        - Pattern ^(?:0|[1-9]\d*)\.\d{2,6}$
        - Pattern: `^(?:0|[1-9]\d*)\.\d{2,6}$`
    - `retryable` (required):
      - Type: `boolean`
    - `status` (required):
      - Type: `integer`
        - Range 400 599
        - Maximum: `599`
        - Minimum: `400`
    - `title` (required):
      - Type: `string`
        - Range 1 120
        - Maximum length: `120`
        - Minimum length: `1`
    - `topUpUrl` (optional):
      - Type: `string`
        - Format uri · Maximum length 2048
        - Format: `uri`
        - Maximum length: `2048`
    - `type` (required):
      - Type: `string`
        - Format uri · Maximum length 2048
        - Format: `uri`
        - Maximum length: `2048`

Example — Insufficient scope

```json
{
  "code": "insufficient_scope",
  "detail": "The credential does not grant the scope required by the operation.",
  "errors": [
    {
      "code": "insufficient_scope",
      "message": "The credential does not grant the scope required by the operation.",
      "pointer": "/"
    }
  ],
  "instance": "/v0/jobs/019faa81-0b1a-77b1-9758-51ff24ab51ae/content",
  "requestId": "019faa81-0b1a-77b1-9758-51ff24ab51ae",
  "retryable": false,
  "status": 403,
  "title": "Insufficient scope",
  "type": "https://docs.luranta.com/errors/insufficient-scope"
}
```

### 404

The requested resource does not exist or is not available to this organisation.

This response uses [Problem Details](/reference/problem-details).

#### Headers

##### `traceparent`

`string` · required

W3C trace context generated for this request attempt.

- Type: `string`
  - Pattern ^00-[0-9a-f]{32}-[0-9a-f]{16}-[0-9a-f]{2}$
  - Pattern: `^00-[0-9a-f]{32}-[0-9a-f]{16}-[0-9a-f]{2}$`

##### `X-Request-Id`

`string` · required

Unique UUIDv7 identifier for this request attempt.

- Type: `string`
  - Format uuid
  - Format: `uuid`

#### application/problem+json

Errors follow [Problem Details](/reference/problem-details).

- Type: `object`
  - Properties:
    - `availableCreditUsd` (optional):
      - Type: `string`
        - Pattern ^(?:0|[1-9]\d*)\.\d{2,6}$
        - Pattern: `^(?:0|[1-9]\d*)\.\d{2,6}$`
    - `code` (required):
      - Type: `string`
        - Range 1 80
        - Maximum length: `80`
        - Minimum length: `1`
    - `detail` (required):
      - Type: `string`
        - Range 1 1000
        - Maximum length: `1000`
        - Minimum length: `1`
    - `errors` (required):
      - Type: `object[]`
        - Range 1 100
        - Maximum items: `100`
        - Minimum items: `1`
        - Items:
          - Type: `object`
            - Properties:
              - `code` (required):
                - Type: `string`
                  - Range 1 80
                  - Maximum length: `80`
                  - Minimum length: `1`
              - `message` (required):
                - Type: `string`
                  - Range 1 500
                  - Maximum length: `500`
                  - Minimum length: `1`
              - `pointer` (required):
                - Type: `string`
                  - Format starts_with · Pattern ^\/.*
                  - Format: `starts_with`
                  - Pattern: `^\/.*`
    - `instance` (required):
      - Type: `string`
        - Format starts_with · Pattern ^\/.*
        - Format: `starts_with`
        - Pattern: `^\/.*`
    - `param` (optional):
      - Type: `string`
        - Range 1 160
        - Maximum length: `160`
        - Minimum length: `1`
    - `requestId` (required):
      - Type: `string`
        - Format uuid · Pattern ^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-7[0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12})$
        - Format: `uuid`
        - Pattern: `^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-7[0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12})$`
    - `requiredCreditUsd` (optional):
      - Type: `string`
        - Pattern ^(?:0|[1-9]\d*)\.\d{2,6}$
        - Pattern: `^(?:0|[1-9]\d*)\.\d{2,6}$`
    - `retryable` (required):
      - Type: `boolean`
    - `status` (required):
      - Type: `integer`
        - Range 400 599
        - Maximum: `599`
        - Minimum: `400`
    - `title` (required):
      - Type: `string`
        - Range 1 120
        - Maximum length: `120`
        - Minimum length: `1`
    - `topUpUrl` (optional):
      - Type: `string`
        - Format uri · Maximum length 2048
        - Format: `uri`
        - Maximum length: `2048`
    - `type` (required):
      - Type: `string`
        - Format uri · Maximum length 2048
        - Format: `uri`
        - Maximum length: `2048`

Example — Not found

```json
{
  "code": "not_found",
  "detail": "The requested job or company does not exist or is not commercially available.",
  "errors": [
    {
      "code": "not_found",
      "message": "The requested job or company does not exist or is not commercially available.",
      "pointer": "/"
    }
  ],
  "instance": "/v0/jobs/019faa81-0b1a-77b1-9758-51ff24ab51ae/content",
  "requestId": "019faa81-0b1a-77b1-9758-51ff24ab51ae",
  "retryable": false,
  "status": 404,
  "title": "Not found",
  "type": "https://docs.luranta.com/errors/not-found"
}
```

### 408

The server did not complete the request in time. This failure is non-billable and may be retried.

This response uses [Problem Details](/reference/problem-details).

#### Headers

##### `Retry-After`

`integer` · optional

Minimum number of seconds before retrying when supplied.

- Type: `integer`
  - Range 0 2147483647
  - Maximum: `2147483647`
  - Minimum: `0`

##### `traceparent`

`string` · required

W3C trace context generated for this request attempt.

- Type: `string`
  - Pattern ^00-[0-9a-f]{32}-[0-9a-f]{16}-[0-9a-f]{2}$
  - Pattern: `^00-[0-9a-f]{32}-[0-9a-f]{16}-[0-9a-f]{2}$`

##### `X-Request-Id`

`string` · required

Unique UUIDv7 identifier for this request attempt.

- Type: `string`
  - Format uuid
  - Format: `uuid`

#### application/problem+json

Errors follow [Problem Details](/reference/problem-details).

- Type: `object`
  - Properties:
    - `availableCreditUsd` (optional):
      - Type: `string`
        - Pattern ^(?:0|[1-9]\d*)\.\d{2,6}$
        - Pattern: `^(?:0|[1-9]\d*)\.\d{2,6}$`
    - `code` (required):
      - Type: `string`
        - Range 1 80
        - Maximum length: `80`
        - Minimum length: `1`
    - `detail` (required):
      - Type: `string`
        - Range 1 1000
        - Maximum length: `1000`
        - Minimum length: `1`
    - `errors` (required):
      - Type: `object[]`
        - Range 1 100
        - Maximum items: `100`
        - Minimum items: `1`
        - Items:
          - Type: `object`
            - Properties:
              - `code` (required):
                - Type: `string`
                  - Range 1 80
                  - Maximum length: `80`
                  - Minimum length: `1`
              - `message` (required):
                - Type: `string`
                  - Range 1 500
                  - Maximum length: `500`
                  - Minimum length: `1`
              - `pointer` (required):
                - Type: `string`
                  - Format starts_with · Pattern ^\/.*
                  - Format: `starts_with`
                  - Pattern: `^\/.*`
    - `instance` (required):
      - Type: `string`
        - Format starts_with · Pattern ^\/.*
        - Format: `starts_with`
        - Pattern: `^\/.*`
    - `param` (optional):
      - Type: `string`
        - Range 1 160
        - Maximum length: `160`
        - Minimum length: `1`
    - `requestId` (required):
      - Type: `string`
        - Format uuid · Pattern ^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-7[0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12})$
        - Format: `uuid`
        - Pattern: `^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-7[0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12})$`
    - `requiredCreditUsd` (optional):
      - Type: `string`
        - Pattern ^(?:0|[1-9]\d*)\.\d{2,6}$
        - Pattern: `^(?:0|[1-9]\d*)\.\d{2,6}$`
    - `retryable` (required):
      - Type: `boolean`
    - `status` (required):
      - Type: `integer`
        - Range 400 599
        - Maximum: `599`
        - Minimum: `400`
    - `title` (required):
      - Type: `string`
        - Range 1 120
        - Maximum length: `120`
        - Minimum length: `1`
    - `topUpUrl` (optional):
      - Type: `string`
        - Format uri · Maximum length 2048
        - Format: `uri`
        - Maximum length: `2048`
    - `type` (required):
      - Type: `string`
        - Format uri · Maximum length 2048
        - Format: `uri`
        - Maximum length: `2048`

Example — Invalid request

```json
{
  "code": "invalid_request",
  "detail": "The query cannot be processed as a whole, including conflicting ranges.",
  "errors": [
    {
      "code": "invalid_request",
      "message": "The query cannot be processed as a whole, including conflicting ranges.",
      "pointer": "/"
    }
  ],
  "instance": "/v0/jobs/019faa81-0b1a-77b1-9758-51ff24ab51ae/content",
  "requestId": "019faa81-0b1a-77b1-9758-51ff24ab51ae",
  "retryable": false,
  "status": 400,
  "title": "Invalid request",
  "type": "https://docs.luranta.com/errors/invalid-request"
}
```

### 429

The organisation request rate was exceeded. Retry after the indicated delay.

This response uses [Problem Details](/reference/problem-details).

#### Headers

##### `Retry-After`

`integer` · optional

Minimum number of seconds before retrying when supplied.

- Type: `integer`
  - Range 0 2147483647
  - Maximum: `2147483647`
  - Minimum: `0`

##### `traceparent`

`string` · required

W3C trace context generated for this request attempt.

- Type: `string`
  - Pattern ^00-[0-9a-f]{32}-[0-9a-f]{16}-[0-9a-f]{2}$
  - Pattern: `^00-[0-9a-f]{32}-[0-9a-f]{16}-[0-9a-f]{2}$`

##### `X-Request-Id`

`string` · required

Unique UUIDv7 identifier for this request attempt.

- Type: `string`
  - Format uuid
  - Format: `uuid`

#### application/problem+json

Errors follow [Problem Details](/reference/problem-details).

- Type: `object`
  - Properties:
    - `availableCreditUsd` (optional):
      - Type: `string`
        - Pattern ^(?:0|[1-9]\d*)\.\d{2,6}$
        - Pattern: `^(?:0|[1-9]\d*)\.\d{2,6}$`
    - `code` (required):
      - Type: `string`
        - Range 1 80
        - Maximum length: `80`
        - Minimum length: `1`
    - `detail` (required):
      - Type: `string`
        - Range 1 1000
        - Maximum length: `1000`
        - Minimum length: `1`
    - `errors` (required):
      - Type: `object[]`
        - Range 1 100
        - Maximum items: `100`
        - Minimum items: `1`
        - Items:
          - Type: `object`
            - Properties:
              - `code` (required):
                - Type: `string`
                  - Range 1 80
                  - Maximum length: `80`
                  - Minimum length: `1`
              - `message` (required):
                - Type: `string`
                  - Range 1 500
                  - Maximum length: `500`
                  - Minimum length: `1`
              - `pointer` (required):
                - Type: `string`
                  - Format starts_with · Pattern ^\/.*
                  - Format: `starts_with`
                  - Pattern: `^\/.*`
    - `instance` (required):
      - Type: `string`
        - Format starts_with · Pattern ^\/.*
        - Format: `starts_with`
        - Pattern: `^\/.*`
    - `param` (optional):
      - Type: `string`
        - Range 1 160
        - Maximum length: `160`
        - Minimum length: `1`
    - `requestId` (required):
      - Type: `string`
        - Format uuid · Pattern ^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-7[0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12})$
        - Format: `uuid`
        - Pattern: `^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-7[0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12})$`
    - `requiredCreditUsd` (optional):
      - Type: `string`
        - Pattern ^(?:0|[1-9]\d*)\.\d{2,6}$
        - Pattern: `^(?:0|[1-9]\d*)\.\d{2,6}$`
    - `retryable` (required):
      - Type: `boolean`
    - `status` (required):
      - Type: `integer`
        - Range 400 599
        - Maximum: `599`
        - Minimum: `400`
    - `title` (required):
      - Type: `string`
        - Range 1 120
        - Maximum length: `120`
        - Minimum length: `1`
    - `topUpUrl` (optional):
      - Type: `string`
        - Format uri · Maximum length 2048
        - Format: `uri`
        - Maximum length: `2048`
    - `type` (required):
      - Type: `string`
        - Format uri · Maximum length 2048
        - Format: `uri`
        - Maximum length: `2048`

Example — Rate limit exceeded

```json
{
  "code": "rate_limit_exceeded",
  "detail": "The organisation exceeded its shared request rate. Honour Retry-After.",
  "errors": [
    {
      "code": "rate_limit_exceeded",
      "message": "The organisation exceeded its shared request rate. Honour Retry-After.",
      "pointer": "/"
    }
  ],
  "instance": "/v0/jobs/019faa81-0b1a-77b1-9758-51ff24ab51ae/content",
  "requestId": "019faa81-0b1a-77b1-9758-51ff24ab51ae",
  "retryable": true,
  "status": 429,
  "title": "Rate limit exceeded",
  "type": "https://docs.luranta.com/errors/rate-limit-exceeded"
}
```

### 503

The service or durable usage settlement is temporarily unavailable. This failure is non-billable.

This response uses [Problem Details](/reference/problem-details).

#### Headers

##### `Retry-After`

`integer` · optional

Minimum number of seconds before retrying when supplied.

- Type: `integer`
  - Range 0 2147483647
  - Maximum: `2147483647`
  - Minimum: `0`

##### `traceparent`

`string` · required

W3C trace context generated for this request attempt.

- Type: `string`
  - Pattern ^00-[0-9a-f]{32}-[0-9a-f]{16}-[0-9a-f]{2}$
  - Pattern: `^00-[0-9a-f]{32}-[0-9a-f]{16}-[0-9a-f]{2}$`

##### `X-Request-Id`

`string` · required

Unique UUIDv7 identifier for this request attempt.

- Type: `string`
  - Format uuid
  - Format: `uuid`

#### application/problem+json

Errors follow [Problem Details](/reference/problem-details).

- Type: `object`
  - Properties:
    - `availableCreditUsd` (optional):
      - Type: `string`
        - Pattern ^(?:0|[1-9]\d*)\.\d{2,6}$
        - Pattern: `^(?:0|[1-9]\d*)\.\d{2,6}$`
    - `code` (required):
      - Type: `string`
        - Range 1 80
        - Maximum length: `80`
        - Minimum length: `1`
    - `detail` (required):
      - Type: `string`
        - Range 1 1000
        - Maximum length: `1000`
        - Minimum length: `1`
    - `errors` (required):
      - Type: `object[]`
        - Range 1 100
        - Maximum items: `100`
        - Minimum items: `1`
        - Items:
          - Type: `object`
            - Properties:
              - `code` (required):
                - Type: `string`
                  - Range 1 80
                  - Maximum length: `80`
                  - Minimum length: `1`
              - `message` (required):
                - Type: `string`
                  - Range 1 500
                  - Maximum length: `500`
                  - Minimum length: `1`
              - `pointer` (required):
                - Type: `string`
                  - Format starts_with · Pattern ^\/.*
                  - Format: `starts_with`
                  - Pattern: `^\/.*`
    - `instance` (required):
      - Type: `string`
        - Format starts_with · Pattern ^\/.*
        - Format: `starts_with`
        - Pattern: `^\/.*`
    - `param` (optional):
      - Type: `string`
        - Range 1 160
        - Maximum length: `160`
        - Minimum length: `1`
    - `requestId` (required):
      - Type: `string`
        - Format uuid · Pattern ^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-7[0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12})$
        - Format: `uuid`
        - Pattern: `^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-7[0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12})$`
    - `requiredCreditUsd` (optional):
      - Type: `string`
        - Pattern ^(?:0|[1-9]\d*)\.\d{2,6}$
        - Pattern: `^(?:0|[1-9]\d*)\.\d{2,6}$`
    - `retryable` (required):
      - Type: `boolean`
    - `status` (required):
      - Type: `integer`
        - Range 400 599
        - Maximum: `599`
        - Minimum: `400`
    - `title` (required):
      - Type: `string`
        - Range 1 120
        - Maximum length: `120`
        - Minimum length: `1`
    - `topUpUrl` (optional):
      - Type: `string`
        - Format uri · Maximum length 2048
        - Format: `uri`
        - Maximum length: `2048`
    - `type` (required):
      - Type: `string`
        - Format uri · Maximum length 2048
        - Format: `uri`
        - Maximum length: `2048`

Example — Service unavailable

```json
{
  "code": "service_unavailable",
  "detail": "Authentication or the data plane could not complete the request safely.",
  "errors": [
    {
      "code": "service_unavailable",
      "message": "Authentication or the data plane could not complete the request safely.",
      "pointer": "/"
    }
  ],
  "instance": "/v0/jobs/019faa81-0b1a-77b1-9758-51ff24ab51ae/content",
  "requestId": "019faa81-0b1a-77b1-9758-51ff24ab51ae",
  "retryable": true,
  "status": 503,
  "title": "Service unavailable",
  "type": "https://docs.luranta.com/errors/service-unavailable"
}
```

## Pricing

Estimate the cost of successful retrieve licensed job content usage.

### Jobs

- Unit price: `$0.001`
- Charging rule: Charged for each job returned by a successful response.

| Resources | Estimated cost |
| ---: | ---: |
| 1,000 | $1.00 |
| 10,000 | $10.00 |
| 25,000 | $25.00 |
| 50,000 | $50.00 |

### Charging metadata

- Count path: `.`
- Meter: `job_resource`
- Model: `returned_resource`
- Resource: `job`
- Unit price usd: `0.001`