# Get a job

Scope `read`. State, files, the run, findings and financials in one call.

## Endpoint

`GET /v1/api/jobs/{id}`

## Parameters

| Name | In | Type | Required |
| --- | --- | --- | --- |
| id | path | string | Yes |

- **id:** The job's id.

## Responses

### 200

The job.

Content type: `application/json`.

```json
{
  "data": {
    "id": "",
    "state": "awaiting_start",
    "files": [
      {
        "id": "",
        "name": "string",
        "contentType": "string",
        "sizeBytes": 1,
        "documentType": "string",
        "periodStart": "string",
        "periodEnd": "string",
        "createdAt": "2026-01-01T00:00:00Z",
        "source": "string"
      }
    ],
    "job": {
      "id": "",
      "status": "started",
      "externalJobId": "",
      "idempotencyKey": "string",
      "requestedBy": "string",
      "requestedAt": "2026-01-01T00:00:00Z",
      "finishedAt": "2026-01-01T00:00:00Z",
      "finished": true,
      "events": [
        {
          "seq": 1,
          "event": "string",
          "at": "2026-01-01T00:00:00Z",
          "detail": {}
        }
      ],
      "documents": [
        {
          "id": "",
          "fileId": "",
          "fileName": "string",
          "documentType": "string",
          "attemptNo": 1,
          "outcome": "pending",
          "reason": "string",
          "contentSha256": "string",
          "at": "2026-01-01T00:00:00Z",
          "extractions": [
            {
              "jobId": "",
              "kind": "string",
              "source": "string",
              "engine": "string",
              "modelVersion": "string",
              "confidenceBps": 1,
              "fields": [
                {
                  "field": "string",
                  "value": "string",
                  "confidenceBps": 1,
                  "page": 1
                }
              ],
              "notes": [
                "string"
              ]
            }
          ]
        }
      ],
      "findings": "string"
    },
    "findings": [
      {
        "jobId": "",
        "kind": "missing_information",
        "fileId": "",
        "version": 1,
        "payload": {},
        "processorRequestId": "",
        "at": "2026-01-01T00:00:00Z"
      }
    ],
    "financials": {
      "banking": {
        "jobId": "",
        "currency": "string",
        "files": 1,
        "months": 1,
        "monthlyRevenueMinor": 1,
        "averageDailyBalanceMinor": 1,
        "nsfCount": 1,
        "positions": 1
      },
      "credit": {
        "jobId": "",
        "score": 1,
        "scoreSource": "string",
        "bureau": "string",
        "pulledAt": "string"
      }
    }
  }
}
```

### 401

No key, or an unknown or revoked one.

Content type: `application/json`.

```json
{
  "error": {
    "message": "string"
  }
}
```

### 402

A key issued from Settings → Developer, on a workspace without the Enterprise plan.

Content type: `application/json`.

```json
{
  "error": {
    "message": "string"
  }
}
```

### 403

The key was not given `read`, or is a board key.

Content type: `application/json`.

```json
{
  "error": {
    "message": "string"
  }
}
```

### 404

No job or deal with that id that this key can reach.

Content type: `application/json`.

```json
{
  "error": {
    "message": "string"
  }
}
```
