API Reference
Supported Operations
The two root types of a GraphQL schema are the Query type and the Mutation type. These types define the entry points for retrieving and modifying data, respectively. The fields under these types define the capabilities of our GraphQL API.
Queries
Data you can retrieve from our API
8 Queries
Mutations
Actions you can perform to modify data in our API
11 Mutations
Schema-Defined Types
All types in our GraphQL schema fall into one of the following categories:
Objects
The entities in our GraphQL schema
36 Objects
Interfaces
Abstract types that other types inherit from
1 Interfaces
Enums
The enumeration types
2 Enums
Unions
The unions in our GraphQL schema
19 Unions
Inputs
Used to provide data to an operation
24 Inputs
Scalars
The primitives in our GraphQL schema
30 Scalars
Directives
Directives are used to modify the behavior of the GraphQL schema. They are used to annotate fields, fragments, and operations.
deprecated
Marks an element of a GraphQL schema as no longer supported.
idempotent
Marks a mutation as idempotent
include
Directs the executor to include this field or fragment only when the if argument is true.
rateLimit
Controls the rate of traffic.
skip
Directs the executor to skip this field or fragment when the if argument is true.
specifiedBy
Exposes a URL that specifies the behavior of this scalar.
GraphQL Schema SDL
Download the schema at https://developer.firstdollar.com/schema.graphqlschema.graphql
"""Marks a mutation as idempotent"""
directive @idempotent(key: String = "input.idempotencyKey") on FIELD_DEFINITION
"""Controls the rate of traffic."""
directive @rateLimit(
"""Number of seconds before limit is reset."""
duration: Int! = 60
"""Number of occurrences allowed over duration."""
limit: Int! = 60
) on FIELD_DEFINITION | OBJECT
"""An Account belonging to a Health Wallet."""
type Account {
"""The amount of money that is available to be spent for this account"""
availableBalance: Money!
"""The Benefit this account belongs to."""
benefit: Benefit
"""When the Account was created"""
createdAt: DateTime!
"""
The total amount of money in this account.
Note that `currentBalance` and `availableBalance` may differ when there
are ongoing money movement processes.
"""
currentBalance: Money!
"""
A summary of the funding this account has received. Funding corresponds to deposit transactions
that increase the balance of the account.
"""
fundingSummary: AccountFundingSummary!
"""The ID of the account"""
id: ID!
"""Transactions posted against this Account"""
transactions(
"""Return the Transaction that come after the specified cursor"""
after: String
"""The number of Transactions to retrieve per page"""
first: Int
"""Filter criteria used to match Transactions"""
where: TransactionsFilterInput
): TransactionResults!
}
"""
A summary of the funding an account has received. Funding corresponds only to deposit transactions
that increase the balance of the account.
"""
type AccountFundingSummary {
"""
The total amount of funds this account has received across its lifecycle.
"""
total: Money!
}
"""
Banking account number is a string of 5 to 17 alphanumeric values for representing an generic account number
"""
scalar AccountNumber
"""Returned when there is an error in the request."""
type BadRequestError implements Error {
"""An alphanumeric identifier for this error."""
code: String!
"""A user-facing error message."""
message: String!
"""
Returns true if the client can safely retry the request, false otherwise.
"""
retryable: Boolean!
}
"""A Benefit offered to an individual in a Benefits Program"""
type Benefit {
"""The configuration of the Benefit."""
configuration: BenefitConfiguration!
"""A description of the Benefit"""
description: String!
"""The end date of the Benefit"""
endDate: LocalDate
"""A unique identifier for the Benefit"""
id: ID!
"""A human-readable name for the Benefit"""
name: String!
"""The start date of the Benefit"""
startDate: LocalDate!
"""The type of Benefit"""
type: BenefitType!
}
"""
The Benefit Configuration describes the parameters and controls all aspects of the Benefit.
"""
type BenefitConfiguration {
"""Describes the controls and behaviors around Benefit Funding."""
funding: BenefitFundingConfiguration!
}
"""Filter criteria used when querying for a benefit"""
input BenefitFilterInput {
"""The ID of the benefit"""
id: ID!
}
"""Describes the parameters and behaviors of Funding for the Benefit."""
type BenefitFundingConfiguration {
"""
The Initial Funding for a Benefit defines the initial amount of Funds made available to an Individual.
"""
initialFunding: BenefitInitialFundingConfiguration!
"""
The Funding Limits for a Benefit govern the maximum amount of funds that can be made available
to a given account.
"""
limits: BenefitFundingLimitsConfiguration!
}
"""
The Funding Limits for a Benefit govern the maximum amount of funds that can be made available
to a given account.
"""
type BenefitFundingLimitsConfiguration {
"""
The maximum amount of funding permitted for an account belonging an Individual.
"""
individual: Money!
}
"""
The Initial Funding for a Benefit defines the initial amount of Funds made available to an Individual.
"""
type BenefitInitialFundingConfiguration {
"""
The initial amount of funds made available to an account belonging an Individual. If the value is $0.00, no initial
funding will occur for Individuals enrolled in the Benefit.
"""
individual: Money!
}
"""
A union representing the possible return types when querying for a benefit
"""
union BenefitResponse = BadRequestError | Benefit | InternalServerError
"""Represents a template used when creating a benefit"""
type BenefitTemplate {
"""
If defined, Benefits created from this template inherit (and may override) this configuration.
"""
configuration: BenefitConfiguration
"""A description of the benefit provided by this template"""
description: String!
"""A unique identifier for the benefit template"""
id: ID!
"""
A human-readable name for the benefit template (e.g. 'Health Savings Account')
"""
name: String!
"""The type of benefit the template represents"""
type: BenefitType!
}
"""Filter criteria used when querying for benefit templates"""
input BenefitTemplatesFilterInput {
"""If specified, only returns Benefit Templates matching this ID"""
id: ID
"""If specified, only returns Benefit Templates matching this name"""
name: String
"""If specified, only returns Benefit Templates matching this type"""
type: BenefitType
}
"""
A union representing the possible return types when querying for benefit templates
"""
union BenefitTemplatesResponse = BadRequestError | BenefitTemplatesResults | InternalServerError
"""Represents a page of benefit templates"""
type BenefitTemplatesResults {
nodes: [BenefitTemplate!]!
pageInfo: PageInfo!
}
"""Enumerates the possible types of benefits"""
enum BenefitType {
"""Health Savings Account"""
HSA
"""Lifestyle Spending Account (LSA)"""
LSA
"""Remote Work Account"""
REMOTE_WORK
"""Rewards Account"""
REWARDS
}
"""A program containing benefits offered to individuals"""
type BenefitsProgram {
"""Benefits offered by this program"""
benefits: [Benefit!]!
"""A unique identifier for the program"""
id: ID!
"""The name of the program"""
name: String!
"""The ID for the organization to which this program belongs"""
organizationId: ID!
}
"""Filter criteria used when querying for a benefits program"""
input BenefitsProgramFilterInput {
"""ID of the program"""
id: ID!
}
"""
A union representing the possible return types when querying for a benefits program
"""
union BenefitsProgramResponse = BadRequestError | BenefitsProgram | InternalServerError
"""Filter criteria used when querying for benefits programs"""
input BenefitsProgramsFilterInput {
"""
If specified, only returns Benefits Programs associated with these Organization IDs
"""
organizationIds: [ID!]
}
"""
A union representing the possible return types when querying for benefits programs
"""
union BenefitsProgramsResponse = BadRequestError | BenefitsProgramsResults | InternalServerError
"""Represents a page of benefits programs"""
type BenefitsProgramsResults {
nodes: [BenefitsProgram!]!
pageInfo: PageInfo!
}
"""
The `BigInt` scalar type represents non-fractional signed whole numeric values.
"""
scalar BigInt
"""A country code as defined by ISO 3166-1 alpha-2"""
scalar CountryCode
"""An input type used when creating a benefit"""
input CreateBenefitInput {
"""The ID of the benefits program to which the benefit belongs"""
benefitsProgramId: ID!
"""
The description of the benefit. If unspecified, defaults to the description from the template.
"""
description: String
"""The end date of the Benefit."""
endDate: LocalDate!
"""
The name of the benefit. If unspecified, defaults to the name from the template.
"""
name: String
"""The start date of the Benefit."""
startDate: LocalDate!
"""The ID of the template to use when creating the benefit"""
templateId: ID!
}
"""A union representing the possible return types when creating a benefit"""
union CreateBenefitResponse = BadRequestError | CreateBenefitResult | InternalServerError
"""The successful result of creating a benefit"""
type CreateBenefitResult {
"""The benefit that was created"""
benefit: Benefit!
}
"""An input type used when creating a benefits program"""
input CreateBenefitsProgramInput {
"""The name of the program"""
name: String!
"""The ID for the organization to which this program belongs"""
organizationId: ID!
}
"""
A union representing the possible return types when creating a benefits program
"""
union CreateBenefitsProgramResponse = BadRequestError | CreateBenefitsProgramResult | InternalServerError
"""The successful result of creating a benefits program"""
type CreateBenefitsProgramResult {
"""The program that was created"""
benefitsProgram: BenefitsProgram!
}
"""An input type used for creating an Individual"""
input CreateIndividualInput {
"""The Individual to create"""
individual: IndividualInput!
}
"""
A union representing the possible return types when creating an Individual
"""
union CreateIndividualResponse = BadRequestError | CreateIndividualResult | InternalServerError
"""The successful result of creating an Individual"""
type CreateIndividualResult {
"""The Individual that was created"""
individual: Individual!
}
"""An input type used when creating an Organization"""
input CreateOrganizationInput {
"""The user-displayable name of the Organization"""
name: String!
}
"""
A union representing the possible return types when creating an Organization
"""
union CreateOrganizationResponse = BadRequestError | CreateOrganizationResult | InternalServerError
"""The successful result of creating an Organization"""
type CreateOrganizationResult {
"""The Organization that was created"""
organization: Organization!
}
"""
A field whose value is a Currency: https://en.wikipedia.org/wiki/ISO_4217.
"""
scalar Currency
"""
A date-time string at UTC, such as 2007-12-03T10:15:30Z, compliant with the `date-time` format outlined in section 5.6 of the RFC 3339 profile of the ISO 8601 standard for representation of dates and times using the Gregorian calendar.
"""
scalar DateTime
"\n A string representing a duration conforming to the ISO8601 standard,\n such as: P1W1DT13H23M34S\n P is the duration designator (for period) placed at the start of the duration representation.\n Y is the year designator that follows the value for the number of years.\n M is the month designator that follows the value for the number of months.\n W is the week designator that follows the value for the number of weeks.\n D is the day designator that follows the value for the number of days.\n T is the time designator that precedes the time components of the representation.\n H is the hour designator that follows the value for the number of hours.\n M is the minute designator that follows the value for the number of minutes.\n S is the second designator that follows the value for the number of seconds.\n\n Note the time designator, T, that precedes the time value.\n\n Matches moment.js, Luxon and DateFns implementations\n ,/. is valid for decimal places and +/- is a valid prefix\n "
scalar Duration
"""
A field whose value conforms to the standard internet email address format as specified in RFC822: https://www.w3.org/Protocols/rfc822/.
"""
scalar EmailAddress
"""An input type used when enrolling an individual in a benefit"""
input EnrollIndividualInBenefitInput {
"""The ID of the benefit to enroll the individual in"""
benefitId: ID!
"""The ID of the individual to enroll in the program"""
individualId: ID!
}
"""
A union representing the possible return types when enrolling an individual in a benefit
"""
union EnrollIndividualInBenefitResponse = BadRequestError | EnrollIndividualInBenefitResult | InternalServerError
"""The successful result of enrolling an individual in a benefit"""
type EnrollIndividualInBenefitResult {
"""The benefit"""
benefit: Benefit!
"""The individual that was enrolled in the benefit"""
individual: Individual!
}
"""All errors extend this core `Error` interface."""
interface Error {
"""An alphanumeric identifier for this error."""
code: String!
"""A user-facing error message."""
message: String!
"""
Returns true if the client can safely retry the request, false otherwise.
"""
retryable: Boolean!
}
"""An input type used when funding a benefit for an individual"""
input FundBenefitForIndividualInput {
"""
The amount of funds to make available to the individual. This must be positive, non-zero amount
in USD currency or the request will be rejected as invalid.
"""
amount: MoneyInput!
"""The ID of the benefit the individual is enrolled in"""
benefitId: ID!
"""A unique idempotency key for this request."""
idempotencyKey: String!
"""The ID of the individual who should receive these funds"""
individualId: ID!
}
"""
A union representing the possible return types when funding an individual in a benefit
"""
union FundBenefitForIndividualResponse = BadRequestError | FundBenefitForIndividualResult | InternalServerError
"""The successful result of funding an individual in a benefit"""
type FundBenefitForIndividualResult {
"""The ID of the benefit that was funded"""
benefitId: ID!
"""The ID of the individual who was funded"""
individualId: ID!
"""The ID of the transaction corresponding to this funding request"""
transactionId: ID!
}
"""A Health Wallet belonging to an Individual"""
type HealthWallet {
"""The accounts belonging to this Health Wallet"""
accounts: [Account!]!
"""
A summary object describing Balance aggregates across all accounts in a Health Wallet.
"""
balanceSummary: HealthWalletBalanceSummary!
"""The ID of the Health Wallet"""
id: ID!
}
"""
A summary object describing Balance aggregates across all accounts in a Health Wallet.
"""
type HealthWalletBalanceSummary {
"""
The total available balance across all accounts belonging to this Health Wallet
"""
totalAvailableBalance: Money!
"""
The total current balance across all accounts belonging to this Health Wallet.
Note that `currentBalance` and `availableBalance` may differ when there
are ongoing money movement processes.
"""
totalCurrentBalance: Money!
}
"""An Individual"""
type Individual {
"""The Individual's primary address"""
address: PhysicalAddress
"""The Individual's date of birth"""
dateOfBirth: LocalDate
"""The Individual's email address"""
email: EmailAddress
"""The Individual's Health Wallet"""
healthWallet: HealthWallet
"""The ID of the Individual"""
id: ID!
"""The Individual's mailing address"""
mailingAddress: PhysicalAddress
"""The Individual's name"""
name: IndividualName!
"""The Individual's phone number"""
phoneNumber: PhoneNumber
"""The Individual's Tax Identification Number"""
tin: String
}
"""Filter criteria used when querying for an Individual"""
input IndividualFilterInput {
"""The ID of the Individual"""
id: ID!
}
"""An Individual"""
input IndividualInput {
"""The Individual's primary address"""
address: PhysicalAddressInput
"""The Individual's date of birth"""
dateOfBirth: LocalDate
"""The Individual's email address"""
email: EmailAddress
"""The Individual's mailing address"""
mailingAddress: PhysicalAddressInput
"""The Individual's name"""
name: IndividualNameInput!
"""The Individual's phone number"""
phoneNumber: PhoneNumber
"""The Individual's Tax Identification Number"""
tin: String
}
"""An Individual's name"""
type IndividualName {
"""The Individual's first name"""
firstName: String!
"""The Individual's last name"""
lastName: String!
"""The Individual's middle name, if any"""
middleName: String
}
"""An Individual's name"""
input IndividualNameInput {
"""The Individual's first name"""
firstName: String!
"""The Individual's last name"""
lastName: String!
"""The Individual's middle name, if any"""
middleName: String
}
"""
A union representing the possible return types when querying for an Individual
"""
union IndividualResponse = BadRequestError | Individual | InternalServerError
"""Filter criteria used when querying for Individuals"""
input IndividualsFilterInput {
"""
If specified, only returns Individuals who are enrolled in these Benefits
"""
benefitIds: [ID!]
"""
If specified, only returns Individuals who are enrolled in these Benefits Programs
"""
benefitsProgramIds: [ID!]
"""If specified, only returns Individuals matching these Individual IDs"""
ids: [ID!]
"""
If specified, only returns Individuals who are members of these Organizations
"""
organizationIds: [ID!]
}
"""
A union representing the possible return types when querying for Individuals
"""
union IndividualsResponse = BadRequestError | IndividualsResults | InternalServerError
"""Represents a page of Individuals"""
type IndividualsResults {
nodes: [Individual!]!
pageInfo: PageInfo!
}
"""Returned when an error is encountered that is not expected."""
type InternalServerError implements Error {
"""An alphanumeric identifier for this error."""
code: String!
"""A user-facing error message."""
message: String!
"""
Returns true if the client can safely retry the request, false otherwise.
"""
retryable: Boolean!
}
"""
The `JSON` scalar type represents JSON values as specified by [ECMA-404](http://www.ecma-international.org/publications/files/ECMA-ST/ECMA-404.pdf).
"""
scalar JSON
"""
The `JSONObject` scalar type represents JSON objects as specified by [ECMA-404](http://www.ecma-international.org/publications/files/ECMA-ST/ECMA-404.pdf).
"""
scalar JSONObject
"""
A local date string (i.e., with no associated timezone) in `YYYY-MM-DD` format, e.g. `2020-01-01`.
"""
scalar LocalDate
"""
A local time string (i.e., with no associated timezone) in 24-hr `HH:mm[:ss[.SSS]]` format, e.g. `14:25` or `14:25:06` or `14:25:06.123`. This scalar is very similar to the `LocalTime`, with the only difference being that `LocalEndTime` also allows `24:00` as a valid value to indicate midnight of the following day. This is useful when using the scalar to represent the exclusive upper bound of a time block.
"""
scalar LocalEndTime
"""
A local time string (i.e., with no associated timezone) in 24-hr `HH:mm[:ss[.SSS]]` format, e.g. `14:25` or `14:25:06` or `14:25:06.123`.
"""
scalar LocalTime
"""The locale in the format of a BCP 47 (RFC 5646) standard string"""
scalar Locale
"""
Represents an amount of money, e.g. an account balance which may be positive or negative.
"""
type Money {
"""
The amount of money in the standard denomination of the target currency.
In `USD`, for example, this represents dollars, where `$1.00` is represented as `1`, and $1.50 is represented as `1.50`.
"""
amount: Float!
"""
The ISO-4217 currency associated with this money. Note that only `USD` is supported at this time.
"""
currency: Currency!
"""The amount and currency formatted for display e.g. $10.00"""
display(
"""Used to change the format when displaying money as a formatted string"""
format: MoneyDisplayFormat = DEFAULT
): String!
"""
The amount of money in the smallest denomination of the target currency.
In `USD`, for example, this represents cents. However, for zero-decimal currencies, this will match the `amount`.
"""
lowestDenominationAmount: Int!
}
"""Used to change the format when displaying money as a formatted string"""
enum MoneyDisplayFormat {
"""
The accounting format, where negative numbers will be wrapped in parentheses instead of prefixed with a `-` sign.
"""
ACCOUNTING
"""
The default format, where negative numbers are prefixed with a `-` sign.
"""
DEFAULT
}
"""
Represents an amount of money, e.g. an account balance which may be positive or negative.
"""
input MoneyInput {
"""
The ISO-4217 currency associated with this money. Note that only `USD` is supported at this time.
"""
currency: Currency!
"""
The amount of money in the smallest denomination of the target currency.
In `USD`, for example, this represents cents.
"""
lowestDenominationAmount: Int!
}
type Mutation {
"""Create a new Benefit"""
createBenefit(input: CreateBenefitInput!): CreateBenefitResponse
"""Create a new Benefits Program"""
createBenefitsProgram(input: CreateBenefitsProgramInput!): CreateBenefitsProgramResponse
"""Create Individual"""
createIndividual(input: CreateIndividualInput!): CreateIndividualResponse
"""Create a new Organization"""
createOrganization(input: CreateOrganizationInput!): CreateOrganizationResponse
"""Enroll an Individual in a Benefit"""
enrollIndividualInBenefit(input: EnrollIndividualInBenefitInput!): EnrollIndividualInBenefitResponse
"""
Adds an amount of funds to a Benefit for an Individual. On success, the total funds available to the Individual
in this Benefit is increased by the amount specified in the request.
"""
fundBenefitForIndividual(input: FundBenefitForIndividualInput!): FundBenefitForIndividualResponse
"""Unenroll an individual from a Benefit"""
unenrollIndividualFromBenefit(input: UnenrollIndividualFromBenefitInput!): UnenrollIndividualFromBenefitResponse
"""Update an existing Benefit"""
updateBenefit(input: UpdateBenefitInput!): UpdateBenefitResponse
"""Update an existing Benefits Program"""
updateBenefitsProgram(input: UpdateBenefitsProgramInput!): UpdateBenefitsProgramResponse
"""Update an existing Individual"""
updateIndividual(input: UpdateIndividualInput!): UpdateIndividualResponse
"""Update an existing Organization"""
updateOrganization(input: UpdateOrganizationInput!): UpdateOrganizationResponse
}
"""A string that cannot be passed as an empty value"""
scalar NonEmptyString
"""
An Organization manages Benefits Programs on behalf of Individuals. An example of an Organization
is an employer, a charity, etc. An Organization has a relationship (e.g. employer-employee) with Individuals.
Organizations are typically customers of the API consumer.
"""
type Organization {
"""The unique ID for the Organization"""
id: ID!
"""The user-displayable name of the Organization"""
name: String!
}
"""Filter criteria used when querying for an Organization"""
input OrganizationFilterInput {
"""The ID of the Organization"""
id: ID!
}
"""
A union representing the possible return types when querying for an Organization
"""
union OrganizationResponse = BadRequestError | InternalServerError | Organization
"""Filter criteria used when querying for Organizations"""
input OrganizationsFilterInput {
"""If specified, only returns Organizations matching these IDs"""
ids: [ID!]
"""If specified, only returns Organizations matching these names"""
names: [String!]
}
"""
A union representing the possible return types when querying for Organizations
"""
union OrganizationsResponse = BadRequestError | InternalServerError | OrganizationsResults
"""Represents a page of Organizations"""
type OrganizationsResults {
nodes: [Organization!]!
pageInfo: PageInfo!
}
"""Metadata used when paging over a list of items"""
type PageInfo {
"""
When paging forward, this cursor is used to continue. It should be the cursor belonging to the last item in the previous page
"""
endCursor: String
"""
When paging forward, this flag indicates whether there are more items in the list
"""
hasNextPage: Boolean!
}
"""
A field whose value conforms to the standard E.164 format as specified in: https://en.wikipedia.org/wiki/E.164. Basically this is +17895551234.
"""
scalar PhoneNumber
"""A physical address"""
type PhysicalAddress {
"""The first line of an address e.g. `123 Main St`"""
addressLine1: String!
"""The second line of an address e.g. `Apt 111`"""
addressLine2: String
"""The city e.g. `Austin`"""
city: String!
"""The country e.g. `USA`"""
country: CountryCode
"""The state e.g. `Texas`"""
state: String!
"""The zip code e.g. `78704`"""
zip: PostalCode!
}
"""A physical address"""
input PhysicalAddressInput {
"""The first line of an address e.g. `123 Main St`"""
addressLine1: String!
"""The second line of an address e.g. `Apt 111`"""
addressLine2: String
"""The city e.g. `Austin`"""
city: String!
"""The country e.g. `USA`"""
country: CountryCode
"""The state e.g. `Texas`"""
state: String!
"""The zip code e.g. `78704`"""
zip: PostalCode!
}
"""
A field whose value conforms to the standard postal code formats for United States, United Kingdom, Germany, Canada, France, Italy, Australia, Netherlands, Spain, Denmark, Sweden, Belgium, India, Austria, Portugal, Switzerland or Luxembourg.
"""
scalar PostalCode
type Query {
"""Returns a Benefit by ID"""
benefit(where: BenefitFilterInput!): BenefitResponse
"""Returns Benefit Templates"""
benefitTemplates(
"""Return the elements in the list that come after the specified cursor"""
after: String
"""The number of elements to retrieve per page"""
first: Int = 100
"""Filter criteria used to match benefit templates"""
where: BenefitTemplatesFilterInput
): BenefitTemplatesResponse
"""Returns a Benefits Program by ID"""
benefitsProgram(where: BenefitsProgramFilterInput!): BenefitsProgramResponse
"""Returns Benefits Programs matching the filter criteria"""
benefitsPrograms(
"""Return the elements in the list that come after the specified cursor"""
after: String
"""The number of elements to retrieve per page"""
first: Int = 100
"""Filter criteria used to match Benefits Programs"""
where: BenefitsProgramsFilterInput
): BenefitsProgramsResponse
"""Returns an Individual by ID"""
individual(where: IndividualFilterInput!): IndividualResponse
"""Returns an Individual by ID"""
individuals(
"""Return the elements in the list that come after the specified cursor"""
after: String
"""The number of elements to retrieve per page"""
first: Int = 100
"""Filter criteria used to match Individuals"""
where: IndividualsFilterInput
): IndividualsResponse
"""Returns an Organization by ID"""
organization(where: OrganizationFilterInput!): OrganizationResponse
"""Returns Organizations matching the filter criteria"""
organizations(
"""Return the elements in the list that come after the specified cursor"""
after: String
"""The number of elements to retrieve per page"""
first: Int = 100
"""Filter criteria used to match Organizations"""
where: OrganizationsFilterInput
): OrganizationsResponse
}
"""
In the US, an ABA routing transit number (`ABA RTN`) is a nine-digit code to identify the financial institution.
"""
scalar RoutingNumber
"""
The `SafeInt` scalar type represents non-fractional signed whole numeric values that are considered safe as defined by the ECMAScript specification.
"""
scalar SafeInt
"""
A time string at UTC, such as 10:15:30Z, compliant with the `full-time` format outlined in section 5.6 of the RFC 3339profile of the ISO 8601 standard for representation of dates and times using the Gregorian calendar.
"""
scalar Time
"""
A field whose value exists in the standard IANA Time Zone Database: https://www.iana.org/time-zones
"""
scalar TimeZone
"""
The javascript `Date` as integer. Type represents date and time as number of milliseconds from start of UNIX epoch.
"""
scalar Timestamp
"""A Transaction posted against an Account."""
type Transaction {
"""
The amount of the Transaction. Positive values indicate a credit while negative values indicate a debit
"""
amount: Money!
"""The balance of the Account immediately after this Transaction"""
balance: Money!
"""The Date of the Transaction"""
date: LocalDate!
"""A description of the Transaction"""
description: String!
"""The ID of the Transaction"""
id: ID!
"""A timestamp of the Transaction, if available"""
timestamp: DateTime
}
"""Represents a page of Transactions against an Account"""
type TransactionResults {
"""The Transactions in this page"""
nodes: [Transaction!]!
"""Pagination metadata"""
pageInfo: PageInfo!
}
"""Filter criteria used when querying for Transactions"""
input TransactionsFilterInput {
"""
When specified, only returns transactions that occurred after the specified DateTime.
"""
after: DateTime
"""
When specified, only returns transactions that occurred before the specified DateTime.
"""
before: DateTime
}
"""
A field whose value conforms to the standard URL format as specified in RFC3986: https://www.ietf.org/rfc/rfc3986.txt.
"""
scalar URL
"""
A field whose value is a generic Universally Unique Identifier: https://en.wikipedia.org/wiki/Universally_unique_identifier.
"""
scalar UUID
"""An input type used when unenrolling an individual from a benefit"""
input UnenrollIndividualFromBenefitInput {
"""The ID of the benefit the individual is enrolled in"""
benefitId: ID!
"""
The date (YYYY-MM-DD) when unenrollment becomes effective. If unspecified, this request is immediately
effective as of the current date.
"""
effectiveAt: LocalDate
"""The ID of the individual to unenroll from the benefit"""
individualId: ID!
}
"""
A union representing the possible return types when unenrolling an individual from a benefit
"""
union UnenrollIndividualFromBenefitResponse = BadRequestError | InternalServerError | UnenrollIndividualFromBenefitResult
"""The successful result of unenrolling an individual from a benefit"""
type UnenrollIndividualFromBenefitResult {
"""The benefit"""
benefit: Benefit!
"""The individual that was unenrolled from the benefit"""
individual: Individual!
}
"""An input type used when updating a benefit"""
input UpdateBenefitInput {
"""The ID of the benefit to update"""
id: ID!
"""A human-readable name for the benefit"""
name: String
}
"""A union representing the possible return types when updating a benefit"""
union UpdateBenefitResponse = BadRequestError | InternalServerError | UpdateBenefitResult
"""The successful result of updating a benefit"""
type UpdateBenefitResult {
"""The benefit that was updated"""
benefit: Benefit!
}
"""An input type used when updating a benefits program"""
input UpdateBenefitsProgramInput {
"""The ID of the program to update"""
id: ID!
"""The name of the program"""
name: String
}
"""
A union representing the possible return types when updating a benefits program
"""
union UpdateBenefitsProgramResponse = BadRequestError | InternalServerError | UpdateBenefitsProgramResult
"""The successful result of updating a benefits program"""
type UpdateBenefitsProgramResult {
"""The program that was updated"""
benefitsProgram: BenefitsProgram!
}
"""An input type used for updating an Individual"""
input UpdateIndividualInput {
"""A new address for the Individual, if applicable"""
address: PhysicalAddressInput
"""A new date of birth for the Individual, if applicable"""
dateOfBirth: LocalDate
"""A new email address for the Individual, if applicable"""
email: EmailAddress
"""The ID of the Individual to update"""
id: ID!
"""A new mailing address for the Individual, if applicable"""
mailingAddress: PhysicalAddressInput
"""A new name for the Individual, if applicable"""
name: IndividualNameInput
"""A new phone number for the Individual, if applicable"""
phoneNumber: PhoneNumber
"""A new Tax Identification Number for the Individual, if applicable"""
tin: String
}
"""
A union representing the possible return types when updating an Individual
"""
union UpdateIndividualResponse = BadRequestError | InternalServerError | UpdateIndividualResult
"""The successful result of updating an Individual"""
type UpdateIndividualResult {
"""The Individual that was updated"""
individual: Individual!
}
"""An input type used when updating an Organization"""
input UpdateOrganizationInput {
"""The ID of the Organization to update"""
id: ID!
"""The user-displayable name of the Organization to update"""
name: String!
}
"""
A union representing the possible return types when updating an Organization
"""
union UpdateOrganizationResponse = BadRequestError | InternalServerError | UpdateOrganizationResult
"""The successful result of updating an Organization"""
type UpdateOrganizationResult {
"""The Organization that was updated"""
organization: Organization!
}
"""
A field whose value is a UTC Offset: https://en.wikipedia.org/wiki/List_of_tz_database_time_zones
"""
scalar UtcOffset
"""Represents NULL values"""
scalar Void