---
title: "Submit direct settlement signatures"
method: POST
path: "/api/v1/spools/{id}/settlement/signatures"
---

# Submit direct settlement signatures

`POST /api/v1/spools/{id}/settlement/signatures`

## Request

- Base URL: `https://spoolis.com`
- URL: `https://spoolis.com/api/v1/spools/{id}/settlement/signatures`
- Auth: HTTP bearer

Validates the current preview USDC EIP-3009 authorizations. Initial submission includes seller and fee signatures. A fee-only retry omits the seller signature after the seller leg is confirmed.

## Path parameters

- `id` string, required

## Request body

- SettlementSignaturesRequest
  - `seller_signature` string
  - `fee_signature` string, required

## Response `200`

Direct settlement submission state

- SettlementSignatureResult
  - `state` 'submitted' | 'fee_pending' | 'settled' | 'reverted' | 'reverted_final' | 'unknown', required
  - `seller_leg_tx_hash` string, nullable, required
  - `fee_leg_tx_hash` string, nullable, required
  - `preview` unknown, required

## Other responses

- `400`: Machine-readable API error
- `401`: Machine-readable API error
- `403`: Machine-readable API error
- `404`: Machine-readable API error
- `409`: Machine-readable API error
- `413`: Machine-readable API error
- `422`: Machine-readable API error
- `429`: Machine-readable API error
- `500`: Machine-readable API error
- `503`: Machine-readable API error

---

[API](https://skmtc.dev/spoolis/apis/spoolis-public-api.md) · [All operations](https://skmtc.dev/spoolis/apis/spoolis-public-api/llms.txt) · [OpenAPI document](https://skmtc.dev/spoolis/apis/spoolis-public-api/revisions/e438bfc05c01?raw)