send21-io Fees API

The Fees API from send21-io — 3 operation(s) for fees.

Operations 3

GET /api/v1/fees/schedule Get api fees schedule #
GET /api/v1/fees/accrued Get api fees accrued #
POST /api/v1/fees/accrued/settle Create api fees accrued settle #

Work with this as data

Every API here is available over the APIs.io API and to AI agents over MCP.

MCP server

One button, every client — Claude, Cursor, VS Code and the rest.

https://apis.io/mcp

Tools for apis

7 MCP tools reach this
  • find_apisBrowse and filter every API in the catalog.
  • get_api_artifactsOne API's artifacts, grouped by type.
  • get_openapiThe primary OpenAPI for this API.
  • find_similar_apisAPIs that look like this one.
  • apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.
  • resolveTurn a domain, URL or GitHub org into the provider it belongs to.
  • find_cohortsEvery scored population of providers in the catalog.
All 92 tools →

Call it yourself

curl for this page
This API
curl "https://apis.io/api/v1/apis/send21-io:send21-io-fees-api"
All apis
curl "https://apis.io/api/v1/apis?limit=25"

Discovery needs no key. Ratings and market analysis are Pro.

Get an API key

Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.

A second provider on the same verified email joins the account you already have.

OpenAPI Specification

send21-io-fees-api-openapi.yml Raw ↑
openapi: 3.2.0
info:
  title: Send21 Io Fees API
  version: v1
  contact:
    name: send21 integration support
    email: integration@send21.io
  description: 'Operations tagged Fees across 2 of this provider''s published API definitions: send21-io-openapi.json, swagger.json. Each path carries the servers of the definition it was published in.'
servers:
- url: https://send21.io
security:
- ApiKey: []
tags:
- name: Fees
paths:
  /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'
      summary: Get api fees schedule
      x-summary-source: derived
      operationId: getApiV1FeesSchedule
      x-operation-id-source: derived
    servers:
    - url: https://send21.io
  /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'
      summary: Get api fees accrued
      x-summary-source: derived
      operationId: getApiV1FeesAccrued
      x-operation-id-source: derived
    servers:
    - url: https://send21.io
  /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'
      summary: Create api fees accrued settle
      x-summary-source: derived
      operationId: postApiV1FeesAccruedSettle
      x-operation-id-source: derived
    servers:
    - url: https://send21.io
