> ## Documentation Index
> Fetch the complete documentation index at: https://docs.flightlinehq.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Flightline API

> Submit loan packages for automated quality-control review and retrieve results.

The Flightline API is a small, focused REST API for running automated
quality-control reviews on mortgage loan packages.

The model is deliberately simple:

1. **Create a review** and attach the loan package in a single request.
2. **Poll the review** (or receive a webhook) until it is `completed`.
3. **Fetch the report**: a structured summary of the issues Flightline found.

```
Base URL   https://api.flightlinehq.com/v1
```

## Concepts

<CardGroup cols={2}>
  <Card title="Review" icon="folder-open">
    A single quality-control run over one loan package. Identified by a
    `review_id` (UUID). You may also set your own `reference_id`.
  </Card>

  <Card title="Documents" icon="file-lines">
    The full case package archive, or the PDFs and images that make up the
    loan package. Submitted when you create the review.
  </Card>

  <Card title="Report" icon="clipboard-check">
    The result of a completed review: an overall outcome plus a list of
    issues with severities.
  </Card>

  <Card title="Webhooks" icon="bell">
    Optional callbacks so you don't have to poll. `review.completed`,
    `review.failed`, and `review.amended`.
  </Card>
</CardGroup>

## Authentication in one line

Every request must include your organization's API key:

```bash theme={null}
curl https://api.flightlinehq.com/v1/reviews/{review_id} \
  -H "Authorization: Bearer fl_live_..."
```

See [Authentication](/authentication) for how keys are issued and scoped.

<Note>
  The API is org-scoped end to end: a key can only ever see reviews that
  belong to its organization. There are no unauthenticated endpoints.
</Note>