---
title: "Settle Referral"
method: POST
path: "/api/webhooks/internal/referral-settle/{referral_id}"
---

# Settle Referral

`POST /api/webhooks/internal/referral-settle/{referral_id}`

## Request

- Base URL: `https://api.openpaper.ai` (the document declares no server; this is the origin it was published from)
- URL: `https://api.openpaper.ai/api/webhooks/internal/referral-settle/{referral_id}`
- Auth: none declared

Internal callback fired by the jobs service when a referral credit hold
has elapsed. Idempotent — re-runs on the same referral are no-ops.

Auth: the referral_id is an unguessable UUID. This matches the pattern of
/api/webhooks/paper-processing/{job_id}.

## Path parameters

- `referral_id` string, required

## Response `200`

Successful Response

- unknown

## Other responses

- `422`: Validation Error

---

[API](https://skmtc.dev/openpaper/apis/open-paper.md) - [All operations](https://skmtc.dev/openpaper/apis/open-paper/llms.txt) - [OpenAPI document](https://skmtc.dev/openpaper/apis/open-paper/revisions/c2ad03216101?raw)