<!-- https://pricto.dev/docs/api/create-live-check · Spanish version: https://pricto.dev/docs/api/create-live-check.md -->

# Request a live price check

`POST https://pricto.dev/v1/live-checks`

> **Planned.** Not available yet: today it answers `501 not_implemented`.

Captures the offer right now instead of returning the last scheduled capture. Asynchronous: returns a job that completes in seconds to minutes. Not available yet (returns 501).

| Credits | MCP |
|---|---|
| 10 per offer refreshed | — |

## Parameters

No parameters.

## Body

| Field | Type | Description |
|---|---|---|
| `offer_ids` **required** | `string[]` |  |

## Response

`202` Job accepted.

| Field | Type | Description |
|---|---|---|
| `data` | `Job` |  |
| `data.id` **required** | `string` |  |
| `data.status` **required** | `string` | Valores / values: `queued`, `running`, `succeeded`, `failed`. |
| `data.created_at` | `string (date-time)` |  |
| `data.finished_at` | `string (date-time) \| null` |  |
| `data.rows` | `integer \| null` |  |
| `data.files` | `object[]` |  |
| `data.files[].url` | `string (uri)` |  |
| `data.files[].bytes` | `integer` |  |
| `data.files[].expires_at` | `string (date-time)` |  |
| `data.error` | `object` |  |
| `meta` | `Meta` |  |

`meta` carries the cost, the source line to quote, the language, the currency and notices (see [Conventions](/docs/convenciones)).

## Errors

- [`not_implemented`](/docs/errores#not_implemented)

## Example

```bash
curl -X POST "https://pricto.dev/v1/live-checks" \
  -H "Authorization: Bearer sk_test_sandbox" \
  -H "Content-Type: application/json" \
  -d '{"offer_ids":["ofr_01nuni"]}'
```
```python
import requests

API_KEY = "sk_test_sandbox"

r = requests.post(
    "https://pricto.dev/v1/live-checks",
    json={
        "offer_ids": [
            "ofr_01nuni",
        ],
    },
    headers={"Authorization": f"Bearer {API_KEY}"},
)
print(r.status_code, r.json())
```
```js
const API_KEY = "sk_test_sandbox";

const res = await fetch("https://pricto.dev/v1/live-checks", {
  method: "POST",
  headers: { Authorization: `Bearer ${API_KEY}`, "Content-Type": "application/json" },
  body: JSON.stringify({
    "offer_ids": [
      "ofr_01nuni"
    ]
  }),
});
console.log(res.status, await res.json());
```

```json
{
  "type": "https://pricto.dev/docs#not_implemented",
  "title": "Todavía no disponible",
  "status": 501,
  "code": "not_implemented",
  "detail": "Live checks está planificado y todavía no está disponible.",
  "hint": "Para volúmenes grandes usa /offers con format=csv y paginación.",
  "request_id": "req_0f92ea74c35e497c8fdf",
  "docs_url": "https://pricto.dev/docs#not_implemented"
}
```