SendPulse

SendPulse Balance API

Endpoints related to Balance.

GitHub OpenAPI

Operations 3

Each operation below carries the questions people ask an LLM about it and the instructions they give an agent to run it. Generated by API Evangelist overlay

GET /balance Get the overall account balance · Get balance #
Ask an LLM
“How much money is left in my SendPulse account?”
“What is my current account balance?”
Tell an agent
Show my account balance.
Check how much credit I have.
GET /balance/{currency} Get the account balance in a currency · Get balance by currency #
Ask an LLM
“What is my balance expressed in a specific currency?”
“Can I see my balance in euros or dollars?”
Tell an agent
Show my balance in {currency}.
Get my account balance converted to {currency}.
GET /user/balance/detail Get detailed balance, tariffs and limits · Get detailed balance #
Ask an LLM
“Which tariff plans and limits apply to each service on my account?”
“Can I see a detailed breakdown of my balance across services?”
Tell an agent
Show my detailed balance with tariffs and limits.
Break down my balance and plan limits per service.

Documentation

📖
Documentation
https://sendpulse.com/integrations/api/bulk-email
📖
APIReference
https://sendpulse.com/integrations/api
📖
Documentation
https://sendpulse.com/integrations/api/smtp
📖
Documentation
https://sendpulse.com/integrations/api/bulk-sms
📖
Documentation
https://sendpulse.com/integrations/api
📖
Documentation
https://sendpulse.com/integrations/api/chatbot
📖
Documentation
https://sendpulse.com/integrations/api/web-push

Specifications

⚙
OpenAPI
https://raw.githubusercontent.com/api-evangelist/sendpulse/refs/heads/main/openapi/sendpulse-balance-api-openapi.yml

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/sendpulse:sendpulse-balance-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.

GitHub Google LinkedIn

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

OpenAPI Specification

sendpulse-balance-api-openapi.yml Raw ↑ 
openapi: 3.2.0
info:
  title: SendPulse Bulk Email Balance API
  version: 1.0.0
  description: API for managing mailing lists, email campaigns, templates, and senders.
  x-ai-description: 'The Bulk Email API is the core engine for marketing automation at SendPulse.  It enables programmatic control over the entire email lifecycle.

    '
  license:
    name: Apache 2.0
    identifier: Apache-2.0
servers:
- url: https://api.sendpulse.com
  description: Production server
security:
- apiKey: []
- oauth2: []
tags:
- name: Balance
  description: Endpoints related to Balance.
paths:
  /balance:
    get:
      tags:
      - Balance
      summary: Get balance
      operationId: getBalance
      description: Get overall account balance information.
      x-ai-role: billing_specialist
      x-ai-description: Check your current funds and currency settings.
      x-ai-reasoning-instructions:
      - Use this to monitor account credits before launching campaigns.
      - Check if the balance is sufficient for the planned activity.
      x-ai-responding-instructions:
      - Report the current balance and its currency.
      x-ai-suggestions:
      - Get detailed balance information.
      x-ai-capabilities:
        security_info:
          data_handling:
          - InformationRetrieval
      responses:
        '200':
          description: Balance info
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/BalanceResponse'
        '401':
          description: Unauthorized
        '403':
          description: Forbidden
  /balance/{currency}:
    get:
      tags:
      - Balance
      summary: Get balance by currency
      operationId: getBalanceByCurrency
      description: Get account balance for a specific currency.
      x-ai-role: billing_specialist
      x-ai-description: Check balance in a specific currency (e.g., USD, EUR).
      x-ai-reasoning-instructions:
      - Specify the 3-letter currency code in the URL.
      - Ensure the requested currency is supported by your account.
      x-ai-responding-instructions:
      - Provide the balance amount in the requested currency.
      x-ai-suggestions:
      - /balance/USD
      x-ai-capabilities:
        security_info:
          data_handling:
          - InformationRetrieval
      parameters:
      - name: currency
        in: path
        required: true
        schema:
          type: string
      responses:
        '200':
          description: Balance info
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/BalanceResponse'
        '401':
          description: Unauthorized
        '403':
          description: Forbidden
  /user/balance/detail:
    get:
      tags:
      - Balance
      summary: Get detailed balance
      operationId: getDetailedBalance
      description: Get deep dive into balance, tariffs, and limits across all services.
      x-ai-role: billing_specialist
      x-ai-description: Comprehensive financial and usage status report.
      x-ai-reasoning-instructions:
      - Review limits for Email, SMTP, and Push services.
      - Check tariff expiration dates and bonus balances.
      x-ai-responding-instructions:
      - Break down the balance by service (Email, SMTP, Push).
      - Highlight when tariffs are expiring or subscribers limits are reached.
      x-ai-suggestions:
      - Renew your email tariff.
      x-ai-capabilities:
        security_info:
          data_handling:
          - InformationRetrieval
      responses:
        '200':
          description: Detailed balance
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/DetailedBalanceResponse'
        '401':
          description: Unauthorized
        '403':
          description: Forbidden
components:
  schemas:
    DetailedBalanceResponse:
      type: object
      x-ai-description: Detailed account balance and limits.
      properties:
        balance:
          type: object
          properties:
            main:
              type: string
              example: '9.36'
            bonus:
              type: string
              example: '5.00'
            currency:
              type: string
              example: USD
        email:
          type: object
          properties:
            tariff_name:
              type: string
              example: Pay as you go 10 000
            finished_time:
              type: string
              example: '2019-04-25 08:03:02'
            emails_left:
              type: integer
              example: 9914
            maximum_subscribers:
              type: integer
              example: 10000
            current_subscribers:
              type: integer
              example: 0
        smtp:
          type: object
          properties:
            tariff_name:
              type: string
              example: SMTP Free
            end_date:
              type: string
              example: '2018-11-21 15:05:39'
            auto_renew:
              type: integer
              example: 1
        push:
          type: object
          properties:
            tariff_name:
              type: string
              example: White Label
            end_date:
              type: string
              example: '2018-11-30'
            auto_renew:
              type: integer
              example: 1
    BalanceResponse:
      type: object
      x-ai-description: Account balance info.
      properties:
        currency:
          type: string
          example: USD
        balance_currency:
          type: number
          example: 0.02
  securitySchemes:
    apiKey:
      type: http
      scheme: bearer
      bearerFormat: API Key
      description: 'Static API Key authentication.  A long-lived token generated manually in the SendPulse account settings.

        '
      x-ai-description: 'Permanent authentication token. Ideal for simple integrations without token refresh logic.

        '
    oauth2:
      type: oauth2
      description: OAuth 2.0 Client Credentials flow for temporary access tokens.
      flows:
        clientCredentials:
          tokenUrl: https://api.sendpulse.com/oauth/access_token
          scopes: {}
      x-ai-description: 'Standard OAuth 2.0 flow using Client ID and Client Secret.  Provides temporary tokens (valid for 1 hour) for enhanced security.

        '