components:
  schemas:
    QuoteInfo:
      type: object
      properties:
        source:
          type:
          - string
          - 'null'
        rate:
          type: number
          format: double
        lockedAt:
          type: string
          format: date-time
        expiresAt:
          type: string
          format: date-time
        schema:
          type:
          - string
          - 'null'
        id:
          type: string
          format: uuid
        draftId:
          type: string
          format: uuid
        network:
          $ref: '#/components/schemas/PaymentNetwork'
        currency:
          $ref: '#/components/schemas/PaymentCurrency'
        tokenAddress:
          type:
          - string
          - 'null'
        cryptoAmountBaseUnits:
          type: integer
          format: int64
        platformFeeBaseUnits:
          type: integer
          format: int64
        fiatAmount:
          type: number
          format: double
        fiatCurrency:
          type:
          - string
          - 'null'
        rateSource:
          type:
          - string
          - 'null'
        bolt11:
          type:
          - string
          - 'null'
        lockedUntil:
          type: string
          format: date-time
        sha256:
          type:
          - string
          - 'null'
      additionalProperties: false
    PaymentNetwork:
      enum:
      - Mainnet
      - Testnet4
      - Signet
      - Regtest
      - Solana
      - SolanaDevnet
      - Ethereum
      - EthereumSepolia
      - Base
      - BaseSepolia
      - Arbitrum
      - ArbitrumSepolia
      - Polygon
      - PolygonAmoy
      type: string
    ShortfallPolicyDto:
      type: object
      properties:
        absorbUpToPercent:
          type: number
          format: double
        absorbedBy:
          type:
          - string
          - 'null'
      additionalProperties: false
    PaymentMethod:
      enum:
      - MultiOutput
      - Lightning
      type: string
    SekValueInfo:
      type: object
      properties:
        ratePerBtc:
          type: number
          format: double
        rateSource:
          type:
          - string
          - 'null'
        amount:
          type:
          - number
          - 'null'
          format: double
        platformFee:
          type:
          - number
          - 'null'
          format: double
        vatRatePercent:
          type:
          - number
          - 'null'
          format: double
        platformFeeVat:
          type:
          - number
          - 'null'
          format: double
      additionalProperties: false
    DraftStatus:
      enum:
      - AwaitingPayment
      - Seen
      - Confirmed
      - Expired
      - Cancelled
      type: string
    SettleAccruedFeesRequest:
      type: object
      properties:
        currency:
          $ref: '#/components/schemas/PaymentCurrency'
        network:
          $ref: '#/components/schemas/PaymentNetwork'
      additionalProperties: false
    FeeScheduleResponse:
      type: object
      properties:
        tiers:
          type:
          - array
          - 'null'
          items:
            $ref: '#/components/schemas/FeeTierDto'
        minFeeUsd:
          type: number
          format: double
        maxFeeUsd:
          type: number
          format: double
        dustLimitSats:
          type: integer
          format: int64
        pricedIn:
          type:
          - string
          - 'null'
        note:
          type:
          - string
          - 'null'
      additionalProperties: false
    AmountMismatchInfo:
      type: object
      properties:
        txId:
          type:
          - string
          - 'null'
        expectedBaseUnits:
          type: integer
          format: int64
        receivedBaseUnits:
          type: integer
          format: int64
        differenceBaseUnits:
          type: integer
          format: int64
        receivedFormatted:
          type:
          - string
          - 'null'
        differenceFormatted:
          type:
          - string
          - 'null'
        confirmations:
          type: integer
          format: int32
        detectedAt:
          type: string
          format: date-time
        acceptedAt:
          type:
          - string
          - 'null'
          format: date-time
        acceptReason:
          type:
          - string
          - 'null'
        acceptedBy:
          type:
          - string
          - 'null'
        reviewState:
          type:
          - string
          - 'null'
        rejectedAt:
          type:
          - string
          - 'null'
          format: date-time
        rejectReason:
          type:
          - string
          - 'null'
        rejectedBy:
          type:
          - string
          - 'null'
        reviewReason:
          type:
          - string
          - 'null'
      additionalProperties: false
    PlatformFeeInfo:
      type: object
      properties:
        percent:
          type:
          - number
          - 'null'
          format: double
        usd:
          type:
          - number
          - 'null'
          format: double
        sats:
          type: integer
          format: int64
        waived:
          type: boolean
        usdPerBtc:
          type:
          - number
          - 'null'
          format: double
        rateSource:
          type:
          - string
          - 'null'
      additionalProperties: false
    DraftResponse:
      type: object
      properties:
        id:
          type: string
          format: uuid
        receiverAddress:
          type:
          - string
          - 'null'
        senderAddress:
          type:
          - string
          - 'null'
        network:
          $ref: '#/components/schemas/PaymentNetwork'
        amountSats:
          type: integer
          format: int64
        amountBtc:
          type:
          - string
          - 'null'
        fiatCurrency:
          type:
          - string
          - 'null'
        fiatAmount:
          type:
          - number
          - 'null'
          format: double
        quote:
          $ref: '#/components/schemas/QuoteInfo'
        platformFeeSats:
          type: integer
          format: int64
        platformFeeAddress:
          type:
          - string
          - 'null'
        platformFee:
          $ref: '#/components/schemas/PlatformFeeInfo'
        paymentMethod:
          $ref: '#/components/schemas/PaymentMethod'
        bolt11:
          type:
          - string
          - 'null'
        memo:
          type:
          - string
          - 'null'
        status:
          $ref: '#/components/schemas/DraftStatus'
        paidTxId:
          type:
          - string
          - 'null'
        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
          - 'null'
          items:
            $ref: '#/components/schemas/FeeOutputInfo'
        currency:
          $ref: '#/components/schemas/PaymentCurrency'
        tokenAddress:
          type:
          - string
          - 'null'
        feeAccrued:
          type: boolean
        isFeeSettlement:
          type: boolean
        paymentUri:
          type:
          - string
          - 'null'
        amountMismatch:
          $ref: '#/components/schemas/AmountMismatchInfo'
        lightningAddress:
          type:
          - string
          - 'null'
        lightningConfirmable:
          type: boolean
        paymentRequestId:
          type:
          - string
          - 'null'
          format: uuid
        amountBaseUnits:
          type: integer
          format: int64
        core:
          type:
          - object
          - 'null'
          additionalProperties: {}
        coreSha256:
          type:
          - string
          - 'null'
        changeSignals:
          type:
          - array
          - 'null'
          items:
            type: string
        changeNotes:
          type:
          - array
          - 'null'
          items:
            type: string
        shortfallPolicy:
          $ref: '#/components/schemas/ShortfallPolicyDto'
        confirmedAt:
          type:
          - string
          - 'null'
          format: date-time
      additionalProperties: false
    FeeTierDto:
      type: object
      properties:
        upToUsd:
          type:
          - number
          - 'null'
          format: double
        percent:
          type: number
          format: double
      additionalProperties: false
    PaymentCurrency:
      enum:
      - Btc
      - Usdc
      - Usdt
      - Eurc
      - Sol
      - Eth
      type: string
    AccruedFeesResponse:
      type: object
      properties:
        outstandingUsd:
          type: number
          format: double
        draftCount:
          type: integer
          format: int32
        oldestAccruedAt:
          type:
          - string
          - 'null'
          format: date-time
        maxOutstandingUsd:
          type: number
          format: double
        maxAgeDays:
          type: integer
          format: int32
        blocked:
          type: boolean
        activeSettlementDraftId:
          type:
          - string
          - 'null'
          format: uuid
      additionalProperties: false
    FeeOutputInfo:
      type: object
      properties:
        recipient:
          type:
          - string
          - 'null'
        address:
          type:
          - string
          - 'null'
        sats:
          type: integer
          format: int64
        sharePercent:
          type: number
          format: double
      additionalProperties: false
  securitySchemes:
    ApiKey:
      type: http
      description: 'AI-agent API key (Authorization: Bearer s21_...). Humans use passkey session cookies instead.'
      scheme: bearer
      bearerFormat: s21_...
x-refined-from:
- send21-io-openapi.json
- swagger.json