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

# The preauth signals endpoint

The PreauthSignals endpoint returns the predicted likelihood that a transaction
will succeed for a connected credit card Account, alongside the card's standing and
recommended timing for the transaction.

> [!NOTE]
>
> **Public preview.** PreauthSignals is in public preview. Contact your Method CSM to request access.

## Account requirements

PreauthSignals accepts a Method Account ID in the request path for a liability-backed credit card Account.
The Account must not be disabled and its consent must not be withdrawn. Closed Accounts
are supported and return a completed assessment with `success_likelihood: 0`.

The assessment is synchronous. `POST /accounts/{acc_id}/preauth` returns the completed or failed
PreauthSignals object after processing finishes.

> [!NOTE]
>
> PreauthSignals is available only with API version `2026-03-30`.

**The PreauthSignals endpoint is available as a:**

| Type | Use-Case |
| - | - |
| `Product` | On-demand assessment of a transaction attempt for a connected credit card Account. |

## PreauthSignals Object

```json The PreauthSignals Object theme={null}
{
  "id": "preauth_qV7kRaFm4JNxw",
  "account_id": "acc_4m9amk4KFiaQX",
  "status": "completed",
  "verified_ownership": "match",
  "card_standing": "active",
  "success_likelihood": 0.82,
  "optimal_retry_date": "2026-05-28",
  "error": null,
  "metadata": null,
  "created_at": "2026-05-28T14:00:00.000Z",
  "updated_at": "2026-05-28T14:00:00.180Z"
}
```

## Insufficient data

When Method cannot compute a prediction from sufficiently recent liability data, the
assessment still returns `status: "completed"`. In that case, `success_likelihood` and
`optimal_retry_date` are `null`, and `error.sub_type` is `PREAUTH_INSUFFICIENT_DATA`.

If the Account's underlying liability cannot be found, the assessment returns
`status: "failed"` with `error.sub_type: "PREAUTH_FAILED_LIABILITY_NOT_FOUND"`.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.