# previewLibraryFileRun

The first rows of a mapped run as it reads them: for a skip trace each row's lookups (inputs: whose owner, at which address), for a tag the properties. The row count is how many rows it reads. A skip trace costs up to one credit per lookup: rows times the lookups per row. skipTrace is true for a SKIPTRACE run and false for TAG_PROPERTIES. limit is 1 to 10. Read only.

- Call: `POST https://server.goliathdata.com/api/v1/call` with `{ "operationId": "previewLibraryFileRun", "variables": {...} }`
- Scope: `READ`
- Type: query
- Idempotency: a read; rejects `Idempotency-Key`
- Rate-limited: no
- Result cap: `limit` is clamped to 10, without an error

## Variables

- `fileProcessingTaskId`: `ID!` (required)
- `skipTrace`: `Boolean!` (required)
- `limit`: `Int` (default `8`)

## Response (data, an example)

```json
{
  "fileProcessingTaskQuery": {
    "skipTraceRowCount (if $skipTrace)": 0,
    "skipTraceRows (if $skipTrace)": [
      {
        "rowIndex": 0,
        "rawRowJson": "…",
        "error": "…",
        "inputs": [
          {
            "actorName": "…",
            "propertyAddress": {
              "raw": "…"
            },
            "mailingAddress": {
              "raw": "…"
            },
            "propertyEsId": "…"
          }
        ]
      }
    ],
    "tagRowCount (unless $skipTrace)": 0,
    "tagRows (unless $skipTrace)": [
      {
        "rowIndex": 0,
        "rawRowJson": "…",
        "error": "…",
        "properties": [
          {
            "address": {
              "raw": "…"
            }
          }
        ]
      }
    ]
  }
}
```

## Example

```bash
curl https://server.goliathdata.com/api/v1/call \
  -H "Authorization: Bearer $GOLIATH_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "operationId": "previewLibraryFileRun",
    "variables": {
      "fileProcessingTaskId": "<fileProcessingTaskId>",
      "skipTrace": true
    }
  }'
```