What Fields Are Available for API Submissions?

ISPolitical supports submissions of online donations and other data via a rest API using /basic access authentication/.

Submissions will return a success or failure and a unique ID per account.

For example:

 

{ "id":20, "success":true}

This is a list of possible types of fields to include in an API submission:

Entity

  • EntityType (Individual, Company, Political Committee, Labor Union, or Organization)
  • FullName (FullName can be used instead of the name fields below if your form doesn’t support, or have, pre-parsed names. All organization types should use FullName)
  • NamePrefix
  • FirstName
  • MiddleName
  • LastName
  • NameSuffix
  • Nickname
  • Occupation
  • Employer
  • AddressType
  • Company
  • Line1
  • Line2
  • City
  • State
  • ZipCode
  • Notes
  • Source (a page descriptor)

Source is included in the email that is sent and is logged for ISP developer review as needed. It has no impact on the client’s data.

 

Transaction

  • TransactionType
  • Amount
  • FinancialAccount
  • TransactionMethod
  • BudgetCategory
  • NoteForCompliance
  • NoteForInternal
  • RecurringFrequency — example monthly or one-time
  • RecurringLength
  • NameOnCard
  • PartialCardNumber
  • Company — second address for billing purposes (optional)
  • Line1
  • Line2
  • City
  • State
  • ReportingCode — Expenses only

The ISP API supports the following transaction types:

  • Monetary Contribution
  • Expense
  • Refunded Contribution
  • Inkind Contribution
  • Deposits (See our help file on deposits and the API.)

If not provided, transactions will be assumed to be Monetary Contributions.

Amounts should generally be sent via API as a positive number, including for expenses. If sent as a negative number, it will be interpreted as a reversal, such as a void or bounce.

Emails (optional/repeatable)

  • EmailAddress
  • OptIn (boolean)

ISP will automatically filter out known common fake email addresses during the import process. For example: noreply@noreply.com and test@test.com.

Phones (optional/repeatable)

  • PhoneNumber
  • Extension
  • PhoneType

Addresses (optional/repeatable)

  • AddressType
  • Company
  • Line1
  • Line2
  • City
  • State
  • ZipCode

Flags (optional/repeatable)

  • FlagName

Flags must be added into your ISP account before trying to submit them via our API.

Sources (optional/repeatable)

  • Name
  • Value

Sources do not get imported into entity records but can be used for marketing analytics through the API details report. Sources are completely ad-hoc and any values can be sent through. They are typically used for UTM parameters and similar needs.

PoliticalCommittee (optional)

This should only be used with Entity Type Political Committee

  • CommitteeType (eg: Candidate Committee)
  • IdNumber
  • Jurisdiction (Federal, State, or Local)
  • DateQualified
  • EIN
  • JurisdictionDescription (eg: Los Angeles)
  • Party
  • Controlled (true/false)
  • Sponsored (true/false)

Related Information