# Get job details (v1)

Returns a Bayt posting's full description, skills section, pay band in the employer's currency and period, employment type, closing date, company size and the employer's candidate preferences from its link or job ID. `data` is null when the posting does not exist or has expired.

- Platform: Bayt
- Request: `GET https://api.toolzerhub.com/v1/bayt/job`
- Auth: `x-api-key` header
- Cost: 1 credit per successful request. Failed requests are not billed.
- Page: https://docs.toolzerhub.com/reference/bayt/job/get-bayt-job

| Parameter | In | Required | Type | Description |
| --- | --- | --- | --- | --- |
| `job_id_or_url` | query | yes | string | The job_id from a search result, or the posting's bayt.com link, such as https://www.bayt.com/en/uae/jobs/sr-accountant-general-accountant-5504825/. |

## Example request

```bash
curl "https://api.toolzerhub.com/v1/bayt/job?job_id_or_url=<job_id_or_url>" \
  -H "x-api-key: $TOOLZERHUB_API_KEY"
```

Success responses are wrapped as `{ "data": ... }`. Errors return `{ "error": { "code", "status", "message", "retryable", "details" } }`. See https://docs.toolzerhub.com/docs/responses-and-errors.