Knit API Documentation
List Signing Requests
{{baseUrl}}/api/v1/managed-signing/requestsThis endpoint retrieves all signing requests for your business with optional filtering.
Headers
X-API-KEY: Your API key for authentication.Accept: Set toapplication/jsonto receive responses in JSON format.
Query Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
walletId | string | No | Filter by local wallet ID |
status | string | No | Filter by status |
Available Status Values
AWAITING_APPROVALSIGNEDPOLICY_DENIEDFAILED
Sample Request
curl --location -g '{{baseUrl}}/api/v1/managed-signing/requests?walletId=<local-wallet-id>&status=SIGNED' \
--header 'X-API-KEY: {{apiKey}}' \
--header 'Accept: application/json'Sample Response
Sample 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
| Field | Type | Description |
|---|---|---|
id | string | Local request ID |
businessId | string | Your business ID |
walletId | string | Local wallet ID |
network | string | Target network |
type | string | Request type |
kind | string | Transaction kind |
status | string | Request status |
payload | object | Request payload |
signature | string | Generated signature (if signed) |
broadcast | boolean | Broadcast flag |
createdAt | string | Creation timestamp |
updatedAt | string | Last update timestamp |
