# Stream job status

Returns progress counters for a stream job. Poll to track completion
without consuming webhook deliveries.

Endpoint: GET /stream/{id}
Version: 4.0
Security: ApiKeyAuth, BearerAuth, BasicAuth

## Security:

  - `ApiKeyAuth` (unknown)
    apiKey in header x-api-key

  - `BearerAuth` (unknown)
    http bearer JWT

  - `BasicAuth` (unknown)
    http basic

## Path parameters:

  - `id` (string, required)
    MongoDB ObjectId of the stream job.

## Response 200:

  - `200` (unknown)
    Stream job status

## Response 200 fields (application/json):

  - `error` (boolean)
    Example: false

  - `job_id` (string)

  - `status` (string)
    | Value | Meaning |
|  --- | --- |
| `new` | Created, queued for processing |
| `working` | Crawls in progress |
| `finished` | All results assembled |
| `failed` | Timed out or unrecoverable error |
    Enum: "new", "working", "finished", "failed"

  - `source` (string)

  - `country` (string)

  - `values_total` (integer)
    Total values submitted.

  - `values_done` (integer)
    Values with a result (success or error).

  - `values_errors` (integer)
    Values that resulted in an error.

  - `is_final` (boolean)
    `true` when all values have been processed.

  - `created_at` (string)

  - `finished_at` (string)

  - `client_ref` (string)

  - `message` (string)
    Example: country not supported by source

## Response 401:

  - `401` (unknown)
    Missing or invalid credentials.

## Response 401 fields (application/json):

  - `error` (string)
    Example: user not found

  - `message` (string)

## Response 403:

  - `403` (unknown)
    Authenticated but not subscribed to this source/country.

## Response 403 fields (application/json):

  - `error` (string)
    Example: user not found

  - `message` (string)