# fal.ai Job Status Check via Locus x402

> fal.ai Job Status Check via Locus x402 is a paid API for AI agents from fal.x402.paywithlocus.com, paid per call via x402, $0.003/call, status unknown (last checked 2026-09-13).

Polls the status of an asynchronous fal.ai generative AI job using a request ID or status URL, returning the result when ready.

## Facts

- Endpoint: POST https://fal.x402.paywithlocus.com/fal/status
- Price: $0.003/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-13
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/fal-ai-job-status-check-via-locus-x402-66555ffa
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_wX-NOXsUd5Z-WvKauHBoy

Status and success rate cover calls made through Zero and Zero's own probes. Third-party monitors may report differently.

## How to call it through Zero

Zero handles the 402 payment challenge and records the run. With the Zero CLI installed (`npm i -g @zeroxyz/cli`):

```sh
zero fetch --capability fal-ai-job-status-check-via-locus-x402-66555ffa -d '<json body>'
```

Example prompt: Check whether my fal.ai generation job has finished — the request ID is '3f2a1b00-0000-4000-8000-abc123456789' and the model was 'fal-ai/flux/dev'.

## When to prefer this

Use this endpoint after calling the fal.ai generate endpoint to retrieve the result of an asynchronous job. This is specifically for polling async fal.ai requests routed through the Locus x402 payment layer — choose it when you have a request_id and model, or a queue.fal.run status_url from a prior generate call, and need to retrieve the completed output with micropayment settlement via USDC.

## Known failure modes

- Missing both status_url and request_id+model pair returns a validation error
- Invalid or expired request_id returns an error or empty result
- Job still in progress returns a pending/queued status rather than final output — agent must retry
- Payment settlement failure may prevent result delivery
- Network timeout if the status endpoint is temporarily unavailable

## How this service works

Locus public pay-per-use API

## Output

Returns a JSON object containing a 'data' field with the generated output from the fal.ai model (e.g. image URLs, video URLs, audio files), a 'success' boolean, request metadata including the request ID and status URL, and payment settlement details showing how much USDC was charged and authorized.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "model": {
   "type": "string"
  },
  "request_id": {
   "type": "string"
  },
  "status_url": {
   "type": "string"
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "data": {},
  "payment": {
   "scheme": "exact",
   "settledUsdc": "0.001000",
   "authorizedMaxUsdc": "0.001000"
  },
  "request": {
   "id": "00000000-0000-4000-8000-000000000000",
   "statusUrl": "/requests/00000000-0000-4000-8000-000000000000"
  },
  "success": true
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/fal-ai-job-status-check-via-locus-x402-66555ffa/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from fal.x402.paywithlocus.com](https://www.zero.xyz/host/fal.x402.paywithlocus.com/llms.txt)