Bloomerang Refunds API

The Refunds API from Bloomerang — 3 operation(s) for refunds.

Operations 5

GET /refunds Gets a list of refunds #
POST /refund Creates a refund #
GET /refund/{id} Gets a refund by ID #
PUT /refund/{id} Updates a refund #
DELETE /refund/{id} Deletes a refund #

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/bloomerang:bloomerang-refunds-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

bloomerang-refunds-api-openapi.yml Raw ↑
openapi: 3.2.0
info:
  title: Bloomerang Refunds API
  description: Private-key API for Bloomerang CRM
  version: 2.0.0
  contact:
    name: Bloomerang
    url: https://www.bloomerang.com/
    email: support@bloomerang.com
servers:
- url: https://api.bloomerang.co/v2
security:
- ApiKeyAuth: []
- OAuth2: []
tags:
- name: Refunds
paths:
  /refunds:
    get:
      tags:
      - Refunds
      summary: Gets a list of refunds
      parameters:
      - in: query
        name: skip
        schema:
          type: integer
          minimum: 0
          default: 0
        description: The number of items to skip before starting to collect the result set.
      - in: query
        name: take
        schema:
          type: integer
          minimum: 1
          maximum: 50
          default: 50
        description: The number of items to include in the result set.
      - in: query
        name: lastModified
        schema:
          type: string
          format: date-time
        description: Filters to refunds last modified after the specified date
      - in: query
        name: transactionId
        style: pipeDelimited
        explode: false
        schema:
          type: array
          items:
            type: integer
            format: int64
        description: Filters results based on the transaction ID for the refund.
      - in: query
        name: id
        style: pipeDelimited
        explode: false
        schema:
          type: array
          items:
            type: integer
            format: int64
        description: Filters results based on the ID for the refund.
      - in: query
        name: orderBy
        schema:
          type: string
          enum:
          - CreatedDate
          - Date
          - LastModifiedDate
        description: Sorts by Date, CreatedDate, or LastModifiedDate (default Date).
      - in: query
        name: orderDirection
        schema:
          type: string
          enum:
          - Asc
          - Desc
        description: Sorts the orderBy in ascending or descending order.
      responses:
        '200':
          description: The list of refunds that met the specified filters.
          content:
            application/json:
              schema:
                allOf:
                - properties:
                    Total:
                      type: integer
                      description: The total number of records in Bloomerang.
                    TotalFiltered:
                      type: integer
                      description: The total number of records that match the filters.
                    Start:
                      type: integer
                      description: The 0-based index of the first record.
                    ResultCount:
                      type: integer
                      description: The number of records included in the result set.
                - type: object
                  properties:
                    Results:
                      type: array
                      items:
                        allOf:
                        - type: object
                          properties:
                            Id:
                              type: integer
                              format: int64
                              description: The ID of the refund
                        - properties:
                            TransactionId:
                              type: integer
                              format: int64
                              description: The ID of the transaction used in the API (not to be confused with transactionNumber)
                            Note:
                              type: string
                              description: The reason for making this refund
                        - type: object
                          properties:
                            Date:
                              type: string
                              format: date
                            Amount:
                              type: number
                              format: currency
                            AuditTrail:
                              properties:
                                CreatedDate:
                                  type: string
                                  format: date-time
                                CreatedName:
                                  type: string
                                LastModifiedDate:
                                  type: string
                                  format: date-time
                                LastModifiedName:
                                  type: string
      operationId: getRefunds
      x-operation-id-source: derived
  /refund:
    post:
      tags:
      - Refunds
      summary: Creates a refund
      security:
      - OAuth2:
        - StandardEditFinancialData
      requestBody:
        required: true
        content:
          application/json:
            schema:
              allOf:
              - properties:
                  TransactionId:
                    type: integer
                    format: int64
                    description: The ID of the transaction used in the API (not to be confused with transactionNumber)
                  Note:
                    type: string
                    description: The reason for making this refund
              - type: object
                properties:
                  RunProcessorRefund:
                    type: boolean
                    description: If true, the processor will be asked to refund the transaction as well as in the CRM.  If false, only the CRM will be updated. If omitted this field will default to true.
                required:
                - TransactionId
                - Date
      responses:
        '200':
          description: The refund was created successfully.
          content:
            application/json:
              schema:
                allOf:
                - type: object
                  properties:
                    Id:
                      type: integer
                      format: int64
                      description: The ID of the refund
                - properties:
                    TransactionId:
                      type: integer
                      format: int64
                      description: The ID of the transaction used in the API (not to be confused with transactionNumber)
                    Note:
                      type: string
                      description: The reason for making this refund
                - type: object
                  properties:
                    Date:
                      type: string
                      format: date
                    Amount:
                      type: number
                      format: currency
                    AuditTrail:
                      properties:
                        CreatedDate:
                          type: string
                          format: date-time
                        CreatedName:
                          type: string
                        LastModifiedDate:
                          type: string
                          format: date-time
                        LastModifiedName:
                          type: string
      operationId: postRefund
      x-operation-id-source: derived
  /refund/{id}:
    parameters:
    - in: path
      name: id
      required: true
      schema:
        type: integer
        format: int64
      description: The ID of the refund to return.
    get:
      tags:
      - Refunds
      summary: Gets a refund by ID
      responses:
        '200':
          description: The refund with the given ID.
          content:
            application/json:
              schema:
                allOf:
                - type: object
                  properties:
                    Id:
                      type: integer
                      format: int64
                      description: The ID of the refund
                - properties:
                    TransactionId:
                      type: integer
                      format: int64
                      description: The ID of the transaction used in the API (not to be confused with transactionNumber)
                    Note:
                      type: string
                      description: The reason for making this refund
                - type: object
                  properties:
                    Date:
                      type: string
                      format: date
                    Amount:
                      type: number
                      format: currency
                    AuditTrail:
                      properties:
                        CreatedDate:
                          type: string
                          format: date-time
                        CreatedName:
                          type: string
                        LastModifiedDate:
                          type: string
                          format: date-time
                        LastModifiedName:
                          type: string
      operationId: getRefundById
      x-operation-id-source: derived
    put:
      tags:
      - Refunds
      summary: Updates a refund
      security:
      - OAuth2:
        - StandardEditFinancialData
      requestBody:
        required: true
        content:
          application/json:
            schema:
              allOf:
              - type: object
                properties:
                  Id:
                    type: integer
                    format: int64
                    description: The ID of the refund
                  Date:
                    type: string
                    format: date
                required:
                - Id
              - properties:
                  TransactionId:
                    type: integer
                    format: int64
                    description: The ID of the transaction used in the API (not to be confused with transactionNumber)
                  Note:
                    type: string
                    description: The reason for making this refund
      responses:
        '200':
          description: The refund was updated successfully.
          content:
            application/json:
              schema:
                allOf:
                - type: object
                  properties:
                    Id:
                      type: integer
                      format: int64
                      description: The ID of the refund
                - properties:
                    TransactionId:
                      type: integer
                      format: int64
                      description: The ID of the transaction used in the API (not to be confused with transactionNumber)
                    Note:
                      type: string
                      description: The reason for making this refund
                - type: object
                  properties:
                    Date:
                      type: string
                      format: date
                    Amount:
                      type: number
                      format: currency
                    AuditTrail:
                      properties:
                        CreatedDate:
                          type: string
                          format: date-time
                        CreatedName:
                          type: string
                        LastModifiedDate:
                          type: string
                          format: date-time
                        LastModifiedName:
                          type: string
      operationId: putRefundById
      x-operation-id-source: derived
    delete:
      tags:
      - Refunds
      summary: Deletes a refund
      security:
      - OAuth2:
        - StandardEditFinancialData
      responses:
        '200':
          description: The refund was deleted successfully.
          content:
            application/json:
              schema:
                properties:
                  Id:
                    type: integer
                    description: The ID of the object that was deleted
                    format: int64
                  Type:
                    type: string
                    description: The type of object that was deleted
                  Deleted:
                    type: boolean
                    description: True if the object was deleted
      operationId: deleteRefundById
      x-operation-id-source: derived
components:
  securitySchemes:
    ApiKeyAuth:
      type: apiKey
      in: header
      name: X-API-KEY
    OAuth2:
      type: oauth2
      description: OAuth 2 with the authorization code flow.
      flows:
        authorizationCode:
          authorizationUrl: https://crm.bloomerang.com/authorize/
          tokenUrl: https://api.bloomerang.co/v2/oauth/token
          refreshUrl: https://api.bloomerang.co/v2/oauth/token
          scopes:
            ViewOnly: Base level view-only privileges
            StandardEditFinancialData: Base level privileges and ability to edit financial data
            Standard: Same privileges as a standard user (includes transaction edit)
            OrgAdmin: Privileges of an Organization Administrator
externalDocs:
  url: https://www.bloomerang.com/openapi_errorcodes.html
  description: Error Codes
x-provenance:
  method: harvested
  publisher: Bloomerang
  source: https://bloomerang-api-documentation.s3.us-west-2.amazonaws.com/public_crm_generated.json
  note: split by refine-openapis from the provider's own published document, verified by fetch (openapi/_original/*.fetch.json);
    stamped by stamp-openapi-provenance.py (roadmap#793)