# Dice Job Detail API Documentation

Retrieve one public Dice job by its id (the UUID from the Dice job url, also the id field of the search endpoint): title, company with Dice profile url and logo, location, employment type, salary when the employer lists one, required skills, publish and expiry date (ISO 8601, UTC), the full description as HTML and as plain text, and the public Dice url. An unknown or expired job id returns a not found error that is not billed.

- **Documentation:** [https://scrappa.co/docs/dice-api/dice_job](https://scrappa.co/docs/dice-api/dice_job)
- **API group:** Dice API
- **Endpoint:** `GET https://scrappa.co/api/dice/job`

## Authentication

Send your Scrappa API key in the `X-API-KEY` request header. Paid endpoints also support accountless x402 payments when called without an API key.

## Parameters

| Parameter | Type | Required | Description |
| --- | --- | --- | --- |
| `id` | string | Yes | Dice job UUID, e.g. 7a714775-1db0-41ba-8dad-acaefae17d5b. Example: 7a714775-1db0-41ba-8dad-acaefae17d5b. |

## Example request

```bash
#!/bin/bash

curl -X GET \
    -H "x-api-key: YOUR_API_KEY_HERE" \
    "https://scrappa.co/api/dice/job?id=7a714775-1db0-41ba-8dad-acaefae17d5b"
```

## Errors

| Status | Error | Description |
| --- | --- | --- |
| 422 | Validation Error | A required query parameter is missing or invalid. This response is not billable. |
| 404 | Job Not Found | The Dice job does not exist or has expired. This response is not billable. |
| 503 | Invalid Source Response | Dice answered with a page or payload that no longer matches the documented contract. This response is not billable. |
| 503 | Service Unavailable | The upstream service is temporarily unavailable. Please retry shortly. |

## More Scrappa resources

- [API documentation](https://scrappa.co/docs)
- [Full LLM-readable API reference](https://scrappa.co/llms-full.txt)
- [OpenAPI specification](https://scrappa.co/docs/api.json)
- [Pricing](https://scrappa.co/pricing)