Bloomerang Constituents API
Individuals, households, and organizations tracked as donors and contacts.
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.
Call it yourself
curl for this page
This API
curl "https://apis.io/api/v1/apis/bloomerang-constituents-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
openapi: 3.2.0
info:
title: Bloomerang REST API v2 Constituents API
description: The Bloomerang REST API v2 is a private-key, server-to-server API for reading and writing data in a Bloomerang donor management CRM account - constituents, transactions (donations, pledges, recurring donations), interactions, notes, relationships, and webhook subscriptions.
version: '2.0'
contact:
name: Bloomerang
url: https://bloomerang.com/api/rest-api
servers:
- url: https://api.bloomerang.co/v2
description: Bloomerang REST API v2 (production - no sandbox is offered)
security:
- apiKeyAuth: []
- oauth2Bearer: []
tags:
- name: Constituents
description: Individuals, households, and organizations tracked as donors and contacts.
paths:
/constituents:
get:
operationId: listConstituents
tags:
- Constituents
summary: List constituents
description: Lists constituents, paginated with skip/take parameters.
parameters:
- $ref: '#/components/parameters/Skip'
- $ref: '#/components/parameters/Take'
responses:
'200':
description: A page of constituents.
content:
application/json:
schema:
type: object
properties:
Results:
type: array
items:
$ref: '#/components/schemas/Constituent'
Total:
type: integer
'401':
$ref: '#/components/responses/Unauthorized'
post:
operationId: createConstituent
tags:
- Constituents
summary: Create a constituent
description: Creates a new constituent record.
requestBody:
required: true
content:
application/json:
schema:
$ref: '#/components/schemas/ConstituentInput'
responses:
'200':
description: The created constituent.
content:
application/json:
schema:
$ref: '#/components/schemas/Constituent'
'401':
$ref: '#/components/responses/Unauthorized'
'422':
$ref: '#/components/responses/ValidationError'
/constituents/search:
get:
operationId: searchConstituents
tags:
- Constituents
summary: Search constituents
description: Full-text search across constituent names and identifying fields.
parameters:
- name: search
in: query
required: true
description: Search term, e.g. a constituent's name.
schema:
type: string
- $ref: '#/components/parameters/Skip'
- $ref: '#/components/parameters/Take'
responses:
'200':
description: Matching constituents.
content:
application/json:
schema:
type: object
properties:
Results:
type: array
items:
$ref: '#/components/schemas/Constituent'
'401':
$ref: '#/components/responses/Unauthorized'
/constituents/{id}:
parameters:
- $ref: '#/components/parameters/ConstituentId'
get:
operationId: getConstituent
tags:
- Constituents
summary: Retrieve a constituent
description: Retrieves a constituent by ID.
responses:
'200':
description: The requested constituent.
content:
application/json:
schema:
$ref: '#/components/schemas/Constituent'
'401':
$ref: '#/components/responses/Unauthorized'
'404':
$ref: '#/components/responses/NotFound'
patch:
operationId: updateConstituent
tags:
- Constituents
summary: Update a constituent
description: Updates fields on an existing constituent.
requestBody:
required: true
content:
application/json:
schema:
$ref: '#/components/schemas/ConstituentInput'
responses:
'200':
description: The updated constituent.
content:
application/json:
schema:
$ref: '#/components/schemas/Constituent'
'401':
$ref: '#/components/responses/Unauthorized'
'404':
$ref: '#/components/responses/NotFound'
'422':
$ref: '#/components/responses/ValidationError'
/constituents/{id}/timeline:
parameters:
- $ref: '#/components/parameters/ConstituentId'
get:
operationId: getConstituentTimeline
tags:
- Constituents
summary: Get a constituent's timeline
description: Retrieves the combined engagement timeline for a constituent - notes, interactions, donations, recurring donations, recurring donation payments, pledges, pledge payments, and tasks.
responses:
'200':
description: The constituent timeline.
content:
application/json:
schema:
$ref: '#/components/schemas/ConstituentTimeline'
'401':
$ref: '#/components/responses/Unauthorized'
'404':
$ref: '#/components/responses/NotFound'
components:
schemas:
ConstituentInput:
type: object
properties:
Type:
type: string
enum:
- Individual
- Organization
- Household
FirstName:
type: string
LastName:
type: string
FullName:
type: string
Status:
type: string
enum:
- Active
- Inactive
- Deceased
EmailAddress:
type: object
properties:
Value:
type: string
format: email
Type:
type: string
PhoneNumber:
type: object
properties:
Number:
type: string
Type:
type: string
Address:
type: object
properties:
Street:
type: string
City:
type: string
State:
type: string
PostalCode:
type: string
Country:
type: string
CustomValues:
type: array
items:
type: object
additionalProperties: true
Transaction:
allOf:
- $ref: '#/components/schemas/TransactionInput'
- type: object
properties:
Id:
type: integer
CreatedDate:
type: string
format: date-time
InteractionInput:
type: object
required:
- AccountId
- Date
- Channel
properties:
AccountId:
type: integer
Date:
type: string
format: date
Channel:
type: string
enum:
- Call
- Email
- InPerson
- Letter
- Other
Purpose:
type: string
Note:
type: string
UserId:
type: integer
Error:
type: object
properties:
Message:
type: string
Errors:
type: array
items:
type: string
ConstituentTimeline:
type: object
properties:
Id:
type: integer
Notes:
type: array
items:
$ref: '#/components/schemas/Note'
Interactions:
type: array
items:
$ref: '#/components/schemas/Interaction'
Donations:
type: array
items:
$ref: '#/components/schemas/Transaction'
RecurringDonations:
type: array
items:
type: object
additionalProperties: true
RecurringDonationPayments:
type: array
items:
type: object
additionalProperties: true
Pledges:
type: array
items:
type: object
additionalProperties: true
PledgePayments:
type: array
items:
type: object
additionalProperties: true
Tasks:
type: array
items:
type: object
additionalProperties: true
Note:
allOf:
- $ref: '#/components/schemas/NoteInput'
- type: object
properties:
Id:
type: integer
Interaction:
allOf:
- $ref: '#/components/schemas/InteractionInput'
- type: object
properties:
Id:
type: integer
NoteInput:
type: object
required:
- AccountId
- Note
properties:
AccountId:
type: integer
Note:
type: string
Date:
type: string
format: date
AttachmentIds:
type: array
items:
type: integer
Constituent:
allOf:
- $ref: '#/components/schemas/ConstituentInput'
- type: object
properties:
Id:
type: integer
AccountNumber:
type: string
CreatedDate:
type: string
format: date-time
LastModifiedDate:
type: string
format: date-time
TransactionInput:
type: object
required:
- AccountId
- Date
- Designations
properties:
AccountId:
type: integer
description: The constituent ID this transaction is attributed to.
Date:
type: string
format: date
Method:
type: string
enum:
- Cash
- Check
- CreditCard
- AchDebit
- Other
Designations:
type: array
items:
type: object
properties:
Type:
type: string
enum:
- Donation
- Pledge
- PledgePayment
- RecurringDonation
- RecurringDonationPayment
FundId:
type: integer
CampaignId:
type: integer
AppealId:
type: integer
Amount:
type: number
format: double
parameters:
ConstituentId:
name: id
in: path
required: true
description: The ID of the constituent.
schema:
type: integer
Take:
name: take
in: query
required: false
description: Number of records to return, for pagination.
schema:
type: integer
default: 50
Skip:
name: skip
in: query
required: false
description: Number of records to skip, for pagination.
schema:
type: integer
default: 0
responses:
NotFound:
description: The requested resource was not found.
content:
application/json:
schema:
$ref: '#/components/schemas/Error'
Unauthorized:
description: Missing or invalid API key / access token.
content:
application/json:
schema:
$ref: '#/components/schemas/Error'
ValidationError:
description: The request payload failed validation.
content:
application/json:
schema:
$ref: '#/components/schemas/Error'
securitySchemes:
apiKeyAuth:
type: apiKey
in: header
name: X-Api-Key
description: Private API key generated by an Administrator user in Bloomerang under User Settings > Edit My User. Grants full read/write access - keep it secret.
oauth2Bearer:
type: oauth2
description: 'OAuth 2.0 access token for third-party applications, presented as `Authorization: Bearer {access_token}`.'
flows:
authorizationCode:
authorizationUrl: https://crm.bloomerang.co/oauth/authorize
tokenUrl: https://api.bloomerang.co/v2/oauth/token
scopes:
api: Full read/write access to account data.