{"openapi":"3.0.4","info":{"title":"send21 API","description":"Non-custodial payment drafts and pay links for BTC (on-chain and Lightning), USDC, USDT, EURC, SOL and ETH, for humans and AI agents. send21 never holds keys or funds. It prepares payment instructions that the payer signs in their own wallet: one QR payment from any wallet, or a batched template for PSBT wallets (Bitcoin Core, Sparrow, Electrum) and batching wallets such as Safe. AI agents authenticate with scoped API keys (Authorization: Bearer s21_...) and get idempotent creation, batch operations, recurring templates, and HMAC-signed webhooks (see the Webhooks section for events, payloads and signature checks). MCP server: \/mcp. Machine-readable overview: \/llms.txt. Integration questions: integration@send21.io. Account or payment issues: support@send21.io","contact":{"name":"send21 integration support","email":"integration@send21.io"},"version":"v1"},"servers":[{"url":"https:\/\/send21.io"}],"paths":{"\/api\/v1\/account\/status":{"get":{"tags":["Account"],"responses":{"200":{"description":"OK","content":{"text\/plain":{"schema":{"$ref":"#\/components\/schemas\/AccountStatusResponse"}},"application\/json":{"schema":{"$ref":"#\/components\/schemas\/AccountStatusResponse"}},"text\/json":{"schema":{"$ref":"#\/components\/schemas\/AccountStatusResponse"}}}}}}},"\/api\/v1\/account\/receiving-address-policy":{"put":{"tags":["Account"],"requestBody":{"content":{"application\/json":{"schema":{"$ref":"#\/components\/schemas\/ReceivingAddressPolicyRequest"}},"text\/json":{"schema":{"$ref":"#\/components\/schemas\/ReceivingAddressPolicyRequest"}},"application\/*+json":{"schema":{"$ref":"#\/components\/schemas\/ReceivingAddressPolicyRequest"}}}},"responses":{"200":{"description":"OK","content":{"text\/plain":{"schema":{"$ref":"#\/components\/schemas\/ReceivingAddressPolicyResponse"}},"application\/json":{"schema":{"$ref":"#\/components\/schemas\/ReceivingAddressPolicyResponse"}},"text\/json":{"schema":{"$ref":"#\/components\/schemas\/ReceivingAddressPolicyResponse"}}}}}}},"\/api\/v1\/address-book":{"get":{"tags":["AddressBook"],"responses":{"200":{"description":"OK","content":{"text\/plain":{"schema":{"type":"array","items":{"$ref":"#\/components\/schemas\/AddressBookEntryResponse"}}},"application\/json":{"schema":{"type":"array","items":{"$ref":"#\/components\/schemas\/AddressBookEntryResponse"}}},"text\/json":{"schema":{"type":"array","items":{"$ref":"#\/components\/schemas\/AddressBookEntryResponse"}}}}}}},"post":{"tags":["AddressBook"],"requestBody":{"content":{"application\/json":{"schema":{"$ref":"#\/components\/schemas\/AddressBookUpsertRequest"}},"text\/json":{"schema":{"$ref":"#\/components\/schemas\/AddressBookUpsertRequest"}},"application\/*+json":{"schema":{"$ref":"#\/components\/schemas\/AddressBookUpsertRequest"}}}},"responses":{"201":{"description":"Created","content":{"text\/plain":{"schema":{"$ref":"#\/components\/schemas\/AddressBookEntryResponse"}},"application\/json":{"schema":{"$ref":"#\/components\/schemas\/AddressBookEntryResponse"}},"text\/json":{"schema":{"$ref":"#\/components\/schemas\/AddressBookEntryResponse"}}}}}}},"\/api\/v1\/address-book\/{id}":{"put":{"tags":["AddressBook"],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"requestBody":{"content":{"application\/json":{"schema":{"$ref":"#\/components\/schemas\/AddressBookUpsertRequest"}},"text\/json":{"schema":{"$ref":"#\/components\/schemas\/AddressBookUpsertRequest"}},"application\/*+json":{"schema":{"$ref":"#\/components\/schemas\/AddressBookUpsertRequest"}}}},"responses":{"200":{"description":"OK","content":{"text\/plain":{"schema":{"$ref":"#\/components\/schemas\/AddressBookEntryResponse"}},"application\/json":{"schema":{"$ref":"#\/components\/schemas\/AddressBookEntryResponse"}},"text\/json":{"schema":{"$ref":"#\/components\/schemas\/AddressBookEntryResponse"}}}},"404":{"description":"Not Found","content":{"text\/plain":{"schema":{"$ref":"#\/components\/schemas\/ProblemDetails"}},"application\/json":{"schema":{"$ref":"#\/components\/schemas\/ProblemDetails"}},"text\/json":{"schema":{"$ref":"#\/components\/schemas\/ProblemDetails"}}}}}},"delete":{"tags":["AddressBook"],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"204":{"description":"No Content"},"404":{"description":"Not Found","content":{"text\/plain":{"schema":{"$ref":"#\/components\/schemas\/ProblemDetails"}},"application\/json":{"schema":{"$ref":"#\/components\/schemas\/ProblemDetails"}},"text\/json":{"schema":{"$ref":"#\/components\/schemas\/ProblemDetails"}}}}}}},"\/api\/v1\/api-keys":{"get":{"tags":["ApiKeys"],"responses":{"200":{"description":"OK","content":{"text\/plain":{"schema":{"type":"array","items":{"$ref":"#\/components\/schemas\/ApiKeyResponse"}}},"application\/json":{"schema":{"type":"array","items":{"$ref":"#\/components\/schemas\/ApiKeyResponse"}}},"text\/json":{"schema":{"type":"array","items":{"$ref":"#\/components\/schemas\/ApiKeyResponse"}}}}}}},"post":{"tags":["ApiKeys"],"requestBody":{"content":{"application\/json":{"schema":{"$ref":"#\/components\/schemas\/CreateApiKeyRequest"}},"text\/json":{"schema":{"$ref":"#\/components\/schemas\/CreateApiKeyRequest"}},"application\/*+json":{"schema":{"$ref":"#\/components\/schemas\/CreateApiKeyRequest"}}}},"responses":{"200":{"description":"OK","content":{"text\/plain":{"schema":{"$ref":"#\/components\/schemas\/ApiKeyCreatedResponse"}},"application\/json":{"schema":{"$ref":"#\/components\/schemas\/ApiKeyCreatedResponse"}},"text\/json":{"schema":{"$ref":"#\/components\/schemas\/ApiKeyCreatedResponse"}}}}}}},"\/api\/v1\/api-keys\/{id}":{"delete":{"tags":["ApiKeys"],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"204":{"description":"No Content"},"404":{"description":"Not Found","content":{"text\/plain":{"schema":{"$ref":"#\/components\/schemas\/ProblemDetails"}},"application\/json":{"schema":{"$ref":"#\/components\/schemas\/ProblemDetails"}},"text\/json":{"schema":{"$ref":"#\/components\/schemas\/ProblemDetails"}}}}}}},"\/api\/v1\/accounts\/agent-signup":{"post":{"tags":["Auth"],"requestBody":{"content":{"application\/json":{"schema":{"$ref":"#\/components\/schemas\/AgentSignupRequest"}},"text\/json":{"schema":{"$ref":"#\/components\/schemas\/AgentSignupRequest"}},"application\/*+json":{"schema":{"$ref":"#\/components\/schemas\/AgentSignupRequest"}}}},"responses":{"201":{"description":"Created","content":{"text\/plain":{"schema":{"$ref":"#\/components\/schemas\/AgentSignupResponse"}},"application\/json":{"schema":{"$ref":"#\/components\/schemas\/AgentSignupResponse"}},"text\/json":{"schema":{"$ref":"#\/components\/schemas\/AgentSignupResponse"}}}}}}},"\/api\/v1\/accounts\/claim\/begin":{"post":{"tags":["Auth"],"requestBody":{"content":{"application\/json":{"schema":{"$ref":"#\/components\/schemas\/ClaimTokenRequest"}},"text\/json":{"schema":{"$ref":"#\/components\/schemas\/ClaimTokenRequest"}},"application\/*+json":{"schema":{"$ref":"#\/components\/schemas\/ClaimTokenRequest"}}}},"responses":{"200":{"description":"OK","content":{"text\/plain":{"schema":{"$ref":"#\/components\/schemas\/ClaimInfoResponse"}},"application\/json":{"schema":{"$ref":"#\/components\/schemas\/ClaimInfoResponse"}},"text\/json":{"schema":{"$ref":"#\/components\/schemas\/ClaimInfoResponse"}}}}}}},"\/api\/v1\/accounts\/claim\/passkey":{"post":{"tags":["Auth"],"requestBody":{"content":{"application\/json":{"schema":{"$ref":"#\/components\/schemas\/ClaimPasskeyRequest"}},"text\/json":{"schema":{"$ref":"#\/components\/schemas\/ClaimPasskeyRequest"}},"application\/*+json":{"schema":{"$ref":"#\/components\/schemas\/ClaimPasskeyRequest"}}}},"responses":{"200":{"description":"OK","content":{"text\/plain":{"schema":{"$ref":"#\/components\/schemas\/MeResponse"}},"application\/json":{"schema":{"$ref":"#\/components\/schemas\/MeResponse"}},"text\/json":{"schema":{"$ref":"#\/components\/schemas\/MeResponse"}}}}}}},"\/api\/v1\/accounts\/claim\/password":{"post":{"tags":["Auth"],"requestBody":{"content":{"application\/json":{"schema":{"$ref":"#\/components\/schemas\/ClaimPasswordRequest"}},"text\/json":{"schema":{"$ref":"#\/components\/schemas\/ClaimPasswordRequest"}},"application\/*+json":{"schema":{"$ref":"#\/components\/schemas\/ClaimPasswordRequest"}}}},"responses":{"200":{"description":"OK","content":{"text\/plain":{"schema":{"$ref":"#\/components\/schemas\/MeResponse"}},"application\/json":{"schema":{"$ref":"#\/components\/schemas\/MeResponse"}},"text\/json":{"schema":{"$ref":"#\/components\/schemas\/MeResponse"}}}}}}},"\/api\/v1\/accounts\/claim\/decline":{"post":{"tags":["Auth"],"requestBody":{"content":{"application\/json":{"schema":{"$ref":"#\/components\/schemas\/ClaimTokenRequest"}},"text\/json":{"schema":{"$ref":"#\/components\/schemas\/ClaimTokenRequest"}},"application\/*+json":{"schema":{"$ref":"#\/components\/schemas\/ClaimTokenRequest"}}}},"responses":{"204":{"description":"No Content"}}}},"\/api\/v1\/auth\/register\/begin":{"post":{"tags":["Auth"],"requestBody":{"content":{"application\/json":{"schema":{"$ref":"#\/components\/schemas\/RegisterBeginRequest"}},"text\/json":{"schema":{"$ref":"#\/components\/schemas\/RegisterBeginRequest"}},"application\/*+json":{"schema":{"$ref":"#\/components\/schemas\/RegisterBeginRequest"}}}},"responses":{"200":{"description":"OK"}}}},"\/api\/v1\/auth\/register\/verify":{"post":{"tags":["Auth"],"requestBody":{"content":{"application\/json":{"schema":{"$ref":"#\/components\/schemas\/EmailCodeCompleteRequest"}},"text\/json":{"schema":{"$ref":"#\/components\/schemas\/EmailCodeCompleteRequest"}},"application\/*+json":{"schema":{"$ref":"#\/components\/schemas\/EmailCodeCompleteRequest"}}}},"responses":{"200":{"description":"OK"}}}},"\/api\/v1\/auth\/register\/complete":{"post":{"tags":["Auth"],"requestBody":{"content":{"application\/json":{"schema":{"$ref":"#\/components\/schemas\/RegisterCompleteRequest"}},"text\/json":{"schema":{"$ref":"#\/components\/schemas\/RegisterCompleteRequest"}},"application\/*+json":{"schema":{"$ref":"#\/components\/schemas\/RegisterCompleteRequest"}}}},"responses":{"200":{"description":"OK"}}}},"\/api\/v1\/auth\/login\/begin":{"post":{"tags":["Auth"],"responses":{"200":{"description":"OK"}}}},"\/api\/v1\/auth\/login\/complete":{"post":{"tags":["Auth"],"requestBody":{"content":{"application\/json":{"schema":{"$ref":"#\/components\/schemas\/LoginCompleteRequest"}},"text\/json":{"schema":{"$ref":"#\/components\/schemas\/LoginCompleteRequest"}},"application\/*+json":{"schema":{"$ref":"#\/components\/schemas\/LoginCompleteRequest"}}}},"responses":{"200":{"description":"OK"}}}},"\/api\/v1\/auth\/logout":{"post":{"tags":["Auth"],"responses":{"200":{"description":"OK"}}}},"\/api\/v1\/auth\/password\/register":{"post":{"tags":["Auth"],"requestBody":{"content":{"application\/json":{"schema":{"$ref":"#\/components\/schemas\/PasswordRegisterRequest"}},"text\/json":{"schema":{"$ref":"#\/components\/schemas\/PasswordRegisterRequest"}},"application\/*+json":{"schema":{"$ref":"#\/components\/schemas\/PasswordRegisterRequest"}}}},"responses":{"200":{"description":"OK"}}}},"\/api\/v1\/auth\/password\/register\/complete":{"post":{"tags":["Auth"],"requestBody":{"content":{"application\/json":{"schema":{"$ref":"#\/components\/schemas\/EmailCodeCompleteRequest"}},"text\/json":{"schema":{"$ref":"#\/components\/schemas\/EmailCodeCompleteRequest"}},"application\/*+json":{"schema":{"$ref":"#\/components\/schemas\/EmailCodeCompleteRequest"}}}},"responses":{"200":{"description":"OK"}}}},"\/api\/v1\/auth\/password\/change":{"post":{"tags":["Auth"],"requestBody":{"content":{"application\/json":{"schema":{"$ref":"#\/components\/schemas\/PasswordChangeRequest"}},"text\/json":{"schema":{"$ref":"#\/components\/schemas\/PasswordChangeRequest"}},"application\/*+json":{"schema":{"$ref":"#\/components\/schemas\/PasswordChangeRequest"}}}},"responses":{"200":{"description":"OK"}}}},"\/api\/v1\/auth\/sessions\/revoke":{"post":{"tags":["Auth"],"responses":{"200":{"description":"OK"}}}},"\/api\/v1\/auth\/password\/forgot":{"post":{"tags":["Auth"],"requestBody":{"content":{"application\/json":{"schema":{"$ref":"#\/components\/schemas\/PasswordForgotRequest"}},"text\/json":{"schema":{"$ref":"#\/components\/schemas\/PasswordForgotRequest"}},"application\/*+json":{"schema":{"$ref":"#\/components\/schemas\/PasswordForgotRequest"}}}},"responses":{"200":{"description":"OK"}}}},"\/api\/v1\/auth\/password\/forgot\/complete":{"post":{"tags":["Auth"],"requestBody":{"content":{"application\/json":{"schema":{"$ref":"#\/components\/schemas\/PasswordForgotCompleteRequest"}},"text\/json":{"schema":{"$ref":"#\/components\/schemas\/PasswordForgotCompleteRequest"}},"application\/*+json":{"schema":{"$ref":"#\/components\/schemas\/PasswordForgotCompleteRequest"}}}},"responses":{"200":{"description":"OK"}}}},"\/api\/v1\/auth\/password\/login":{"post":{"tags":["Auth"],"requestBody":{"content":{"application\/json":{"schema":{"$ref":"#\/components\/schemas\/PasswordLoginRequest"}},"text\/json":{"schema":{"$ref":"#\/components\/schemas\/PasswordLoginRequest"}},"application\/*+json":{"schema":{"$ref":"#\/components\/schemas\/PasswordLoginRequest"}}}},"responses":{"200":{"description":"OK"}}}},"\/api\/v1\/auth\/password\/login\/complete":{"post":{"tags":["Auth"],"requestBody":{"content":{"application\/json":{"schema":{"$ref":"#\/components\/schemas\/EmailCodeCompleteRequest"}},"text\/json":{"schema":{"$ref":"#\/components\/schemas\/EmailCodeCompleteRequest"}},"application\/*+json":{"schema":{"$ref":"#\/components\/schemas\/EmailCodeCompleteRequest"}}}},"responses":{"200":{"description":"OK"}}}},"\/api\/v1\/auth\/me":{"get":{"tags":["Auth"],"responses":{"200":{"description":"OK"}}}},"\/api\/v1\/auth\/account":{"delete":{"tags":["Auth"],"responses":{"200":{"description":"OK"}}}},"\/api\/v1\/auth\/step-up\/begin":{"post":{"tags":["Auth"],"responses":{"200":{"description":"OK"}}}},"\/api\/v1\/auth\/step-up\/complete":{"post":{"tags":["Auth"],"requestBody":{"content":{"application\/json":{"schema":{"$ref":"#\/components\/schemas\/StepUpCompleteRequest"}},"text\/json":{"schema":{"$ref":"#\/components\/schemas\/StepUpCompleteRequest"}},"application\/*+json":{"schema":{"$ref":"#\/components\/schemas\/StepUpCompleteRequest"}}}},"responses":{"200":{"description":"OK"}}}},"\/api\/v1\/auth\/totp\/setup":{"post":{"tags":["Auth"],"responses":{"200":{"description":"OK"}}}},"\/api\/v1\/auth\/totp\/enable":{"post":{"tags":["Auth"],"requestBody":{"content":{"application\/json":{"schema":{"$ref":"#\/components\/schemas\/TotpCodeRequest"}},"text\/json":{"schema":{"$ref":"#\/components\/schemas\/TotpCodeRequest"}},"application\/*+json":{"schema":{"$ref":"#\/components\/schemas\/TotpCodeRequest"}}}},"responses":{"200":{"description":"OK"}}}},"\/api\/v1\/auth\/totp\/disable":{"post":{"tags":["Auth"],"requestBody":{"content":{"application\/json":{"schema":{"$ref":"#\/components\/schemas\/TotpCodeRequest"}},"text\/json":{"schema":{"$ref":"#\/components\/schemas\/TotpCodeRequest"}},"application\/*+json":{"schema":{"$ref":"#\/components\/schemas\/TotpCodeRequest"}}}},"responses":{"200":{"description":"OK"}}}},"\/api\/v1\/checkout\/{token}":{"get":{"tags":["Checkout"],"parameters":[{"name":"token","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"OK","content":{"text\/plain":{"schema":{"$ref":"#\/components\/schemas\/CheckoutInfoResponse"}},"application\/json":{"schema":{"$ref":"#\/components\/schemas\/CheckoutInfoResponse"}},"text\/json":{"schema":{"$ref":"#\/components\/schemas\/CheckoutInfoResponse"}}}},"404":{"description":"Not Found","content":{"text\/plain":{"schema":{"$ref":"#\/components\/schemas\/ProblemDetails"}},"application\/json":{"schema":{"$ref":"#\/components\/schemas\/ProblemDetails"}},"text\/json":{"schema":{"$ref":"#\/components\/schemas\/ProblemDetails"}}}}}}},"\/api\/v1\/checkout\/{token}\/select":{"post":{"tags":["Checkout"],"parameters":[{"name":"token","in":"path","required":true,"schema":{"type":"string"}}],"requestBody":{"content":{"application\/json":{"schema":{"$ref":"#\/components\/schemas\/CheckoutSelectRequest"}},"text\/json":{"schema":{"$ref":"#\/components\/schemas\/CheckoutSelectRequest"}},"application\/*+json":{"schema":{"$ref":"#\/components\/schemas\/CheckoutSelectRequest"}}}},"responses":{"200":{"description":"OK","content":{"text\/plain":{"schema":{"$ref":"#\/components\/schemas\/CheckoutInfoResponse"}},"application\/json":{"schema":{"$ref":"#\/components\/schemas\/CheckoutInfoResponse"}},"text\/json":{"schema":{"$ref":"#\/components\/schemas\/CheckoutInfoResponse"}}}}}}},"\/api\/v1\/checkout\/{token}\/status":{"get":{"tags":["Checkout"],"parameters":[{"name":"token","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"OK","content":{"text\/plain":{"schema":{"$ref":"#\/components\/schemas\/CheckoutStatusResponse"}},"application\/json":{"schema":{"$ref":"#\/components\/schemas\/CheckoutStatusResponse"}},"text\/json":{"schema":{"$ref":"#\/components\/schemas\/CheckoutStatusResponse"}}}},"404":{"description":"Not Found","content":{"text\/plain":{"schema":{"$ref":"#\/components\/schemas\/ProblemDetails"}},"application\/json":{"schema":{"$ref":"#\/components\/schemas\/ProblemDetails"}},"text\/json":{"schema":{"$ref":"#\/components\/schemas\/ProblemDetails"}}}}}}},"\/api\/v1\/demo\/config":{"get":{"tags":["Demo"],"responses":{"200":{"description":"OK","content":{"text\/plain":{"schema":{"$ref":"#\/components\/schemas\/DemoConfigResponse"}},"application\/json":{"schema":{"$ref":"#\/components\/schemas\/DemoConfigResponse"}},"text\/json":{"schema":{"$ref":"#\/components\/schemas\/DemoConfigResponse"}}}}}}},"\/api\/v1\/demo\/drafts":{"post":{"tags":["Demo"],"requestBody":{"content":{"application\/json":{"schema":{"$ref":"#\/components\/schemas\/CreateDemoDraftRequest"}},"text\/json":{"schema":{"$ref":"#\/components\/schemas\/CreateDemoDraftRequest"}},"application\/*+json":{"schema":{"$ref":"#\/components\/schemas\/CreateDemoDraftRequest"}}}},"responses":{"201":{"description":"Created","content":{"text\/plain":{"schema":{"$ref":"#\/components\/schemas\/DemoDraftResponse"}},"application\/json":{"schema":{"$ref":"#\/components\/schemas\/DemoDraftResponse"}},"text\/json":{"schema":{"$ref":"#\/components\/schemas\/DemoDraftResponse"}}}}}}},"\/api\/v1\/demo\/drafts\/{id}":{"get":{"tags":["Demo"],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"OK","content":{"text\/plain":{"schema":{"$ref":"#\/components\/schemas\/DemoDraftResponse"}},"application\/json":{"schema":{"$ref":"#\/components\/schemas\/DemoDraftResponse"}},"text\/json":{"schema":{"$ref":"#\/components\/schemas\/DemoDraftResponse"}}}}}}},"\/api\/v1\/drafts":{"post":{"tags":["Drafts"],"requestBody":{"content":{"application\/json":{"schema":{"$ref":"#\/components\/schemas\/CreateDraftRequest"}},"text\/json":{"schema":{"$ref":"#\/components\/schemas\/CreateDraftRequest"}},"application\/*+json":{"schema":{"$ref":"#\/components\/schemas\/CreateDraftRequest"}}}},"responses":{"201":{"description":"Created","content":{"text\/plain":{"schema":{"$ref":"#\/components\/schemas\/DraftResponse"}},"application\/json":{"schema":{"$ref":"#\/components\/schemas\/DraftResponse"}},"text\/json":{"schema":{"$ref":"#\/components\/schemas\/DraftResponse"}}}},"200":{"description":"OK","content":{"text\/plain":{"schema":{"$ref":"#\/components\/schemas\/DraftResponse"}},"application\/json":{"schema":{"$ref":"#\/components\/schemas\/DraftResponse"}},"text\/json":{"schema":{"$ref":"#\/components\/schemas\/DraftResponse"}}}}}},"get":{"tags":["Drafts"],"parameters":[{"name":"status","in":"query","schema":{"$ref":"#\/components\/schemas\/DraftStatus"}},{"name":"network","in":"query","schema":{"$ref":"#\/components\/schemas\/PaymentNetwork"}},{"name":"method","in":"query","schema":{"$ref":"#\/components\/schemas\/PaymentMethod"}},{"name":"currency","in":"query","schema":{"$ref":"#\/components\/schemas\/PaymentCurrency"}},{"name":"q","in":"query","schema":{"type":"string"}},{"name":"from","in":"query","schema":{"type":"string","format":"date-time"}},{"name":"to","in":"query","schema":{"type":"string","format":"date-time"}},{"name":"page","in":"query","schema":{"type":"integer","format":"int32","default":1}},{"name":"pageSize","in":"query","schema":{"type":"integer","format":"int32","default":20}}],"responses":{"200":{"description":"OK","content":{"text\/plain":{"schema":{"$ref":"#\/components\/schemas\/DraftListResponse"}},"application\/json":{"schema":{"$ref":"#\/components\/schemas\/DraftListResponse"}},"text\/json":{"schema":{"$ref":"#\/components\/schemas\/DraftListResponse"}}}}}}},"\/api\/v1\/drafts\/batch":{"post":{"tags":["Drafts"],"requestBody":{"content":{"application\/json":{"schema":{"$ref":"#\/components\/schemas\/BatchCreateDraftsRequest"}},"text\/json":{"schema":{"$ref":"#\/components\/schemas\/BatchCreateDraftsRequest"}},"application\/*+json":{"schema":{"$ref":"#\/components\/schemas\/BatchCreateDraftsRequest"}}}},"responses":{"200":{"description":"OK","content":{"text\/plain":{"schema":{"type":"array","items":{"$ref":"#\/components\/schemas\/BatchDraftResult"}}},"application\/json":{"schema":{"type":"array","items":{"$ref":"#\/components\/schemas\/BatchDraftResult"}}},"text\/json":{"schema":{"type":"array","items":{"$ref":"#\/components\/schemas\/BatchDraftResult"}}}}}}}},"\/api\/v1\/drafts\/{id}":{"get":{"tags":["Drafts"],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"OK","content":{"text\/plain":{"schema":{"$ref":"#\/components\/schemas\/DraftResponse"}},"application\/json":{"schema":{"$ref":"#\/components\/schemas\/DraftResponse"}},"text\/json":{"schema":{"$ref":"#\/components\/schemas\/DraftResponse"}}}},"404":{"description":"Not Found","content":{"text\/plain":{"schema":{"$ref":"#\/components\/schemas\/ProblemDetails"}},"application\/json":{"schema":{"$ref":"#\/components\/schemas\/ProblemDetails"}},"text\/json":{"schema":{"$ref":"#\/components\/schemas\/ProblemDetails"}}}}}}},"\/api\/v1\/drafts\/{id}\/status":{"get":{"tags":["Drafts"],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"OK","content":{"text\/plain":{"schema":{"$ref":"#\/components\/schemas\/DraftStatusResponse"}},"application\/json":{"schema":{"$ref":"#\/components\/schemas\/DraftStatusResponse"}},"text\/json":{"schema":{"$ref":"#\/components\/schemas\/DraftStatusResponse"}}}},"404":{"description":"Not Found","content":{"text\/plain":{"schema":{"$ref":"#\/components\/schemas\/ProblemDetails"}},"application\/json":{"schema":{"$ref":"#\/components\/schemas\/ProblemDetails"}},"text\/json":{"schema":{"$ref":"#\/components\/schemas\/ProblemDetails"}}}}}}},"\/api\/v1\/drafts\/{id}\/cancel":{"post":{"tags":["Drafts"],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"OK","content":{"text\/plain":{"schema":{"$ref":"#\/components\/schemas\/DraftResponse"}},"application\/json":{"schema":{"$ref":"#\/components\/schemas\/DraftResponse"}},"text\/json":{"schema":{"$ref":"#\/components\/schemas\/DraftResponse"}}}}}}},"\/api\/v1\/drafts\/{id}\/reject-received":{"post":{"tags":["Drafts"],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"requestBody":{"content":{"application\/json":{"schema":{"$ref":"#\/components\/schemas\/RejectReceivedRequest"}},"text\/json":{"schema":{"$ref":"#\/components\/schemas\/RejectReceivedRequest"}},"application\/*+json":{"schema":{"$ref":"#\/components\/schemas\/RejectReceivedRequest"}}}},"responses":{"200":{"description":"OK","content":{"text\/plain":{"schema":{"$ref":"#\/components\/schemas\/DraftResponse"}},"application\/json":{"schema":{"$ref":"#\/components\/schemas\/DraftResponse"}},"text\/json":{"schema":{"$ref":"#\/components\/schemas\/DraftResponse"}}}}}}},"\/api\/v1\/drafts\/{id}\/accept-received":{"post":{"tags":["Drafts"],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"requestBody":{"content":{"application\/json":{"schema":{"$ref":"#\/components\/schemas\/AcceptReceivedRequest"}},"text\/json":{"schema":{"$ref":"#\/components\/schemas\/AcceptReceivedRequest"}},"application\/*+json":{"schema":{"$ref":"#\/components\/schemas\/AcceptReceivedRequest"}}}},"responses":{"200":{"description":"OK","content":{"text\/plain":{"schema":{"$ref":"#\/components\/schemas\/DraftResponse"}},"application\/json":{"schema":{"$ref":"#\/components\/schemas\/DraftResponse"}},"text\/json":{"schema":{"$ref":"#\/components\/schemas\/DraftResponse"}}}}}}},"\/api\/v1\/drafts\/{id}\/lightning-proof":{"post":{"tags":["Drafts"],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"requestBody":{"content":{"application\/json":{"schema":{"$ref":"#\/components\/schemas\/LightningProofRequest"}},"text\/json":{"schema":{"$ref":"#\/components\/schemas\/LightningProofRequest"}},"application\/*+json":{"schema":{"$ref":"#\/components\/schemas\/LightningProofRequest"}}}},"responses":{"200":{"description":"OK","content":{"text\/plain":{"schema":{"$ref":"#\/components\/schemas\/DraftResponse"}},"application\/json":{"schema":{"$ref":"#\/components\/schemas\/DraftResponse"}},"text\/json":{"schema":{"$ref":"#\/components\/schemas\/DraftResponse"}}}}}}},"\/api\/v1\/drafts\/{id}\/quotes":{"get":{"tags":["Drafts"],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"OK","content":{"text\/plain":{"schema":{"type":"array","items":{"$ref":"#\/components\/schemas\/QuoteInfo"}}},"application\/json":{"schema":{"type":"array","items":{"$ref":"#\/components\/schemas\/QuoteInfo"}}},"text\/json":{"schema":{"type":"array","items":{"$ref":"#\/components\/schemas\/QuoteInfo"}}}}},"404":{"description":"Not Found","content":{"text\/plain":{"schema":{"$ref":"#\/components\/schemas\/ProblemDetails"}},"application\/json":{"schema":{"$ref":"#\/components\/schemas\/ProblemDetails"}},"text\/json":{"schema":{"$ref":"#\/components\/schemas\/ProblemDetails"}}}}}}},"\/api\/v1\/drafts\/{id}\/requote":{"post":{"tags":["Drafts"],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"OK","content":{"text\/plain":{"schema":{"$ref":"#\/components\/schemas\/DraftResponse"}},"application\/json":{"schema":{"$ref":"#\/components\/schemas\/DraftResponse"}},"text\/json":{"schema":{"$ref":"#\/components\/schemas\/DraftResponse"}}}}}}},"\/api\/v1\/drafts\/{id}\/fees":{"get":{"tags":["Drafts"],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"OK","content":{"text\/plain":{"schema":{"$ref":"#\/components\/schemas\/FeeBreakdownResponse"}},"application\/json":{"schema":{"$ref":"#\/components\/schemas\/FeeBreakdownResponse"}},"text\/json":{"schema":{"$ref":"#\/components\/schemas\/FeeBreakdownResponse"}}}},"404":{"description":"Not Found","content":{"text\/plain":{"schema":{"$ref":"#\/components\/schemas\/ProblemDetails"}},"application\/json":{"schema":{"$ref":"#\/components\/schemas\/ProblemDetails"}},"text\/json":{"schema":{"$ref":"#\/components\/schemas\/ProblemDetails"}}}}}}},"\/api\/v1\/drafts\/{id}\/pdf":{"get":{"tags":["Drafts"],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"OK","content":{"application\/pdf":{"schema":{"type":"string","format":"binary"}}}},"404":{"description":"Not Found","content":{"text\/plain":{"schema":{"$ref":"#\/components\/schemas\/ProblemDetails"}},"application\/json":{"schema":{"$ref":"#\/components\/schemas\/ProblemDetails"}},"text\/json":{"schema":{"$ref":"#\/components\/schemas\/ProblemDetails"}}}}}}},"\/api\/v1\/drafts\/{id}\/tx-template":{"get":{"tags":["Drafts"],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"OK","content":{"text\/plain":{"schema":{"$ref":"#\/components\/schemas\/TxTemplateResponse"}},"application\/json":{"schema":{"$ref":"#\/components\/schemas\/TxTemplateResponse"}},"text\/json":{"schema":{"$ref":"#\/components\/schemas\/TxTemplateResponse"}}}}}}},"\/api\/v1\/fees\/schedule":{"get":{"tags":["Fees"],"responses":{"200":{"description":"OK","content":{"text\/plain":{"schema":{"$ref":"#\/components\/schemas\/FeeScheduleResponse"}},"application\/json":{"schema":{"$ref":"#\/components\/schemas\/FeeScheduleResponse"}},"text\/json":{"schema":{"$ref":"#\/components\/schemas\/FeeScheduleResponse"}}}}}}},"\/api\/v1\/fees\/accrued":{"get":{"tags":["Fees"],"responses":{"200":{"description":"OK","content":{"text\/plain":{"schema":{"$ref":"#\/components\/schemas\/AccruedFeesResponse"}},"application\/json":{"schema":{"$ref":"#\/components\/schemas\/AccruedFeesResponse"}},"text\/json":{"schema":{"$ref":"#\/components\/schemas\/AccruedFeesResponse"}}}}}}},"\/api\/v1\/fees\/accrued\/settle":{"post":{"tags":["Fees"],"requestBody":{"content":{"application\/json":{"schema":{"$ref":"#\/components\/schemas\/SettleAccruedFeesRequest"}},"text\/json":{"schema":{"$ref":"#\/components\/schemas\/SettleAccruedFeesRequest"}},"application\/*+json":{"schema":{"$ref":"#\/components\/schemas\/SettleAccruedFeesRequest"}}}},"responses":{"201":{"description":"Created","content":{"text\/plain":{"schema":{"$ref":"#\/components\/schemas\/DraftResponse"}},"application\/json":{"schema":{"$ref":"#\/components\/schemas\/DraftResponse"}},"text\/json":{"schema":{"$ref":"#\/components\/schemas\/DraftResponse"}}}},"200":{"description":"OK","content":{"text\/plain":{"schema":{"$ref":"#\/components\/schemas\/DraftResponse"}},"application\/json":{"schema":{"$ref":"#\/components\/schemas\/DraftResponse"}},"text\/json":{"schema":{"$ref":"#\/components\/schemas\/DraftResponse"}}}}}}},"\/api\/v1\/payment-requests":{"post":{"tags":["PaymentRequests"],"requestBody":{"content":{"application\/json":{"schema":{"$ref":"#\/components\/schemas\/CreatePaymentRequestRequest"}},"text\/json":{"schema":{"$ref":"#\/components\/schemas\/CreatePaymentRequestRequest"}},"application\/*+json":{"schema":{"$ref":"#\/components\/schemas\/CreatePaymentRequestRequest"}}}},"responses":{"201":{"description":"Created","content":{"text\/plain":{"schema":{"$ref":"#\/components\/schemas\/PaymentRequestResponse"}},"application\/json":{"schema":{"$ref":"#\/components\/schemas\/PaymentRequestResponse"}},"text\/json":{"schema":{"$ref":"#\/components\/schemas\/PaymentRequestResponse"}}}},"200":{"description":"OK","content":{"text\/plain":{"schema":{"$ref":"#\/components\/schemas\/PaymentRequestResponse"}},"application\/json":{"schema":{"$ref":"#\/components\/schemas\/PaymentRequestResponse"}},"text\/json":{"schema":{"$ref":"#\/components\/schemas\/PaymentRequestResponse"}}}}}},"get":{"tags":["PaymentRequests"],"parameters":[{"name":"orderId","in":"query","schema":{"type":"string"}}],"responses":{"200":{"description":"OK","content":{"text\/plain":{"schema":{"type":"array","items":{"$ref":"#\/components\/schemas\/PaymentRequestResponse"}}},"application\/json":{"schema":{"type":"array","items":{"$ref":"#\/components\/schemas\/PaymentRequestResponse"}}},"text\/json":{"schema":{"type":"array","items":{"$ref":"#\/components\/schemas\/PaymentRequestResponse"}}}}}}}},"\/api\/v1\/payment-requests\/{id}":{"get":{"tags":["PaymentRequests"],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"OK","content":{"text\/plain":{"schema":{"$ref":"#\/components\/schemas\/PaymentRequestResponse"}},"application\/json":{"schema":{"$ref":"#\/components\/schemas\/PaymentRequestResponse"}},"text\/json":{"schema":{"$ref":"#\/components\/schemas\/PaymentRequestResponse"}}}},"404":{"description":"Not Found","content":{"text\/plain":{"schema":{"$ref":"#\/components\/schemas\/ProblemDetails"}},"application\/json":{"schema":{"$ref":"#\/components\/schemas\/ProblemDetails"}},"text\/json":{"schema":{"$ref":"#\/components\/schemas\/ProblemDetails"}}}}}}},"\/api\/v1\/payment-requests\/{id}\/cancel":{"post":{"tags":["PaymentRequests"],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"OK","content":{"text\/plain":{"schema":{"$ref":"#\/components\/schemas\/PaymentRequestResponse"}},"application\/json":{"schema":{"$ref":"#\/components\/schemas\/PaymentRequestResponse"}},"text\/json":{"schema":{"$ref":"#\/components\/schemas\/PaymentRequestResponse"}}}}}}},"\/api\/v1\/rates":{"get":{"tags":["Rates"],"parameters":[{"name":"ccy","in":"query","schema":{"type":"string","default":"USD"}},{"name":"asset","in":"query","schema":{"$ref":"#\/components\/schemas\/PaymentCurrency"}}],"responses":{"200":{"description":"OK","content":{"text\/plain":{"schema":{"$ref":"#\/components\/schemas\/RateResponse"}},"application\/json":{"schema":{"$ref":"#\/components\/schemas\/RateResponse"}},"text\/json":{"schema":{"$ref":"#\/components\/schemas\/RateResponse"}}}}}}},"\/api\/v1\/recurring-templates":{"get":{"tags":["RecurringTemplates"],"responses":{"200":{"description":"OK","content":{"text\/plain":{"schema":{"type":"array","items":{"$ref":"#\/components\/schemas\/RecurringTemplateResponse"}}},"application\/json":{"schema":{"type":"array","items":{"$ref":"#\/components\/schemas\/RecurringTemplateResponse"}}},"text\/json":{"schema":{"type":"array","items":{"$ref":"#\/components\/schemas\/RecurringTemplateResponse"}}}}}}},"post":{"tags":["RecurringTemplates"],"requestBody":{"content":{"application\/json":{"schema":{"$ref":"#\/components\/schemas\/CreateRecurringTemplateRequest"}},"text\/json":{"schema":{"$ref":"#\/components\/schemas\/CreateRecurringTemplateRequest"}},"application\/*+json":{"schema":{"$ref":"#\/components\/schemas\/CreateRecurringTemplateRequest"}}}},"responses":{"201":{"description":"Created","content":{"text\/plain":{"schema":{"$ref":"#\/components\/schemas\/RecurringTemplateResponse"}},"application\/json":{"schema":{"$ref":"#\/components\/schemas\/RecurringTemplateResponse"}},"text\/json":{"schema":{"$ref":"#\/components\/schemas\/RecurringTemplateResponse"}}}}}}},"\/api\/v1\/recurring-templates\/{id}\/pause":{"post":{"tags":["RecurringTemplates"],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"OK","content":{"text\/plain":{"schema":{"$ref":"#\/components\/schemas\/RecurringTemplateResponse"}},"application\/json":{"schema":{"$ref":"#\/components\/schemas\/RecurringTemplateResponse"}},"text\/json":{"schema":{"$ref":"#\/components\/schemas\/RecurringTemplateResponse"}}}},"404":{"description":"Not Found","content":{"text\/plain":{"schema":{"$ref":"#\/components\/schemas\/ProblemDetails"}},"application\/json":{"schema":{"$ref":"#\/components\/schemas\/ProblemDetails"}},"text\/json":{"schema":{"$ref":"#\/components\/schemas\/ProblemDetails"}}}}}}},"\/api\/v1\/recurring-templates\/{id}\/resume":{"post":{"tags":["RecurringTemplates"],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"OK","content":{"text\/plain":{"schema":{"$ref":"#\/components\/schemas\/RecurringTemplateResponse"}},"application\/json":{"schema":{"$ref":"#\/components\/schemas\/RecurringTemplateResponse"}},"text\/json":{"schema":{"$ref":"#\/components\/schemas\/RecurringTemplateResponse"}}}},"404":{"description":"Not Found","content":{"text\/plain":{"schema":{"$ref":"#\/components\/schemas\/ProblemDetails"}},"application\/json":{"schema":{"$ref":"#\/components\/schemas\/ProblemDetails"}},"text\/json":{"schema":{"$ref":"#\/components\/schemas\/ProblemDetails"}}}}}}},"\/api\/v1\/recurring-templates\/{id}":{"delete":{"tags":["RecurringTemplates"],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"OK","content":{"text\/plain":{"schema":{"$ref":"#\/components\/schemas\/RecurringTemplateResponse"}},"application\/json":{"schema":{"$ref":"#\/components\/schemas\/RecurringTemplateResponse"}},"text\/json":{"schema":{"$ref":"#\/components\/schemas\/RecurringTemplateResponse"}}}},"404":{"description":"Not Found","content":{"text\/plain":{"schema":{"$ref":"#\/components\/schemas\/ProblemDetails"}},"application\/json":{"schema":{"$ref":"#\/components\/schemas\/ProblemDetails"}},"text\/json":{"schema":{"$ref":"#\/components\/schemas\/ProblemDetails"}}}}}}},"\/api\/v1\/suggestions":{"post":{"tags":["Suggestions"],"requestBody":{"content":{"application\/json":{"schema":{"$ref":"#\/components\/schemas\/SuggestionRequest"}},"text\/json":{"schema":{"$ref":"#\/components\/schemas\/SuggestionRequest"}},"application\/*+json":{"schema":{"$ref":"#\/components\/schemas\/SuggestionRequest"}}}},"responses":{"200":{"description":"OK","content":{"text\/plain":{"schema":{"$ref":"#\/components\/schemas\/SentResponse"}},"application\/json":{"schema":{"$ref":"#\/components\/schemas\/SentResponse"}},"text\/json":{"schema":{"$ref":"#\/components\/schemas\/SentResponse"}}}}}}},"\/api\/v1\/webhooks":{"get":{"tags":["Webhooks"],"responses":{"200":{"description":"OK","content":{"text\/plain":{"schema":{"type":"array","items":{"$ref":"#\/components\/schemas\/WebhookResponse"}}},"application\/json":{"schema":{"type":"array","items":{"$ref":"#\/components\/schemas\/WebhookResponse"}}},"text\/json":{"schema":{"type":"array","items":{"$ref":"#\/components\/schemas\/WebhookResponse"}}}}}}},"post":{"tags":["Webhooks"],"requestBody":{"content":{"application\/json":{"schema":{"$ref":"#\/components\/schemas\/CreateWebhookRequest"}},"text\/json":{"schema":{"$ref":"#\/components\/schemas\/CreateWebhookRequest"}},"application\/*+json":{"schema":{"$ref":"#\/components\/schemas\/CreateWebhookRequest"}}}},"responses":{"200":{"description":"OK","content":{"text\/plain":{"schema":{"$ref":"#\/components\/schemas\/WebhookCreatedResponse"}},"application\/json":{"schema":{"$ref":"#\/components\/schemas\/WebhookCreatedResponse"}},"text\/json":{"schema":{"$ref":"#\/components\/schemas\/WebhookCreatedResponse"}}}}}}},"\/api\/v1\/webhooks\/{id}\/test":{"post":{"tags":["Webhooks"],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"202":{"description":"Accepted","content":{"text\/plain":{"schema":{"$ref":"#\/components\/schemas\/QueuedResponse"}},"application\/json":{"schema":{"$ref":"#\/components\/schemas\/QueuedResponse"}},"text\/json":{"schema":{"$ref":"#\/components\/schemas\/QueuedResponse"}}}},"404":{"description":"Not Found","content":{"text\/plain":{"schema":{"$ref":"#\/components\/schemas\/ProblemDetails"}},"application\/json":{"schema":{"$ref":"#\/components\/schemas\/ProblemDetails"}},"text\/json":{"schema":{"$ref":"#\/components\/schemas\/ProblemDetails"}}}}}}},"\/api\/v1\/webhooks\/{id}":{"delete":{"tags":["Webhooks"],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"204":{"description":"No Content"},"404":{"description":"Not Found","content":{"text\/plain":{"schema":{"$ref":"#\/components\/schemas\/ProblemDetails"}},"application\/json":{"schema":{"$ref":"#\/components\/schemas\/ProblemDetails"}},"text\/json":{"schema":{"$ref":"#\/components\/schemas\/ProblemDetails"}}}}}}}},"components":{"schemas":{"AcceptReceivedRequest":{"type":"object","properties":{"acceptReason":{"type":"string","nullable":true}},"additionalProperties":false},"AccountStatusResponse":{"type":"object","properties":{"email":{"type":"string","nullable":true},"emailVerified":{"type":"boolean"},"receivingAddressPolicy":{"$ref":"#\/components\/schemas\/ReceivingAddressPolicy"},"approvedReceivingAddresses":{"type":"integer","format":"int32"},"approvedPayingAddresses":{"type":"integer","format":"int32"},"proposedAddresses":{"type":"integer","format":"int32"},"ownerCanApprove":{"type":"boolean"},"keyScopes":{"type":"array","items":{"type":"string"},"nullable":true},"outstandingFeesUsd":{"type":"number","format":"double"},"feesBlockCreation":{"type":"boolean"},"nextSteps":{"type":"array","items":{"type":"string"},"nullable":true}},"additionalProperties":false},"AccruedFeesResponse":{"type":"object","properties":{"outstandingUsd":{"type":"number","format":"double"},"draftCount":{"type":"integer","format":"int32"},"oldestAccruedAt":{"type":"string","format":"date-time","nullable":true},"maxOutstandingUsd":{"type":"number","format":"double"},"maxAgeDays":{"type":"integer","format":"int32"},"blocked":{"type":"boolean"},"activeSettlementDraftId":{"type":"string","format":"uuid","nullable":true}},"additionalProperties":false},"AddressBookEntryResponse":{"type":"object","properties":{"id":{"type":"string","format":"uuid"},"label":{"type":"string","nullable":true},"address":{"type":"string","nullable":true},"network":{"$ref":"#\/components\/schemas\/PaymentNetwork"},"direction":{"$ref":"#\/components\/schemas\/AddressDirection"},"verifiedAt":{"type":"string","format":"date-time","nullable":true},"createdAt":{"type":"string","format":"date-time"},"proposedByApiKeyId":{"type":"string","format":"uuid","nullable":true}},"additionalProperties":false},"AddressBookUpsertRequest":{"type":"object","properties":{"label":{"type":"string","nullable":true},"address":{"type":"string","nullable":true},"network":{"$ref":"#\/components\/schemas\/PaymentNetwork"},"verified":{"type":"boolean"},"direction":{"$ref":"#\/components\/schemas\/AddressDirection"}},"additionalProperties":false},"AddressDirection":{"enum":["Sending","Receiving"],"type":"string"},"AgentSignupRequest":{"type":"object","properties":{"email":{"type":"string","nullable":true},"agentName":{"type":"string","nullable":true},"intendedUse":{"type":"string","nullable":true}},"additionalProperties":false},"AgentSignupResponse":{"type":"object","properties":{"accountStatus":{"type":"string","nullable":true},"apiKey":{"type":"string","nullable":true},"keyScopes":{"type":"array","items":{"type":"string"},"nullable":true},"keyExpiresAt":{"type":"string","format":"date-time"},"ownerEmail":{"type":"string","nullable":true},"claimLinkExpiresAt":{"type":"string","format":"date-time"},"nextSteps":{"type":"array","items":{"type":"string"},"nullable":true}},"additionalProperties":false},"AmountMismatchInfo":{"type":"object","properties":{"txId":{"type":"string","nullable":true},"expectedBaseUnits":{"type":"integer","format":"int64"},"receivedBaseUnits":{"type":"integer","format":"int64"},"differenceBaseUnits":{"type":"integer","format":"int64"},"receivedFormatted":{"type":"string","nullable":true},"differenceFormatted":{"type":"string","nullable":true},"confirmations":{"type":"integer","format":"int32"},"detectedAt":{"type":"string","format":"date-time"},"acceptedAt":{"type":"string","format":"date-time","nullable":true},"acceptReason":{"type":"string","nullable":true},"acceptedBy":{"type":"string","nullable":true},"reviewState":{"type":"string","nullable":true},"rejectedAt":{"type":"string","format":"date-time","nullable":true},"rejectReason":{"type":"string","nullable":true},"rejectedBy":{"type":"string","nullable":true},"reviewReason":{"type":"string","nullable":true}},"additionalProperties":false},"ApiKeyCreatedResponse":{"type":"object","properties":{"id":{"type":"string","format":"uuid"},"key":{"type":"string","nullable":true},"keyPrefix":{"type":"string","nullable":true},"scopes":{"type":"array","items":{"type":"string"},"nullable":true},"expiresAt":{"type":"string","format":"date-time","nullable":true},"warning":{"type":"string","nullable":true}},"additionalProperties":false},"ApiKeyResponse":{"type":"object","properties":{"id":{"type":"string","format":"uuid"},"name":{"type":"string","nullable":true},"keyPrefix":{"type":"string","nullable":true},"scopes":{"type":"array","items":{"type":"string"},"nullable":true},"expiresAt":{"type":"string","format":"date-time","nullable":true},"lastUsedAt":{"type":"string","format":"date-time","nullable":true},"revokedAt":{"type":"string","format":"date-time","nullable":true},"createdAt":{"type":"string","format":"date-time"},"connectedApp":{"type":"string","nullable":true}},"additionalProperties":false},"AssertionResponse":{"required":["authenticatorData","clientDataJSON","signature"],"type":"object","properties":{"authenticatorData":{"type":"string","format":"byte","nullable":true},"signature":{"type":"string","format":"byte","nullable":true},"clientDataJSON":{"type":"string","format":"byte","nullable":true},"userHandle":{"type":"string","format":"byte","nullable":true}},"additionalProperties":false},"AttestationResponse":{"required":["attestationObject","clientDataJSON","transports"],"type":"object","properties":{"attestationObject":{"type":"string","format":"byte","nullable":true},"clientDataJSON":{"type":"string","format":"byte","nullable":true},"transports":{"type":"array","items":{"$ref":"#\/components\/schemas\/AuthenticatorTransport"}}},"additionalProperties":false},"AuthenticationExtensionsClientOutputs":{"type":"object","properties":{"example.extension.bool":{"type":"boolean","nullable":true},"appid":{"type":"boolean"},"exts":{"type":"array","items":{"type":"string"},"nullable":true},"uvm":{"type":"array","items":{"type":"array","items":{"type":"integer","format":"int64"}},"nullable":true},"credProps":{"$ref":"#\/components\/schemas\/CredentialPropertiesOutput"},"prf":{"$ref":"#\/components\/schemas\/AuthenticationExtensionsPRFOutputs"},"largeBlob":{"$ref":"#\/components\/schemas\/AuthenticationExtensionsLargeBlobOutputs"},"credProtect":{"$ref":"#\/components\/schemas\/CredentialProtectionPolicy"}},"additionalProperties":false},"AuthenticationExtensionsLargeBlobOutputs":{"type":"object","properties":{"supported":{"type":"boolean"},"blob":{"type":"string","format":"byte","nullable":true},"written":{"type":"boolean"}},"additionalProperties":false},"AuthenticationExtensionsPRFOutputs":{"type":"object","properties":{"enabled":{"type":"boolean"},"results":{"$ref":"#\/components\/schemas\/AuthenticationExtensionsPRFValues"}},"additionalProperties":false},"AuthenticationExtensionsPRFValues":{"required":["first"],"type":"object","properties":{"first":{"type":"string","format":"byte","nullable":true},"second":{"type":"string","format":"byte","nullable":true}},"additionalProperties":false},"AuthenticatorAssertionRawResponse":{"required":["clientExtensionResults","id","rawId","type"],"type":"object","properties":{"id":{"minLength":1,"type":"string"},"rawId":{"type":"string","format":"byte"},"response":{"$ref":"#\/components\/schemas\/AssertionResponse"},"type":{"$ref":"#\/components\/schemas\/PublicKeyCredentialType"},"extensions":{"$ref":"#\/components\/schemas\/AuthenticationExtensionsClientOutputs"},"clientExtensionResults":{"$ref":"#\/components\/schemas\/AuthenticationExtensionsClientOutputs"}},"additionalProperties":false},"AuthenticatorAttestationRawResponse":{"required":["clientExtensionResults","id","rawId","response","type"],"type":"object","properties":{"id":{"minLength":1,"type":"string"},"rawId":{"type":"string","format":"byte"},"type":{"$ref":"#\/components\/schemas\/PublicKeyCredentialType"},"response":{"$ref":"#\/components\/schemas\/AttestationResponse"},"extensions":{"$ref":"#\/components\/schemas\/AuthenticationExtensionsClientOutputs"},"clientExtensionResults":{"$ref":"#\/components\/schemas\/AuthenticationExtensionsClientOutputs"}},"additionalProperties":false},"AuthenticatorTransport":{"enum":["Usb","Nfc","Ble","SmartCard","Hybrid","Internal"],"type":"string"},"BatchCreateDraftsRequest":{"type":"object","properties":{"items":{"type":"array","items":{"$ref":"#\/components\/schemas\/BatchDraftItem"},"nullable":true}},"additionalProperties":false},"BatchDraftItem":{"type":"object","properties":{"draft":{"$ref":"#\/components\/schemas\/CreateDraftRequest"},"idempotencyKey":{"type":"string","nullable":true}},"additionalProperties":false},"BatchDraftResult":{"type":"object","properties":{"index":{"type":"integer","format":"int32"},"draft":{"$ref":"#\/components\/schemas\/DraftResponse"},"error":{"type":"string","nullable":true}},"additionalProperties":false},"CheckoutInfoResponse":{"type":"object","properties":{"token":{"type":"string","nullable":true},"fiatCurrency":{"type":"string","nullable":true},"fiatAmount":{"type":"number","format":"double"},"memo":{"type":"string","nullable":true},"status":{"$ref":"#\/components\/schemas\/PaymentRequestStatus"},"expiresAt":{"type":"string","format":"date-time"},"options":{"type":"array","items":{"$ref":"#\/components\/schemas\/CheckoutOptionInfo"},"nullable":true},"payment":{"$ref":"#\/components\/schemas\/CheckoutPaymentInfo"},"declineNote":{"type":"string","nullable":true},"changeSignals":{"type":"array","items":{"type":"string"},"nullable":true},"changeNotes":{"type":"array","items":{"type":"string"},"nullable":true},"receiver":{"$ref":"#\/components\/schemas\/ReceiverHistory"}},"additionalProperties":false},"CheckoutOptionInfo":{"type":"object","properties":{"currency":{"$ref":"#\/components\/schemas\/PaymentCurrency"},"network":{"$ref":"#\/components\/schemas\/PaymentNetwork"},"method":{"$ref":"#\/components\/schemas\/PaymentMethod"},"changeSignals":{"type":"array","items":{"type":"string"},"nullable":true},"changeNotes":{"type":"array","items":{"type":"string"},"nullable":true}},"additionalProperties":false},"CheckoutPaymentInfo":{"type":"object","properties":{"currency":{"$ref":"#\/components\/schemas\/PaymentCurrency"},"network":{"$ref":"#\/components\/schemas\/PaymentNetwork"},"address":{"type":"string","nullable":true},"amountBaseUnits":{"type":"integer","format":"int64"},"amountFormatted":{"type":"string","nullable":true},"uri":{"type":"string","nullable":true},"tokenAddress":{"type":"string","nullable":true},"status":{"$ref":"#\/components\/schemas\/DraftStatus"},"rate":{"type":"number","format":"double"},"rateSource":{"type":"string","nullable":true},"rateLockedUntil":{"type":"string","format":"date-time"},"paidTxId":{"type":"string","nullable":true},"receivedAmountFormatted":{"type":"string","nullable":true},"method":{"$ref":"#\/components\/schemas\/PaymentMethod"},"lightningConfirmable":{"type":"boolean"},"quoteId":{"type":"string","format":"uuid","nullable":true},"draftId":{"type":"string","format":"uuid","nullable":true},"reviewState":{"type":"string","nullable":true},"reviewReason":{"type":"string","nullable":true},"coreSha256":{"type":"string","nullable":true}},"additionalProperties":false},"CheckoutSelectRequest":{"type":"object","properties":{"currency":{"$ref":"#\/components\/schemas\/PaymentCurrency"},"network":{"$ref":"#\/components\/schemas\/PaymentNetwork"},"method":{"$ref":"#\/components\/schemas\/PaymentMethod"}},"additionalProperties":false},"CheckoutStatusResponse":{"type":"object","properties":{"status":{"$ref":"#\/components\/schemas\/PaymentRequestStatus"},"draftStatus":{"$ref":"#\/components\/schemas\/DraftStatus"},"paidTxId":{"type":"string","nullable":true},"confirmations":{"type":"integer","format":"int32"},"amountDiffers":{"type":"boolean"},"reviewState":{"type":"string","nullable":true}},"additionalProperties":false},"ClaimInfoResponse":{"type":"object","properties":{"email":{"type":"string","nullable":true},"agentName":{"type":"string","nullable":true},"intendedUse":{"type":"string","nullable":true},"createdAt":{"type":"string","format":"date-time"},"ceremonyId":{"type":"string","format":"uuid"},"passkeyOptions":{}},"additionalProperties":false},"ClaimPasskeyRequest":{"type":"object","properties":{"token":{"type":"string","nullable":true},"ceremonyId":{"type":"string","format":"uuid"},"credential":{"$ref":"#\/components\/schemas\/AuthenticatorAttestationRawResponse"},"credentialName":{"type":"string","nullable":true}},"additionalProperties":false},"ClaimPasswordRequest":{"type":"object","properties":{"token":{"type":"string","nullable":true},"password":{"type":"string","nullable":true}},"additionalProperties":false},"ClaimTokenRequest":{"type":"object","properties":{"token":{"type":"string","nullable":true}},"additionalProperties":false},"CreateApiKeyRequest":{"type":"object","properties":{"name":{"type":"string","nullable":true},"scopes":{"type":"array","items":{"type":"string"},"nullable":true},"expiresAt":{"type":"string","format":"date-time","nullable":true}},"additionalProperties":false},"CreateDemoDraftRequest":{"type":"object","properties":{"network":{"$ref":"#\/components\/schemas\/PaymentNetwork"},"currency":{"$ref":"#\/components\/schemas\/PaymentCurrency"}},"additionalProperties":false},"CreateDraftRequest":{"type":"object","properties":{"receiverAddress":{"type":"string","nullable":true},"network":{"$ref":"#\/components\/schemas\/PaymentNetwork"},"paymentMethod":{"$ref":"#\/components\/schemas\/PaymentMethod"},"amountSats":{"type":"integer","format":"int64","nullable":true},"fiatCurrency":{"type":"string","nullable":true},"fiatAmount":{"type":"number","format":"double","nullable":true},"senderAddress":{"type":"string","nullable":true},"bolt11":{"type":"string","nullable":true},"memo":{"type":"string","nullable":true},"expiryHours":{"type":"integer","format":"int32","nullable":true},"requiredConfirmations":{"type":"integer","format":"int32","nullable":true},"currency":{"$ref":"#\/components\/schemas\/PaymentCurrency"},"singleOutput":{"type":"boolean","nullable":true},"shortfallPolicy":{"$ref":"#\/components\/schemas\/ShortfallPolicyDto"}},"additionalProperties":false},"CreatePaymentRequestRequest":{"type":"object","properties":{"fiatCurrency":{"type":"string","nullable":true},"fiatAmount":{"type":"number","format":"double"},"options":{"type":"array","items":{"$ref":"#\/components\/schemas\/PaymentRequestOptionDto"},"nullable":true},"orderId":{"type":"string","nullable":true},"memo":{"type":"string","nullable":true},"expiryHours":{"type":"integer","format":"int32","nullable":true},"declineNote":{"type":"string","nullable":true},"shortfallPolicy":{"$ref":"#\/components\/schemas\/ShortfallPolicyDto"},"reuseOpenForOrder":{"type":"boolean","nullable":true}},"additionalProperties":false},"CreateRecurringTemplateRequest":{"type":"object","properties":{"name":{"type":"string","nullable":true},"interval":{"$ref":"#\/components\/schemas\/RecurrenceInterval"},"firstRunAt":{"type":"string","format":"date-time","nullable":true},"draft":{"$ref":"#\/components\/schemas\/CreateDraftRequest"}},"additionalProperties":false},"CreateWebhookRequest":{"type":"object","properties":{"url":{"type":"string","nullable":true},"events":{"type":"array","items":{"type":"string"},"nullable":true}},"additionalProperties":false},"CredentialInfo":{"type":"object","properties":{"id":{"type":"string","format":"uuid"},"name":{"type":"string","nullable":true},"createdAt":{"type":"string","format":"date-time"},"lastUsedAt":{"type":"string","format":"date-time","nullable":true}},"additionalProperties":false},"CredentialPropertiesOutput":{"type":"object","properties":{"rk":{"type":"boolean"},"authenticatorDisplayName":{"type":"string","nullable":true}},"additionalProperties":false},"CredentialProtectionPolicy":{"enum":["UserVerificationOptional","UserVerificationOptionalWithCredentialIdList","UserVerificationRequired"],"type":"string"},"DemoConfigResponse":{"type":"object","properties":{"enabled":{"type":"boolean"},"expiryMinutes":{"type":"integer","format":"int32"},"networks":{"type":"array","items":{"$ref":"#\/components\/schemas\/DemoNetworkInfo"},"nullable":true}},"additionalProperties":false},"DemoDraftResponse":{"type":"object","properties":{"id":{"type":"string","format":"uuid"},"network":{"$ref":"#\/components\/schemas\/PaymentNetwork"},"currency":{"$ref":"#\/components\/schemas\/PaymentCurrency"},"receiverAddress":{"type":"string","nullable":true},"amountBaseUnits":{"type":"integer","format":"int64"},"amountFormatted":{"type":"string","nullable":true},"tokenAddress":{"type":"string","nullable":true},"paymentUri":{"type":"string","nullable":true},"status":{"$ref":"#\/components\/schemas\/DraftStatus"},"paidTxId":{"type":"string","nullable":true},"confirmations":{"type":"integer","format":"int32"},"requiredConfirmations":{"type":"integer","format":"int32"},"expiresAt":{"type":"string","format":"date-time"},"createdAt":{"type":"string","format":"date-time"}},"additionalProperties":false},"DemoNetworkInfo":{"type":"object","properties":{"network":{"$ref":"#\/components\/schemas\/PaymentNetwork"},"currencies":{"type":"array","items":{"$ref":"#\/components\/schemas\/PaymentCurrency"},"nullable":true}},"additionalProperties":false},"DraftListResponse":{"type":"object","properties":{"total":{"type":"integer","format":"int32"},"page":{"type":"integer","format":"int32"},"pageSize":{"type":"integer","format":"int32"},"items":{"type":"array","items":{"$ref":"#\/components\/schemas\/DraftResponse"},"nullable":true}},"additionalProperties":false},"DraftResponse":{"type":"object","properties":{"id":{"type":"string","format":"uuid"},"receiverAddress":{"type":"string","nullable":true},"senderAddress":{"type":"string","nullable":true},"network":{"$ref":"#\/components\/schemas\/PaymentNetwork"},"amountSats":{"type":"integer","format":"int64"},"amountBtc":{"type":"string","nullable":true},"fiatCurrency":{"type":"string","nullable":true},"fiatAmount":{"type":"number","format":"double","nullable":true},"quote":{"$ref":"#\/components\/schemas\/QuoteInfo"},"platformFeeSats":{"type":"integer","format":"int64"},"platformFeeAddress":{"type":"string","nullable":true},"platformFee":{"$ref":"#\/components\/schemas\/PlatformFeeInfo"},"paymentMethod":{"$ref":"#\/components\/schemas\/PaymentMethod"},"bolt11":{"type":"string","nullable":true},"memo":{"type":"string","nullable":true},"status":{"$ref":"#\/components\/schemas\/DraftStatus"},"paidTxId":{"type":"string","nullable":true},"requiredConfirmations":{"type":"integer","format":"int32"},"expiresAt":{"type":"string","format":"date-time"},"createdAt":{"type":"string","format":"date-time"},"updatedAt":{"type":"string","format":"date-time"},"sek":{"$ref":"#\/components\/schemas\/SekValueInfo"},"feeOutputs":{"type":"array","items":{"$ref":"#\/components\/schemas\/FeeOutputInfo"},"nullable":true},"currency":{"$ref":"#\/components\/schemas\/PaymentCurrency"},"tokenAddress":{"type":"string","nullable":true},"feeAccrued":{"type":"boolean"},"isFeeSettlement":{"type":"boolean"},"paymentUri":{"type":"string","nullable":true},"amountMismatch":{"$ref":"#\/components\/schemas\/AmountMismatchInfo"},"lightningAddress":{"type":"string","nullable":true},"lightningConfirmable":{"type":"boolean"},"paymentRequestId":{"type":"string","format":"uuid","nullable":true},"amountBaseUnits":{"type":"integer","format":"int64"},"core":{"type":"object","additionalProperties":{"nullable":true},"nullable":true},"coreSha256":{"type":"string","nullable":true},"changeSignals":{"type":"array","items":{"type":"string"},"nullable":true},"changeNotes":{"type":"array","items":{"type":"string"},"nullable":true},"shortfallPolicy":{"$ref":"#\/components\/schemas\/ShortfallPolicyDto"},"confirmedAt":{"type":"string","format":"date-time","nullable":true}},"additionalProperties":false},"DraftStatus":{"enum":["AwaitingPayment","Seen","Confirmed","Expired","Cancelled"],"type":"string"},"DraftStatusResponse":{"type":"object","properties":{"id":{"type":"string","format":"uuid"},"status":{"$ref":"#\/components\/schemas\/DraftStatus"},"paidTxId":{"type":"string","nullable":true},"confirmations":{"type":"integer","format":"int32"},"updatedAt":{"type":"string","format":"date-time"},"reviewState":{"type":"string","nullable":true},"confirmedAt":{"type":"string","format":"date-time","nullable":true}},"additionalProperties":false},"EmailCodeCompleteRequest":{"type":"object","properties":{"ceremonyId":{"type":"string","format":"uuid"},"code":{"type":"string","nullable":true}},"additionalProperties":false},"FeeBreakdownResponse":{"type":"object","properties":{"receiverAmountSats":{"type":"integer","format":"int64"},"platformFeePercent":{"type":"number","format":"double","nullable":true},"platformFeeUsd":{"type":"number","format":"double","nullable":true},"platformFeeSats":{"type":"integer","format":"int64"},"platformFeeWaived":{"type":"boolean"},"platformFeeAddress":{"type":"string","nullable":true},"networkFee":{"$ref":"#\/components\/schemas\/NetworkFeeEstimateInfo"},"totalOutputsSats":{"type":"integer","format":"int64"},"estimatedTotalLeavingWalletSats":{"type":"integer","format":"int64","nullable":true},"fiat":{"$ref":"#\/components\/schemas\/FiatEquivalents"},"feeOutputs":{"type":"array","items":{"$ref":"#\/components\/schemas\/FeeOutputInfo"},"nullable":true},"tax":{"$ref":"#\/components\/schemas\/FeeTaxInfo"},"note":{"type":"string","nullable":true}},"additionalProperties":false},"FeeOutputInfo":{"type":"object","properties":{"recipient":{"type":"string","nullable":true},"address":{"type":"string","nullable":true},"sats":{"type":"integer","format":"int64"},"sharePercent":{"type":"number","format":"double"}},"additionalProperties":false},"FeeScheduleResponse":{"type":"object","properties":{"tiers":{"type":"array","items":{"$ref":"#\/components\/schemas\/FeeTierDto"},"nullable":true},"minFeeUsd":{"type":"number","format":"double"},"maxFeeUsd":{"type":"number","format":"double"},"dustLimitSats":{"type":"integer","format":"int64"},"pricedIn":{"type":"string","nullable":true},"note":{"type":"string","nullable":true}},"additionalProperties":false},"FeeTaxInfo":{"type":"object","properties":{"vatCharged":{"type":"boolean"},"vatRatePercent":{"type":"number","format":"double","nullable":true},"vatSek":{"type":"number","format":"double","nullable":true},"feeSek":{"type":"number","format":"double","nullable":true},"feeExVatSek":{"type":"number","format":"double","nullable":true},"status":{"type":"string","nullable":true}},"additionalProperties":false},"FeeTierDto":{"type":"object","properties":{"upToUsd":{"type":"number","format":"double","nullable":true},"percent":{"type":"number","format":"double"}},"additionalProperties":false},"FiatEquivalents":{"type":"object","properties":{"currency":{"type":"string","nullable":true},"ratePerBtc":{"type":"number","format":"double"},"rateSource":{"type":"string","nullable":true},"receiverAmount":{"type":"number","format":"double"},"platformFee":{"type":"number","format":"double"},"networkFeeEstimate":{"type":"number","format":"double","nullable":true},"totalOutputs":{"type":"number","format":"double"},"estimatedTotalLeavingWallet":{"type":"number","format":"double","nullable":true}},"additionalProperties":false},"LightningProofRequest":{"type":"object","properties":{"preimage":{"type":"string","nullable":true}},"additionalProperties":false},"LoginCompleteRequest":{"type":"object","properties":{"ceremonyId":{"type":"string","format":"uuid"},"credential":{"$ref":"#\/components\/schemas\/AuthenticatorAssertionRawResponse"},"totpCode":{"type":"string","nullable":true}},"additionalProperties":false},"MeResponse":{"type":"object","properties":{"id":{"type":"string","format":"uuid"},"email":{"type":"string","nullable":true},"displayName":{"type":"string","nullable":true},"totpEnabled":{"type":"boolean"},"hasPassword":{"type":"boolean"},"isAdmin":{"type":"boolean"},"credentials":{"type":"array","items":{"$ref":"#\/components\/schemas\/CredentialInfo"},"nullable":true},"receivingAddressPolicy":{"$ref":"#\/components\/schemas\/ReceivingAddressPolicy"}},"additionalProperties":false},"NetworkFeeEstimateInfo":{"type":"object","properties":{"satPerVb":{"type":"number","format":"double"},"estimatedVsize":{"type":"integer","format":"int32"},"estimatedSats":{"type":"integer","format":"int64"},"basis":{"type":"string","nullable":true}},"additionalProperties":false},"OptionChangeSignalsInfo":{"type":"object","properties":{"currency":{"$ref":"#\/components\/schemas\/PaymentCurrency"},"network":{"$ref":"#\/components\/schemas\/PaymentNetwork"},"method":{"$ref":"#\/components\/schemas\/PaymentMethod"},"signals":{"type":"array","items":{"type":"string"},"nullable":true},"notes":{"type":"array","items":{"type":"string"},"nullable":true}},"additionalProperties":false},"PasswordChangeRequest":{"type":"object","properties":{"currentPassword":{"type":"string","nullable":true},"newPassword":{"type":"string","nullable":true}},"additionalProperties":false},"PasswordForgotCompleteRequest":{"type":"object","properties":{"ceremonyId":{"type":"string","format":"uuid"},"code":{"type":"string","nullable":true},"newPassword":{"type":"string","nullable":true},"totpCode":{"type":"string","nullable":true}},"additionalProperties":false},"PasswordForgotRequest":{"type":"object","properties":{"email":{"type":"string","nullable":true}},"additionalProperties":false},"PasswordLoginRequest":{"type":"object","properties":{"email":{"type":"string","nullable":true},"password":{"type":"string","nullable":true},"totpCode":{"type":"string","nullable":true}},"additionalProperties":false},"PasswordRegisterRequest":{"type":"object","properties":{"email":{"type":"string","nullable":true},"password":{"type":"string","nullable":true},"displayName":{"type":"string","nullable":true}},"additionalProperties":false},"PaymentCurrency":{"enum":["Btc","Usdc","Usdt","Eurc","Sol","Eth"],"type":"string"},"PaymentMethod":{"enum":["MultiOutput","Lightning"],"type":"string"},"PaymentNetwork":{"enum":["Mainnet","Testnet4","Signet","Regtest","Solana","SolanaDevnet","Ethereum","EthereumSepolia","Base","BaseSepolia","Arbitrum","ArbitrumSepolia","Polygon","PolygonAmoy"],"type":"string"},"PaymentRequestFeeInfo":{"type":"object","properties":{"percent":{"type":"number","format":"double","nullable":true},"feeUsd":{"type":"number","format":"double","nullable":true},"feeBaseUnits":{"type":"integer","format":"int64"},"feeAmount":{"type":"string","nullable":true},"currency":{"type":"string","nullable":true},"waived":{"type":"boolean"},"settledAt":{"type":"string","format":"date-time","nullable":true}},"additionalProperties":false},"PaymentRequestOptionDto":{"type":"object","properties":{"currency":{"$ref":"#\/components\/schemas\/PaymentCurrency"},"network":{"$ref":"#\/components\/schemas\/PaymentNetwork"},"address":{"type":"string","nullable":true},"method":{"$ref":"#\/components\/schemas\/PaymentMethod"}},"additionalProperties":false},"PaymentRequestResponse":{"type":"object","properties":{"id":{"type":"string","format":"uuid"},"shareToken":{"type":"string","nullable":true},"payPath":{"type":"string","nullable":true},"orderId":{"type":"string","nullable":true},"fiatCurrency":{"type":"string","nullable":true},"fiatAmount":{"type":"number","format":"double"},"memo":{"type":"string","nullable":true},"status":{"$ref":"#\/components\/schemas\/PaymentRequestStatus"},"expiresAt":{"type":"string","format":"date-time"},"createdAt":{"type":"string","format":"date-time"},"options":{"type":"array","items":{"$ref":"#\/components\/schemas\/PaymentRequestOptionDto"},"nullable":true},"activeDraftId":{"type":"string","format":"uuid","nullable":true},"draftStatus":{"$ref":"#\/components\/schemas\/DraftStatus"},"fee":{"$ref":"#\/components\/schemas\/PaymentRequestFeeInfo"},"amountMismatch":{"$ref":"#\/components\/schemas\/AmountMismatchInfo"},"declineNote":{"type":"string","nullable":true},"shortfallPolicy":{"$ref":"#\/components\/schemas\/ShortfallPolicyDto"},"changeSignals":{"type":"array","items":{"type":"string"},"nullable":true},"changeNotes":{"type":"array","items":{"type":"string"},"nullable":true},"optionChangeSignals":{"type":"array","items":{"$ref":"#\/components\/schemas\/OptionChangeSignalsInfo"},"nullable":true}},"additionalProperties":false},"PaymentRequestStatus":{"enum":["Open","Completed","Cancelled","Expired"],"type":"string"},"PlatformFeeInfo":{"type":"object","properties":{"percent":{"type":"number","format":"double","nullable":true},"usd":{"type":"number","format":"double","nullable":true},"sats":{"type":"integer","format":"int64"},"waived":{"type":"boolean"},"usdPerBtc":{"type":"number","format":"double","nullable":true},"rateSource":{"type":"string","nullable":true}},"additionalProperties":false},"ProblemDetails":{"type":"object","properties":{"type":{"type":"string","nullable":true},"title":{"type":"string","nullable":true},"status":{"type":"integer","format":"int32","nullable":true},"detail":{"type":"string","nullable":true},"instance":{"type":"string","nullable":true}},"additionalProperties":{}},"PublicKeyCredentialType":{"enum":["PublicKey","Invalid"],"type":"string"},"QueuedResponse":{"type":"object","properties":{"queued":{"type":"boolean"}},"additionalProperties":false},"QuoteInfo":{"type":"object","properties":{"source":{"type":"string","nullable":true},"rate":{"type":"number","format":"double"},"lockedAt":{"type":"string","format":"date-time"},"expiresAt":{"type":"string","format":"date-time"},"schema":{"type":"string","nullable":true},"id":{"type":"string","format":"uuid"},"draftId":{"type":"string","format":"uuid"},"network":{"$ref":"#\/components\/schemas\/PaymentNetwork"},"currency":{"$ref":"#\/components\/schemas\/PaymentCurrency"},"tokenAddress":{"type":"string","nullable":true},"cryptoAmountBaseUnits":{"type":"integer","format":"int64"},"platformFeeBaseUnits":{"type":"integer","format":"int64"},"fiatAmount":{"type":"number","format":"double"},"fiatCurrency":{"type":"string","nullable":true},"rateSource":{"type":"string","nullable":true},"bolt11":{"type":"string","nullable":true},"lockedUntil":{"type":"string","format":"date-time"},"sha256":{"type":"string","nullable":true}},"additionalProperties":false},"RateResponse":{"type":"object","properties":{"currency":{"type":"string","nullable":true},"btcRate":{"type":"number","format":"double"},"source":{"type":"string","nullable":true},"fetchedAt":{"type":"string","format":"date-time"}},"additionalProperties":false},"ReceiverHistory":{"type":"object","properties":{"joinedMonth":{"type":"string","nullable":true},"completedPayments":{"type":"string","nullable":true},"isNew":{"type":"boolean"}},"additionalProperties":false},"ReceivingAddressPolicy":{"enum":["InlineAllowed","ApprovedOnly"],"type":"string"},"ReceivingAddressPolicyRequest":{"type":"object","properties":{"policy":{"$ref":"#\/components\/schemas\/ReceivingAddressPolicy"}},"additionalProperties":false},"ReceivingAddressPolicyResponse":{"type":"object","properties":{"policy":{"$ref":"#\/components\/schemas\/ReceivingAddressPolicy"}},"additionalProperties":false},"RecurrenceInterval":{"enum":["Daily","Weekly","Monthly"],"type":"string"},"RecurringTemplateResponse":{"type":"object","properties":{"id":{"type":"string","format":"uuid"},"name":{"type":"string","nullable":true},"interval":{"$ref":"#\/components\/schemas\/RecurrenceInterval"},"nextRunAt":{"type":"string","format":"date-time"},"lastRunAt":{"type":"string","format":"date-time","nullable":true},"lastError":{"type":"string","nullable":true},"isActive":{"type":"boolean"},"draft":{"$ref":"#\/components\/schemas\/CreateDraftRequest"},"createdAt":{"type":"string","format":"date-time"}},"additionalProperties":false},"RegisterBeginRequest":{"type":"object","properties":{"email":{"type":"string","nullable":true},"displayName":{"type":"string","nullable":true}},"additionalProperties":false},"RegisterCompleteRequest":{"type":"object","properties":{"ceremonyId":{"type":"string","format":"uuid"},"credential":{"$ref":"#\/components\/schemas\/AuthenticatorAttestationRawResponse"},"credentialName":{"type":"string","nullable":true}},"additionalProperties":false},"RejectReceivedRequest":{"type":"object","properties":{"rejectReason":{"type":"string","nullable":true}},"additionalProperties":false},"SekValueInfo":{"type":"object","properties":{"ratePerBtc":{"type":"number","format":"double"},"rateSource":{"type":"string","nullable":true},"amount":{"type":"number","format":"double","nullable":true},"platformFee":{"type":"number","format":"double","nullable":true},"vatRatePercent":{"type":"number","format":"double","nullable":true},"platformFeeVat":{"type":"number","format":"double","nullable":true}},"additionalProperties":false},"SentResponse":{"type":"object","properties":{"sent":{"type":"boolean"}},"additionalProperties":false},"SettleAccruedFeesRequest":{"type":"object","properties":{"currency":{"$ref":"#\/components\/schemas\/PaymentCurrency"},"network":{"$ref":"#\/components\/schemas\/PaymentNetwork"}},"additionalProperties":false},"ShortfallPolicyDto":{"type":"object","properties":{"absorbUpToPercent":{"type":"number","format":"double"},"absorbedBy":{"type":"string","nullable":true}},"additionalProperties":false},"StepUpCompleteRequest":{"type":"object","properties":{"ceremonyId":{"type":"string","format":"uuid","nullable":true},"credential":{"$ref":"#\/components\/schemas\/AuthenticatorAssertionRawResponse"},"totpCode":{"type":"string","nullable":true}},"additionalProperties":false},"SuggestionRequest":{"type":"object","properties":{"title":{"type":"string","nullable":true},"description":{"type":"string","nullable":true}},"additionalProperties":false},"TokenTemplateInfo":{"type":"object","properties":{"currency":{"$ref":"#\/components\/schemas\/PaymentCurrency"},"tokenAddress":{"type":"string","nullable":true},"decimals":{"type":"integer","format":"int32"},"atomic":{"type":"boolean"},"transfers":{"type":"array","items":{"$ref":"#\/components\/schemas\/TokenTransferInfo"},"nullable":true}},"additionalProperties":false},"TokenTransferInfo":{"type":"object","properties":{"to":{"type":"string","nullable":true},"amountBaseUnits":{"type":"integer","format":"int64"},"amountFormatted":{"type":"string","nullable":true},"purpose":{"type":"string","nullable":true},"uri":{"type":"string","nullable":true},"calldata":{"type":"string","nullable":true}},"additionalProperties":false},"TotpCodeRequest":{"type":"object","properties":{"code":{"type":"string","nullable":true}},"additionalProperties":false},"TxTemplateOutput":{"type":"object","properties":{"address":{"type":"string","nullable":true},"amountSats":{"type":"integer","format":"int64"},"amountBtc":{"type":"string","nullable":true},"purpose":{"type":"string","nullable":true}},"additionalProperties":false},"TxTemplateResponse":{"type":"object","properties":{"outputs":{"type":"array","items":{"$ref":"#\/components\/schemas\/TxTemplateOutput"},"nullable":true},"walletRpcExample":{"type":"string","nullable":true},"payToManyCsv":{"type":"string","nullable":true},"note":{"type":"string","nullable":true},"kind":{"type":"string","nullable":true},"token":{"$ref":"#\/components\/schemas\/TokenTemplateInfo"}},"additionalProperties":false},"WebhookCreatedResponse":{"type":"object","properties":{"id":{"type":"string","format":"uuid"},"secret":{"type":"string","nullable":true},"warning":{"type":"string","nullable":true}},"additionalProperties":false},"WebhookResponse":{"type":"object","properties":{"id":{"type":"string","format":"uuid"},"url":{"type":"string","nullable":true},"events":{"type":"array","items":{"type":"string"},"nullable":true},"isActive":{"type":"boolean"},"createdAt":{"type":"string","format":"date-time"}},"additionalProperties":false}},"securitySchemes":{"ApiKey":{"type":"http","description":"AI-agent API key (Authorization: Bearer s21_...). Humans use passkey session cookies instead.","scheme":"bearer","bearerFormat":"s21_..."}}},"security":[{"ApiKey":[]}],"tags":[{"name":"Account"},{"name":"AddressBook"},{"name":"ApiKeys"},{"name":"Auth"},{"name":"Checkout"},{"name":"Demo"},{"name":"Drafts"},{"name":"Fees"},{"name":"PaymentRequests"},{"name":"Rates"},{"name":"RecurringTemplates"},{"name":"Suggestions"},{"name":"Webhooks","description":"**send21 calls your server when a draft changes.** Register an endpoint with `POST \/api\/v1\/webhooks`\n(scope `webhooks:manage`) and pick the events you want. The response contains the signing secret\nonce; store it. Send a signed test event any time with `POST \/api\/v1\/webhooks\/{id}\/test`.\n\n### Delivery\n\nA `POST` to your URL with `Content-Type: application\/json` and this body:\n\n```json\n{ \"event\": \"draft.confirmed\", \"data\": { ... } }\n```\n\n| Header | Meaning |\n|---|---|\n| `X-Send21-Event` | The event type, same as `event` in the body. |\n| `X-Send21-Delivery` | Unique delivery id. Retries reuse it, so use it to ignore duplicates. |\n| `X-Send21-Signature-V2` | `t=<timestamp>,v1=<hex HMAC-SHA256 of \"<timestamp>.<delivery id>.<raw body>\">`, keyed with your secret. Verify this one: it also signs the time and the delivery id, so a copied delivery cannot be replayed later. Refuse deliveries older than 5 minutes (300 seconds). |\n| `X-Send21-Timestamp` | When the delivery was sent, in Unix seconds (the same value as `t=`). |\n| `X-Send21-Signature` | Original signature, only for endpoints registered before 16 November 2026: `sha256=` followed by the lowercase hex HMAC-SHA256 of the raw body only. It has no timestamp, so a copied delivery passes it again. Endpoints registered since get V2 only. |\n\nAny 2xx response counts as delivered. Anything else, or no answer within 15 seconds, is retried\nafter 1, 2, 4, 8 minutes and so on, up to 8 attempts. Deliveries can arrive out of order.\n\n### Verifying the signature\n\nCheck `X-Send21-Signature-V2`: compute the HMAC over `<timestamp>.<delivery id>.<raw body>`, using the\nraw request bytes before parsing the JSON, compare in constant time, and refuse deliveries more than\n300 seconds old. Answer 401 when the header is missing or wrong. The same check as on\nsend21.io\/docs\/webhooks:\n\n```js\n\/\/ X-Send21-Signature-V2: t=<unix seconds>,v1=<hex HMAC-SHA256 of \"<t>.<delivery id>.<raw body>\">\nconst sig = String(req.headers['x-send21-signature-v2'] ?? '');\nconst t = \/(?:^|,)t=(\\d+)\/.exec(sig)?.[1];\nconst v1 = \/(?:^|,)v1=([0-9a-f]{64})\/.exec(sig)?.[1];\nconst deliveryId = String(req.headers['x-send21-delivery'] ?? '');\nconst fresh = t !== undefined && Math.abs(Date.now() \/ 1000 - Number(t)) <= 300;\nconst expected = crypto.createHmac('sha256', secret)\n  .update(t + '.' + deliveryId + '.').update(rawBody).digest('hex');\nconst ok = fresh && v1 !== undefined &&\n  crypto.timingSafeEqual(Buffer.from(v1, 'hex'), Buffer.from(expected, 'hex'));\nif (!ok) return res.status(401).end();\n```\n\nBefore you ship goods, check that the confirmed amount, currency and `orderId` are the ones you\nexpect, or fetch `GET \/api\/v1\/drafts\/{id}` with your API key and check its status there.\n\n### Events\n\n| Event | When |\n|---|---|\n| `draft.created` | A draft was created: by you, an API key, a recurring template, or a payer picking a currency on a pay link. |\n| `draft.seen` | A payment for the draft was seen, but is not confirmed yet. Also sent when you accept a payment with a different amount (`acceptedByOwner: true`); `draft.confirmed` follows once that transfer has the required confirmations. |\n| `draft.confirmed` | The payment reached the required confirmations. For Lightning: the provider confirmed it with a valid preimage. |\n| `draft.amount_mismatch` | A transfer needs your decision (`reviewState: pending`). `reviewReason: \"amount\"`: it arrived within 10% of the billed amount, but not the exact amount. `reviewReason: \"rate_lock_expired\"`: a pay-link payment of the exact amount arrived more than 10 minutes after its rate lock ended, so it was priced at an older rate. It does not pay the draft until you accept it with `POST \/api\/v1\/drafts\/{id}\/accept-received`; decline it with `POST \/api\/v1\/drafts\/{id}\/reject-received`. Sent once. |\n| `draft.mismatch_accepted` | A payment with a different amount was accepted, by you (`acceptReason`) or by the draft's `shortfallPolicy` (`acceptReason: \"auto: shortfallPolicy\"`). Carries `expectedAmountSats`, `receivedAmountSats`, `acceptedBy` and `acceptedAt`. |\n| `draft.mismatch_rejected` | You declined it (`rejectReason`, `rejectedBy`, `rejectedAt`). `refund: \"manual\"`: the money is in your wallet and send21 cannot return it. |\n| `draft.mismatch_reminder` | Still undecided 2 hours before the draft expires. Sent once. |\n| `draft.mismatch_unresolved` | The draft expired or was cancelled while the transfer was undecided. The money arrived and is in your wallet; you can still accept it. |\n| `draft.expired` | The draft expired unpaid. If an undecided transfer with a different amount arrived, `receivedAmountSats` is set and `reviewState` is `unresolved`. Pay-link payments also carry `opened`, `quoteRequested`, `firstOpenedAt` and `quoteRequestedAt`. |\n| `draft.cancelled` | The draft was cancelled. |\n| `payment_request.expired` | A pay link expired unpaid. `opened`: the payer loaded the pay page (link previews and bots ignored). `quoteRequested`: they picked a currency. `reviewState` if a differing transfer arrived. No IP or payer data. |\n| `test` | Sent by the test endpoint. `data` has `message` and `occurredAt`. |\n\n### Payload of draft.seen, draft.confirmed, draft.amount_mismatch and draft.expired\n\nAmounts ending in `Sats` are base units of the sent asset: 8 decimals for BTC, 6 for USDC, USDT and\nEURC, 9 for SOL and ETH (ETH amounts are in gwei). `txId` is the transaction id or signature; for Lightning it is the payment hash. For native ETH\nfound by the balance fallback from a smart-wallet transfer, it is `block-<number>`.\n`receivedAmountSats` and `receivedAmount` are set only when the amount differs from the billed amount,\nincluding on the `draft.confirmed` of an accepted short or over payment, so you can record what arrived.\n`paymentRequestId` and `orderId` are set for pay-link payments.\n\n```json\n{\n  \"event\": \"draft.amount_mismatch\",\n  \"data\": {\n    \"draftId\": \"3f6c2a9e-5d1b-4c8e-9a7f-2b4d6e8f0a1c\",\n    \"status\": \"AwaitingPayment\",\n    \"txId\": \"5KqZ9bQ...\",\n    \"confirmations\": 1,\n    \"receivedAmountSats\": 49250000,\n    \"receivedAmount\": \"49.250000\",\n    \"sentCurrency\": \"USDC\",\n    \"network\": \"Solana\",\n    \"amountSats\": 50000000,\n    \"sentAmount\": \"50.000000\",\n    \"fiatCurrency\": \"EUR\",\n    \"fiatAmount\": 46.00,\n    \"conversionRate\": 0.92,\n    \"rateSource\": \"coinbase\",\n    \"platformFee\": {\n      \"accrued\": true, \"waived\": false, \"percent\": 0.39, \"feeUsd\": 0.20,\n      \"feeBaseUnits\": 195000, \"feeAmount\": \"0.195000\", \"currency\": \"USDC\"\n    },\n    \"paymentRequestId\": \"8d1e4b7a-0c2f-4e6d-b3a9-7f5c1e2d4a6b\",\n    \"orderId\": \"ORDER-1042\",\n    \"occurredAt\": \"2026-10-06T08:22:22Z\"\n  }\n}\n```\n\n### Payload of draft.created and draft.cancelled\n\n`draft.created` has `draftId`, `amountSats`, `network` and `occurredAt`; pay-link drafts add\n`paymentRequestId`, `orderId` and `currency`. `draft.cancelled` has `draftId`, `status`, `network`,\n`amountSats`, `paymentRequestId` and `occurredAt`."}]}