Managed Signing
List Signing Requests

List Signing Requests

GET
https://api-prod.useknit.io/api/v1/managed-signing/requests
Scopemanaged-signing:readAuthBearer token

This endpoint retrieves all signing requests for your business with optional filtering.

Query Parameters

ParameterTypeRequiredDescription
walletIdstringNoFilter by local wallet ID
statusstringNoFilter by status

Available Status Values

  • AWAITING_APPROVAL
  • SIGNED
  • POLICY_DENIED
  • FAILED

Request

curl "https://api-prod.useknit.io/api/v1/managed-signing/requests?walletId=<local-wallet-id>&status=SIGNED" \
  -H "Authorization: Bearer $KNIT_ACCESS_TOKEN" \
  -H "Accept: application/json"

Response

Response
{
  "statusCode": 200,
  "message": "Signing requests retrieved",
  "data": [
    {
      "id": "<local-request-id>",
      "businessId": "<business-id>",
      "walletId": "<local-wallet-id>",
      "network": "MATIC_MAINNET",
      "type": "evm_tx",
      "kind": "erc20_approve",
      "status": "SIGNED",
      "payload": {
        "token": "0xToken",
        "spender": "0xSpender",
        "amount": "10"
      },
      "signature": "0x...",
      "broadcast": false,
      "createdAt": "2026-01-20T18:30:40.912Z",
      "updatedAt": "2026-01-20T18:35:22.456Z"
    }
  ],
  "success": true
}

Response Fields

FieldTypeDescription
idstringLocal request ID
businessIdstringYour business ID
walletIdstringLocal wallet ID
networkstringTarget network
typestringRequest type
kindstringTransaction kind
statusstringRequest status
payloadobjectRequest payload
signaturestringGenerated signature (if signed)
broadcastbooleanBroadcast flag
createdAtstringCreation timestamp
updatedAtstringLast update timestamp