Schema Types

Table of Contents

Query
Mutation
Objects
Inputs
Enums
Scalars
Interfaces
- ApplicationRequirement
- Requirement

Query

The root query type for the OwlFlow API. Operations are grouped into namespaced fields to provide a clear and organized contract.

Field	Type	Description
billing	BillingQuery!	Entrypoint for billing, subscription management, and payment configuration.
health	String!	Returns a simple string to verify the operational status of the API.
me	Account	The current authenticated user's account details. This is a convenience alias for `viewer { account }`.
references	ReferencesQuery!	Entrypoint for accessing static reference data such as dictionaries and geographic lookups.
requirement	Requirement	Fetch a single requirement by ID and type.
id	ID!
type	RequirementTypeEnum!
scholarships	ScholarshipsQuery!	Entrypoint for searching, listing, and retrieving scholarship information.
viewer	Viewer!	Contextual information and operations for the current requester (viewer). Includes access to "my" data like applications and profile stats.

Mutation

The root mutation type for the OwlFlow API. Mutations are grouped into namespaced fields based on their functional domain.

Field	Type	Description
auth	AuthMutations!	Operations related to user authentication, registration, and security.
billing	BillingMutations!	Operations for processing payments, managing subscriptions, and applying discounts.
deleteAccount	Boolean!	Permanently deletes the specified account and all associated data. This action is irreversible.
id	ID!
scholarships	ScholarshipsMutations!	Operations for interacting with scholarships, managing applications, and reporting content.
viewer	ViewerMutations!	Operations specific to the currently authenticated user's profile and session.

Objects

Account

Represents a user account and their associated profile information. This is the central entity for student data on the platform.

Field	Type	Description
address	Address!	Physical mailing address.
careerGoal	CareerGoalType	The user's primary career or professional goal.
citizenship	CitizenshipStatus	The user's citizenship status (e.g., U.S. Citizen, Permanent Resident).
createdAt	DateTime!	Timestamp of when the account was created.
dateOfBirth	DateTime	The user's date of birth. Used for age-based eligibility.
documents	[Document!]!	A collection of documents (e.g., transcripts, resumes) uploaded by the user.
education	Education!	A list of the user's educational history and current enrollment status.
email	String!	Primary email address used for login and notifications.
ethnicity	EthnicityType	The user's ethnic background. Used for diversity-based eligibility.
firstName	String!	The user's first name.
gender	String	The user's gender identity. Normalized values: male, female, non-binary. Custom values are also accepted.
id	ID!	Unique identifier for the account.
lastName	String!	The user's last name.
membership	Membership	Details about the user's platform membership or subscription plan.
militaryAffiliation	MilitaryAffiliationType	The user's current or past military service status.
phone	String	Primary contact phone number.
profileCompletion	ProfileCompletion!	Provides metrics and guidance on how complete the user's profile is.
socialAccounts	[SocialAccount!]!	A list of third-party social accounts linked to this user.
updatedAt	DateTime!	Timestamp of when the account or profile was last updated.

AccountFile

Information about a file stored on the platform.

Field	Type	Description
createdAt	DateTime!	Timestamp when the file was uploaded.
id	ID!	Unique identifier for the file.
mimeType	String	The MIME type of the file (e.g., "application/pdf").
name	String!	System-generated or display name for the file.
originalName	String	The name of the file as it was originally uploaded.
path	String!	The internal storage path of the file.
size	Int	The size of the file in bytes.
url	String	The public-facing URL to access the file.

Address

A physical mailing or billing address.

Field	Type	Description
addressLine1	String
city	String
country	String!	The country code. Always "USA" as all users are registered in the United States. This field cannot be mutated.
state	State
zip	String

AllDictionaries

A consolidated collection of all dictionary data required to populate forms. This is the most efficient way to load data for registration or profile editing.

Field	Type	Description
careerGoals	[EnumDisplayItem!]!	Common career and professional goals.
citizenship	[EnumDisplayItem!]!	Options for user citizenship status.
countries	[DictionaryItem!]!	A list of all supported countries.
degreeTypes	[EnumDisplayItem!]!	Broad types of academic degrees.
degrees	[EnumDisplayItem!]!	Specific academic degree titles.
ethnicities	[EnumDisplayItem!]!	Options for ethnic background.
genders	[DictionaryItem!]!	Options for gender identity.
highSchools	[HighSchool!]!	Searchable list of high schools and colleges.
limit	Int	The maximum number of results to return.
search	String	Search term to match against school names.
state	String	Filter by state abbreviation.
type	SchoolType	Filter by the type of institution.
militaryAffiliations	[EnumDisplayItem!]!	Options for military service status and affiliation.
schoolLevels	[EnumDisplayItem!]!	Standard educational levels.
states	[DictionaryState!]!	A list of all states/provinces.

Application

Field	Argument	Type	Description
createdAt		DateTime!
dateAppliedWithoutTimeZone		String
derivedStatus		DerivedApplicationStatus
disqualifyAt		DateTime
externalStatusUpdateSeen		Boolean
externalStatusUpdatedAt		DateTime
id		ID!
requirementMap		[RequirementMapEntry!]!
scholarship		Scholarship
scholarshipId		ID!
status		ApplicationStatus!
updatedAt		DateTime
winnerFormUrl		String
winnerUrl		String

ApplicationConnection

A paginated collection of scholarship applications.

Field	Type	Description
nodes	[Application!]!	The list of application objects for the current page.
pageInfo	PageInfo!	Pagination metadata.
totalCount	Int!	The total number of applications matching the criteria.

ApplicationFile

A student's file upload for a file requirement.

Field	Type	Description
account	Account	The account that uploaded this file.
createdAt	DateTime!
file	AccountFile!	Details of the uploaded file.
id	ID!
requirement	RequirementFile	The original file requirement.
source	String
updatedAt	DateTime

ApplicationGoal

A student's selection for a goal requirement.

Field	Type	Description
account	Account	The account that provided this selection.
createdAt	DateTime!
description	String	The written description for the selected goal.
id	ID!
requirement	RequirementGoal	The original goal requirement.
source	String
updatedAt	DateTime

ApplicationImage

A student's image upload for an image requirement.

Field	Type	Description
account	Account	The account that uploaded this image.
createdAt	DateTime!
file	AccountFile!	Details of the uploaded image.
id	ID!
requirement	RequirementImage	The original image requirement.
source	String
updatedAt	DateTime

ApplicationInput

A student's response for a single input requirement.

Field	Type	Description
account	Account	The account that provided this response.
createdAt	DateTime!
id	ID!
requirement	RequirementInput	The original input requirement.
source	String
text	String	The text value provided.
updatedAt	DateTime

ApplicationPreviewApplicationData

Field	Argument	Type	Description
body		String
recipient		String
subject		String

ApplicationPreviewData

Field	Argument	Type	Description
applicationData		ApplicationPreviewApplicationData
fields		[ApplicationPreviewField!]!

ApplicationPreviewField

Field	Argument	Type	Description
label		String!
val		String

ApplicationSpecialEligibility

A student's confirmation for a special eligibility requirement.

Field	Type	Description
account	Account	The account that provided this confirmation.
createdAt	DateTime!
id	ID!
requirement	RequirementSpecialEligibility	The original eligibility requirement.
source	String
specialEligibilityValue	String	The confirmed value or status.
updatedAt	DateTime

ApplicationStrategyHealth

Field	Argument	Type	Description
percentageValue		Int
score		Float
state		StrategyHealthState!
zone		StrategyHealthZone

ApplicationSurvey

A student's set of answers for a survey requirement.

Field	Type	Description
account	Account	The account that provided these answers.
answers	JSON!	The answers provided for the survey questions, stored as a JSON object.
createdAt	DateTime!
id	ID!
requirement	RequirementSurvey	The original survey requirement.
source	String
updatedAt	DateTime

ApplicationText

A student's written response or essay for a text requirement.

Field	Type	Description
account	Account	The account that provided this response.
createdAt	DateTime!
extra	JSON	Additional metadata or structured data for the response.
file	AccountFile	Reference to an uploaded file if the response was provided as a document.
id	ID!
requirement	RequirementText	The original requirement this response fulfills.
source	String
text	String	The written text content.
updatedAt	DateTime

AuthMutations

Authentication and account security operations.

Field	Type	Description
changePassword	Boolean!	Changes the password for the currently authenticated user.
input	PasswordChangeInput!
connectSocialAccount	AuthResponse!	Links a social media account to the current user's profile.
input	ConnectSocialAccountInput!
createUser	UserCreationResult!	Registers a new user account. This is the primary entrypoint for the registration funnel.
input	CreateUserInput!
deleteDocument	Boolean!	Permanently removes a document from the user's profile.
id	ID!
disconnectSocialAccount	Boolean!	Removes the link between a social media account and the user's profile.
provider	SocialProvider!
exchangeCookie	AuthResponse!	Exchanges a legacy session cookie for a JWT token. Use this when migrating from cookie-based to token-based authentication.
input	ExchangeCookieInput!
googleAuth	AuthResponse!	Authenticates or registers a user using Google OAuth.
input	GoogleAuthInput!
login	AuthResponse!	Authenticates a user using email and password.
input	LoginInput!
logout	Boolean!	Ends the current user session and invalidates the authentication token.
refreshToken	AuthResponse!	Issues a new authentication token to replace an expiring one.
requestPasswordReset	Boolean!	Triggers a password reset email to be sent to the user.
input	PasswordResetInput!
resetPassword	Boolean!	Sets a new password using a valid reset token.
input	ResetPasswordInput!
uploadDocument	Document!	Uploads a document (e.g., resume, transcript) to the user's profile.
file	Upload!	The file to be uploaded.
type	String!	The category of the document being uploaded (e.g., "TRANSCRIPT").

AuthResponse

The response from a successful authentication operation. Includes the access token and the authenticated user's account details.

Field	Type	Description
expiresAt	DateTime!	The timestamp when the authentication token expires.
token	String!	The authentication token to be used in subsequent requests.
user	Account!	The authenticated user's account information.

AutomaticScholarship

Details of a scholarship that is automatically handled by the platform.

Field	Argument	Type	Description
expirationDate		DateTime
id		ID!
startDate		DateTime
timezone		String
title		String!

BillingMutations

Namespace for all mutations related to billing and subscriptions.

Field	Type	Description
applyDiscount	Boolean!	Applies an available discount to the current user's active subscription.
cancelMembership	Boolean!	Permanently cancels an active membership subscription.
membershipId	ID!
setSubscriptionMaintenanceMode	Boolean!	Enables or disables maintenance mode for a subscription. Maintenance mode can be used to temporarily pause subscription features.
isMaintenanceMode	Boolean!
subscriptionId	ID!
submitSubscriptionCancellationSurvey	Boolean!	Submits a survey response when a user attempts to cancel their subscription.
input	BillingSubscriptionCancellationSurveyInput!

BillingPackage

A subscription package offered to users. Contains pricing, features, and display metadata.

Field	Type	Description
billingAgreement	String	The legal or descriptive text for the billing agreement.
buttonCSS	String	Optional CSS classes or styles for the purchase button.
buttonTextForPackage	String	The text to display on the purchase button.
contactUsLink	Boolean	Whether to display a "Contact Us" link instead of a purchase button.
discountPrice	Float	A discounted price, if applicable.
displayDescriptionItems	[String!]!	A list of key features or benefits to display to the user.
displayMessage	String	A short marketing message for the package.
displaySuccessMessage	String	A message to display after a successful purchase.
expirationPeriodType	String	The unit of time for expiration (e.g., "MONTH", "YEAR").
expirationPeriodValue	Int	The number of units until expiration.
expirationType	String	The type of expiration for the package (e.g., "finite", "infinite").
freeTrialPeriodText	String	Descriptive text explaining the free trial terms.
id	ID!	Unique identifier for the package.
isContactUs	Boolean	Whether the user should be directed to contact support for this package.
isFreeTrial	Boolean	Whether this package includes a free trial period.
isFreemium	Boolean	Whether this is a freemium or basic package.
isMarked	Boolean	Whether this package is highlighted or recommended.
isRecurrent	Boolean	Whether this package uses recurring billing.
name	String!	Display name of the package.
paypalExpirationType	String	Specific expiration type for PayPal-based subscriptions.
price	Float	The total price of the package in USD.
pricePerMonth	Float	The equivalent price per month in USD.
recurrentPriceMessage	String	A descriptive message for recurrent billing (e.g., "$19.99 billed monthly").

BillingPaymentPopupDetails

Configuration and data required to render the payment interface.

Field	Type	Description
convertToFreemiumEnabled	Boolean!	Whether the option to convert to a freemium plan is enabled.
disclaimerEnabled	Boolean!	Whether a legal or informational disclaimer should be displayed.
disclaimerText	String	The text of the disclaimer.
packages	[BillingPackage!]!	A list of available subscription packages.
paymentMethodName	String!	The name of the default or selected payment method.
popupTitle	String	The title for the payment popup.
stripePublishableKey	String	The publishable key for Stripe integration.

BillingQuery

Namespace for all queries related to billing, subscriptions, and special offers.

Field	Type	Description
package	BillingPackage	Retrieves details for a specific billing package by its ID.
id	ID!
paymentPopupDetails	BillingPaymentPopupDetails!	Retrieves payment configuration and available packages for the current user. Used to render the premium upgrade popup.
specialOfferPage	BillingSpecialOfferPage!	Retrieves a special offer landing page and its associated package by URL.
url	String!
specialOfferPages	BillingSpecialOfferPageConnection!	Lists all available special offer landing pages.
pagination	PaginationInput

BillingSpecialOfferPage

A marketing landing page for a special subscription offer.

Field	Type	Description
description	String	The primary marketing copy or description.
iconTitle1	String	Title for the first marketing icon/feature.
iconTitle2	String	Title for the second marketing icon/feature.
iconTitle3	String	Title for the third marketing icon/feature.
id	ID!	Unique identifier for the page.
metaAuthor	String	SEO: Author metadata.
metaDescription	String	SEO: Description metadata.
metaKeywords	String	SEO: Keywords metadata.
metaTitle	String	SEO: Title metadata.
package	BillingPackage	The specific billing package associated with this offer.
scrollToText	String	Optional text for an auto-scroll or call-to-action link.
title	String	The page title.
url	String	The unique URL slug for the landing page.

BillingSpecialOfferPageConnection

A paginated collection of special offer pages.

Field	Argument	Type	Description
nodes		[BillingSpecialOfferPage!]!
pageInfo		PageInfo!
totalCount		Int!

BrandIdentity

Field	Argument	Type	Description
logo		String
mission		String
socials		BrandSocials

BrandSocials

Field	Argument	Type	Description
facebook		String
instagram		String
linkedin		String
x		String

CareerGoal

Career and professional path options.

Field	Type	Description
category	String	The broad category this career goal belongs to.
description	String
id	ID!
isActive	Boolean!
name	String!
order	Int
value	String!

CategoryStats

Field	Argument	Type	Description
count		Int!
name		String!
totalAmount		Float!

CoregApplication

Field	Argument	Type	Description
consentText		String
displayName		String

Degree

Academic degree titles and levels.

Field	Type	Description
description	String
id	ID!
isActive	Boolean!
level	String	The educational level required for this degree (e.g., "Undergraduate").
name	String!
order	Int
value	String!

DegreeType

Broad categories of academic degrees.

Field	Argument	Type	Description
category		String
description		String
id		ID!
isActive		Boolean!
name		String!
order		Int
value		String!

DictionaryItem

A generic item from a platform dictionary (e.g., country list, gender options). Used to populate dropdowns and selection lists in the UI.

Field	Type	Description
description	String	An optional description providing more context.
id	ID!	Unique internal identifier.
isActive	Boolean!	Whether the item is currently active and should be displayed to users.
name	String!	The human-readable name of the item.
order	Int	The preferred display order for this item.
value	String!	The machine-readable value of the item.

DictionaryState

Geographic state or province information (dictionary object, selectable fields).

Field	Type	Description
code	String!	The standard postal abbreviation for the state.
country	String	The country the state belongs to.
id	ID!
isActive	Boolean!
name	String!	The full name of the state.
order	Int

Document

A document uploaded to the platform, such as a transcript or essay.

Field	Type	Description
id	ID!	Unique identifier for the document.
name	String!	The display name of the document.
type	String!	The type or category of the document (e.g., "TRANSCRIPT").
uploadedAt	DateTime!	When the document was uploaded.
url	String!	The public URL to access the document content.

Education

Details of an educational attainment or current enrollment.

Field	Type	Description
collegeAddress	String	The address of the college or university.
collegeGraduationMonth	Int	The month of college graduation or expected graduation.
collegeGraduationYear	Int	The year of college graduation or expected graduation.
collegeName	String	The name of university.
degree	DegreeField	The degree or qualification pursued or earned.
degreeType	DegreeTypeEnum	Broad types of academic degrees.
enrolled	Boolean	Whether the user is currently enrolled in college.
enrollmentMonth	Int	The month of college enrollment.
enrollmentYear	Int	The year of college enrollment.
fieldOfStudy	String	The primary area of study.
gpa	Float	The Grade Point Average (GPA) achieved.
highSchoolAddress	String	The address of the high school.
highSchoolGraduationMonth	Int	The month of high shool graduation or expected graduation.
highSchoolGraduationYear	Int	The year of high school graduation or expected graduation.
highSchoolName	String	The name of the high shool educational institution.
schoolLevel	SchoolLevelType	The level of education (e.g., "High school freshman, "College 4th year").

Eligibility

Field	Argument	Type	Description
description		String
field		EligibilityField!
id		ID!
isOptional		Boolean!
operator		EligibilityOperator!
type		EligibilityType!
value		String!

EligibilityField

Field	Argument	Type	Description
id		String!
name		String!
type		String!

EnumDisplayItem

An item from a dictionary specifically for enum values, providing display text.

Field	Type	Description
name	String!	The human-readable name of the item.
order	Int	The preferred display order for this item.
value	String!	The enum value (machine-readable, SCREAMING_SNAKE_CASE).

EssayDiffResult

The result of computing an essay diff between AI-generated and user-edited text.

Field	Argument	Type	Description
diff		String!

EssayGenerationResult

The result of an AI essay generation request.

Field	Argument	Type	Description
text		String

EssayTopic

An essay topic extracted by AI for a specific text requirement. Used to scope personalization questions and essay generation.

Field	Argument	Type	Description
id		ID!
topic		String!

Ethnicity

Details of an ethnic background category.

Field	Argument	Type	Description
description		String
id		ID!
isActive		Boolean!
name		String!
order		Int
value		String!

EthnicityConnection

A paginated collection of ethnicity options.

Field	Argument	Type	Description
edges		[EthnicityEdge!]!
pageInfo		PageInfo!
totalCount		Int!

EthnicityEdge

Field	Argument	Type	Description
cursor		String!
node		Ethnicity!

GraphQLError

Standard error information for API operations.

Field	Type	Description
code	String!	A stable error code for programmatic handling.
extensions	JSON	Additional contextual metadata about the error.
message	String!	A human-readable description of the error.
path	[String!]	The path to the field that caused the error.

HighSchool

Details of a high school or secondary educational institution.

Field	Argument	Type	Description
city		String
country		String
id		ID!
isActive		Boolean!
name		String!
state		String
stateId		ID
zipCode		String

HighSchoolConnection

A paginated collection of high school options.

Field	Argument	Type	Description
edges		[HighSchoolEdge!]!
pageInfo		PageInfo!
totalCount		Int!

HighSchoolEdge

Field	Argument	Type	Description
cursor		String!
node		HighSchool!

IpData

Geographic and network information derived from an IP address.

Field	Type	Description
city	String!	The name of the city.
country	String!	The name of the country.
countryCode	String!	The standard ISO country code.
region	String!	The name of the region or state.
regionCode	String!	The standard region or state code.
zip	String!	The postal or zip code.

Membership

The current status and details of a user's platform membership.

Field	Type	Description
expiresAt	DateTime	When the current membership is set to expire.
id	ID!	Unique identifier for the membership.
package	Package	The subscription package associated with this membership.
status	String!	The current status of the membership (e.g., "ACTIVE", "EXPIRED").

OnboardingPlugin

An onboarding "plugin" representing an external offer, survey, or integration.

Field	Type	Description
extra	JSON	Additional configuration or metadata for rendering the plugin.
id	ID!	Unique identifier for the plugin.
name	String!	The display name of the plugin or offer.
text	String!	Descriptive text explaining the offer or required action.

OnboardingPluginSubmissionResult

The result of an onboarding plugin submission.

Field	Argument	Type	Description
extra		JSON	Any updated metadata or confirmation data from the plugin provider.
id		ID!	The ID of the plugin.

Organization

An organization that provides scholarships.

Field	Argument	Type	Description
description		String
id		ID!
logoUrl		String
name		String!
website		String

Package

A subscription or membership plan offered by the platform.

Field	Type	Description
features	[String!]!	A list of feature names or keys included in the package.
id	ID!	Unique identifier for the package.
name	String!	The display name of the package.
scholarshipsCount	Int!	The number of scholarship applications or features included in this package.

PageInfo

Pagination information for collections.

Field	Type	Description
endCursor	String	The cursor for the last item in the current page.
hasNextPage	Boolean!	Indicates if there are more results available after the current page.
hasPreviousPage	Boolean!	Indicates if there are more results available before the current page.
startCursor	String	The cursor for the first item in the current page.

PersonalizationAnswer

A student's answer to a personalization question. Answers are scoped to the authenticated viewer.

Field	Argument	Type	Description
answer		String
questionId		ID!
skipped		Boolean!
updatedAt		DateTime

PersonalizationQuestion

A personalization question generated by AI for a specific essay requirement. Questions are shared across all students for the same requirement+topic combination.

Field	Type	Description
id	ID!
order	Int!
text	String!
topicId	ID	The ID of the essay topic this question belongs to.

PostEligibilityResult

The result of a pre-registration eligibility check.

Field	Argument	Type	Description
success		Boolean!	Whether the user is likely eligible for scholarships on the platform.

ProfileCompletion

Metrics and actionable steps for completing a user profile.

Field	Type	Description
completedSections	[String!]!	Names of the profile sections that are considered complete.
missingSections	[String!]!	Names of the profile sections that still need information.
nextSteps	[String!]!	Specific recommendations for what the user should do next to improve their profile.
percentage	Float!	The percentage of the profile that has been filled in.

ProfileProgress

Tracks the completeness of a user's profile and its impact on scholarship opportunities.

Field	Type	Description
completedSections	[String!]!	Names of sections (e.g., "Education", "Personal") that are fully complete.
completionPercentage	Float!	Overall percentage of the profile that is complete.
missingSections	[String!]!	Names of sections that still require information.
nextRecommendedFields	[String!]!	Specific fields the user should fill next to increase their completion score.
scholarshipImpact	String!	A description of how completing the profile will improve scholarship matching.

ProviderStats

Field	Argument	Type	Description
scholarshipsAmount		Float
totalAmountWon		Float

QuickApplyPayload

Result of a Quick Apply operation.

Field	Argument	Type	Description
application		Application
applicationId		ID
created		Boolean!
scholarship		Scholarship
scholarshipId		ID!

RecommendedAction

A suggested action for the user to improve their experience or profile.

Field	Argument	Type	Description
action		String!	The name or key of the action.
priority		String!	Priority level of the action (e.g., "HIGH").

ReferencesQuery

Namespace for static reference data and geographic lookup services.

Field	Type	Description
dictionaries	AllDictionaries!	Retrieves a consolidated set of dictionary data (e.g., countries, states, degrees). This is the recommended way to load options for forms and filters.
filters	DictionaryFilters
ipData	IpData!	Provides geographic data based on the requester's current IP address.
zipData	ZipData!	Provides geographic details (city, state) for a given United States zip code.
zipCode	String!

RegistrationProgress

Tracking information for a multi-step registration or onboarding process.

Field	Type	Description
canSkipStep	Boolean!	Whether the current step can be bypassed by the user.
completedSteps	[String!]!	A list of steps that have been successfully completed.
completionPercentage	Float!	Overall percentage of the process that is complete.
currentStep	String!	The name or identifier of the user's current step.
isComplete	Boolean!	Whether the entire process has been completed.
lastUpdated	DateTime!	When the progress was last updated.
missingFields	[String!]!	A list of mandatory fields that are currently empty.
nextStep	String	The suggested next step for the user.
requiredFields	[String!]!	A list of field names that must be filled in for the current process.
totalCount	Int!	The total number of steps in the process.

ReportScholarshipOption

An option for reporting a scholarship (e.g., "Inappropriate content").

Field	Argument	Type	Description
description		String!
id		ID!
isActive		Boolean!
isAllowDetails		Boolean!
orderNumber		Int!
title		String!

RequirementFile

A requirement for a file upload.

Field	Type	Description
allowedExtensions	[String!]	A list of allowed file extensions (e.g., "pdf", "docx").
createdAt	DateTime!
description	String
fileType	String	The specific type of file expected (e.g., "TRANSCRIPT").
id	ID!
isOptional	Boolean!
maxFileSize	Int	The maximum allowed file size in bytes.
name	String!
permanentTag	String
title	String
type	RequirementTypeEnum!
updatedAt	DateTime

RequirementGoal

A requirement for selecting a career or educational goal.

Field	Type	Description
createdAt	DateTime!
description	String
id	ID!
isOptional	Boolean!
name	String!
permanentTag	String
requiresDescription	Boolean	Whether the student must also provide a written description for their goal.
title	String
type	RequirementTypeEnum!
updatedAt	DateTime

RequirementImage

A requirement for an image upload.

Field	Type	Description
allowedFormats	[String!]	A list of allowed image formats (e.g., "jpg", "png").
createdAt	DateTime!
description	String
id	ID!
isOptional	Boolean!
maxFileSize	Int	The maximum allowed file size in bytes.
minHeight	Int	The minimum required height of the image in pixels.
minWidth	Int	The minimum required width of the image in pixels.
name	String!
permanentTag	String
title	String
type	RequirementTypeEnum!
updatedAt	DateTime

RequirementInput

A simple input requirement for a single piece of information.

Field	Type	Description
config	String	Configuration or validation rules for the input field.
createdAt	DateTime!
description	String
id	ID!
isOptional	Boolean!
name	String!
permanentTag	String
title	String
type	RequirementTypeEnum!
updatedAt	DateTime
value	String	The default or current value of the input.

RequirementMapEntry

Field	Argument	Type	Description
applicationRequirement		ApplicationRequirement
requirement		Requirement!

RequirementSpecialEligibility

A requirement confirming a student's special eligibility status.

Field	Type	Description
createdAt	DateTime!
description	String
id	ID!
isOptional	Boolean!
name	String!
permanentTag	String
specialEligibilityType	String	The type of special eligibility being verified.
specialEligibilityValue	String	The value or threshold for verification.
title	String
type	RequirementTypeEnum!
updatedAt	DateTime

RequirementStats

Field	Argument	Type	Description
completed		Int!
optional		Int!
total		Int!

RequirementSurvey

A survey requirement consisting of multiple questions.

Field	Type	Description
createdAt	DateTime!
description	String
id	ID!
isOptional	Boolean!
name	String!
permanentTag	String
questions	[SurveyQuestion!]!	The list of questions the student must answer.
surveyType	String	The internal type or format of the survey.
title	String
type	RequirementTypeEnum!
updatedAt	DateTime

RequirementText

A text-based requirement, typically an essay or personal statement.

Field	Type	Description
allowFile	Boolean	Whether the student is allowed to upload a file instead of typing the text.
allowedExtensions	[String!]	A list of allowed file extensions (e.g., "pdf", "docx").
attachmentFormat	String	The allowed file format if the text is uploaded as a file.
attachmentType	String	The format for attachments, if applicable.
createdAt	DateTime!
description	String
essayTopics	[EssayTopic!]!	Suggested topics or prompts for the essay. These can be used to guide AI generation or student writing.
id	ID!
isOptional	Boolean!
maxCharacters	Int	The maximum number of characters allowed.
maxFileSize	Int	The maximum allowed file size in bytes.
maxWords	Int	The maximum number of words allowed.
minCharacters	Int	The minimum number of characters required.
minWords	Int	The minimum number of words required.
name	String!
permanentTag	String
personalizationAnswers	[PersonalizationAnswer!]!	The authenticated viewer's saved answers to personalization questions. Returns empty array for unauthenticated users.
essayTopicId	ID
personalizationQuestions	[PersonalizationQuestion!]!	AI-generated personalization questions for this requirement. Shared across all students for the same requirement+essayTopic combination.
essayTopicId	ID
scholarship	Scholarship	The parent scholarship this requirement belongs to.
sendType	String	The method by which the text is submitted (e.g., "plain_text").
title	String
type	RequirementTypeEnum!
updatedAt	DateTime

Scholarship

Field	Argument	Type	Description
amount		Float!
amountsList		[Float!]
applicationCap		Int
applicationCount		Int
applicationType		String
applicationUrl		String
awards		Int
brandIdentity		BrandIdentity
capUrgency		CapUrgency
categories		[ScholarshipCategory!]!
category		String
coregApplication		CoregApplication
credibility		ScholarshipCredibility
credibilityLevel		CredibilityLevel
credibilityScore		Float
deadline		DateTime!
description		String
eligibilities		[Eligibility!]!
eligibilityRequirements		[String!]!
expirationDate		DateTime!
expirationTimezone		String
externalScholarshipId		String
hasApplication		Boolean
id		ID!
isAutomatic		Boolean
isEasy		Boolean
isEligible		Boolean
isFavorite		Boolean
isIgnored		Boolean
isRecurrent		Boolean
isSaved		Boolean
isSeen		Boolean
isSponsored		Boolean
lastUpdatedAt		DateTime
meta		ScholarshipMeta
myApplication		Application
organization		Organization
payoutMethod		PayoutMethod
provider		ScholarshipProvider
requirementStats		RequirementStats
requirements		[Requirement!]!
shortDescription		String
startedAt		DateTime
status		ScholarshipStatus!
tags		[String!]!
termsOfServiceUrl		String
title		String!
viewer		ScholarshipViewer
winnerAnnouncementDate		DateTime
winners		[Winner!]!

ScholarshipCategory

Scholarship category used for grouping and organizational purposes.

Field	Type	Description
color	String	Hex color code or CSS class name used for UI representation.
description	String	Brief description of what this category covers.
id	ID!	Unique identifier for the category.
name	String!	Display name of the category.

ScholarshipConnection

Field	Argument	Type	Description
nodes		[Scholarship!]!
pageInfo		PageInfo!
totalCount		Int!

ScholarshipCredibility

Field	Argument	Type	Description
level		CredibilityLevel
score		Float

ScholarshipMeta

Field	Argument	Type	Description
allMandatoryRequirementsCompleted		Boolean
applicationRequirementCounters		RequirementStats
favoriteAt		DateTime
ignoredAt		DateTime
isEligible		Boolean
providerStats		ProviderStats
reportedAt		DateTime
requirementCount		Int
requirementCounters		RequirementStats

ScholarshipProvider

Field	Argument	Type	Description
description		String
id		ID
logoUrl		String
mission		String
name		String
socials		BrandSocials
website		String

ScholarshipStats

Aggregated scholarship statistics for the current user.

Field	Type	Description
applicationCount	Int	Total number of applications the user has started or submitted.
applicationNotSeenCount	Int	Number of applications with updates or status changes the user hasn't seen.
easyApplyCount	Int	Number of "Easy Apply" scholarships the user is eligible for.
easyApplyNotSeenCount	Int	Number of "Easy Apply" scholarships the user has not yet viewed.
eligibleAmount	Float	The total potential award amount from all eligible scholarships.
eligibleCount	Int	Total number of scholarships the user is eligible for.
eligibleNotSeenCount	Int	Number of eligible scholarships the user has not yet viewed.
ignoredCount	Int	Number of scholarships the user has chosen to ignore.
recommendedAppliedCount	Int	Number of recommended scholarships the user has applied to.
recommendedCount	Int	Number of scholarships recommended for the user.
recommendedNotSeenCount ⚠️	Int	Number of recommended scholarships the user has not yet viewed. ⚠️ DEPRECATED Use recommendedAppliedCount instead. This field was misleadingly named - the badge shows applied count, not unseen count.
savedCount	Int	Number of scholarships the user has saved.
startedCount	Int	Number of applications the user has started but not yet submitted.

ScholarshipViewer

Field	Argument	Type	Description
allMandatoryRequirementsCompleted		Boolean
application		Application
applicationPreviewData		ApplicationPreviewData
favoriteAt		DateTime
hasApplication		Boolean!
hasSubmitted		Boolean!
ignoredAt		DateTime
isEligible		Boolean!
isFavorite		Boolean!
isIgnored		Boolean!
isRecommended		Boolean!
isSaved		Boolean!
reportedAt		DateTime
requirementMap		[RequirementMapEntry!]!
requirementProgress		RequirementStats
scholarshipId		ID!

ScholarshipsMutations

Namespaced mutation surface for modifying scholarship-related data and applications.

Field	Type	Description
apply	Boolean!	Initializes an application for a scholarship.
scholarshipId	ID!
subSource	String
deleteApplicationRequirement	Boolean!	Removes a previously submitted response for a requirement.
id	ID!
type	RequirementTypeEnum!
generateEssay	EssayGenerationResult!	Uses AI to generate an initial draft for a text/essay requirement based on a topic.
input	GenerateEssayInput!
generateEssayDiff	EssayDiffResult!	Computes a word-level diff between AI-generated text and user-edited text. Returns HTML with inline styles highlighting additions and removals.
input	GenerateEssayDiffInput!
markSeen	Boolean!	Marks a list of scholarships as "seen" by the user to update unread counters.
scholarshipIds	[ID!]!
quickApply	QuickApplyPayload!	Performs a "Quick Apply" operation using a previously saved requirement response.
input	QuickApplyInput!
report	Boolean!	Reports a scholarship for a specific reason with optional details.
details	String
id	ID!
reason	ReportReason!
reportWithOption	Boolean!	Reports a scholarship using a predefined option ID from `reportOptions`.
details	String
optionId	ID!
scholarshipId	ID!
submitApplicationRequirement	ApplicationRequirement!	Saves or updates a response for a specific scholarship requirement (e.g., uploading an essay).
input	ApplicationRequirementInput!
updateStatus	Boolean!	Updates the user's status for a scholarship (e.g., Save, Ignore).
action	ScholarshipAction!
scholarshipId	ID!
upsertEssayPersonalizationAnswer	UpsertEssayPersonalizationAnswerPayload!	Saves or updates a student's answer to an essay personalization question. Uses upsert semantics: creates if not exists, updates if it does.
input	UpsertEssayPersonalizationAnswerInput!

ScholarshipsQuery

Namespaced query surface for all scholarship-related operations.

Field	Type	Description
automaticScholarships	[AutomaticScholarship!]!	Retrieves a list of scholarships that are automatically applied for on behalf of the user.
byId	Scholarship	Retrieves detailed information for a single scholarship by its ID.
id	ID!
list	ScholarshipConnection!	Searches and lists scholarships based on filters, pagination, and sorting. This is the primary way to discover opportunities.
filters	ScholarshipFilters
pagination	PaginationInput
sort	[SortInput!]
reportOptions	[ReportScholarshipOption!]!	Retrieves a list of valid reasons/options for reporting a scholarship.
winners	WinnerConnection!	Retrieves a paginated list of scholarship winners.
input	WinnersInput

SchoolLevel

Educational levels available for user selection.

Field	Argument	Type	Description
description		String
id		ID!
isActive		Boolean!
name		String!
order		Int
value		String!

SetPasswordResult

The result of a password setup operation.

Field	Type	Description
account	Account	The updated account object.
message	String	A status or error message.
success	Boolean!	Whether the password was successfully set.

SocialAccount

A link between a platform account and a third-party social profile.

Field	Type	Description
connectedAt	DateTime!	When the social account was first connected.
email	String	The email address associated with the social profile.
id	ID!	Unique identifier for the social link.
name	String	The name displayed on the social profile.
provider	SocialProvider!	The social identity provider.
providerId	String!	The external ID provided by the social platform.

StateConnection

A paginated collection of state options.

Field	Argument	Type	Description
edges		[StateEdge!]!
pageInfo		PageInfo!
totalCount		Int!

StateEdge

Field	Argument	Type	Description
cursor		String!
node		DictionaryState!

SuccessResponse

A generic response structure for simple success/failure operations.

Field	Type	Description
data	JSON	Optional result data associated with the operation.
message	String	An optional status or informational message.
success	Boolean!	Whether the operation was successful.

SurveyQuestion

A single question within a survey requirement.

Field	Type	Description
id	String!	Unique identifier for the question.
options	[SurveyQuestionOption!]	A list of predefined options for selection-based questions.
required	Boolean!	Whether an answer is mandatory for this specific question.
text	String!	The text of the question.
type	SurveyQuestionType!	The type of input expected for the answer (e.g., RADIO, CHECKBOX).

SurveyQuestionOption

A predefined option for a selection-based survey question.

Field	Argument	Type	Description
label		String!	The human-readable label displayed to the student.
value		String!	The machine-readable value of the option.

UpsertEssayPersonalizationAnswerPayload

Payload returned after upserting an essay personalization answer.

Field	Argument	Type	Description
answer		PersonalizationAnswer!

UserCreationResult

The result of a user registration attempt.

Field	Type	Description
eligibleScholarshipsCount	Int!	The number of scholarships the user is already eligible for based on their registration data.
errors	[UserError!]	A list of validation or processing errors that occurred.
expiresAt	DateTime	The expiration timestamp for the authentication token.
nextRecommendedActions	[RecommendedAction!]!	Suggested steps for the user to take after registration (e.g., "Verify Email").
profileProgress	ProfileProgress!	An assessment of how much of the user's profile is complete.
sessionAuthentication	Boolean	Internal flag indicating if the session was automatically authenticated.
success	Boolean!	Whether the user account was successfully created.
token	String	Authentication token for the new user session.
user	Account	The newly created account details.
warnings	[String!]	Informational warnings that did not prevent account creation.

UserError

Detailed information about a validation or processing error.

Field	Type	Description
code	String	A stable error code for programmatic handling.
field	String	The name of the input field associated with the error, if any.
message	String!	A human-readable error message.

UserUpdateResult

The result of an account update operation.

Field	Type	Description
errors	[UserError!]	A list of validation or processing errors.
profileProgress	ProfileProgress	The updated assessment of profile completion.
success	Boolean!	Whether the update was successful.
updatedFields	[String!]	A list of field names that were successfully updated.
user	Account	The updated account details.

Viewer

The calling context (viewer) for the current request. This namespace groups all operations and data related to the currently authenticated user.

Field	Type	Description
account	Account	The current authenticated user account and profile. Returns null if the request is not authenticated.
applications	ApplicationConnection!	A list of scholarship applications submitted by or in-progress for the current user.
filters	ApplicationFilters
pagination	PaginationInput
sort	ApplicationSort
onboarding	ViewerOnboarding!	Status and management of the onboarding process for the current user.
stats	ViewerStats!	Aggregated statistics and counters for the current user's activity.

ViewerMutations

Mutations specific to the currently authenticated user's profile and session.

Field	Type	Description
onboarding	ViewerOnboardingMutations!	Operations related to the user's onboarding process.
postEligibility	PostEligibilityResult!	Perform a quick eligibility assessment without requiring a full account. Used in landing pages and marketing funnels.
input	PostEligibilityInput!
updateUser	UserUpdateResult!	Updates the profile and account settings for the currently authenticated user.
input	UpdateUserInput!

ViewerOnboarding

Management of the user's initial setup and onboarding experience.

Field	Type	Description
plugins	[OnboardingPlugin!]!	A list of available third-party offers or integrations (plugins) the user can engage with.
registrationCompletedAt	DateTime	The timestamp when the user completed their initial registration.
registrationProgress	RegistrationProgress!	Progress tracking for the multi-step registration flow.
registrationSource	RegistrationSource	The channel or campaign through which the user first joined.

ViewerOnboardingMutations

Mutations for managing onboarding state and plugin interactions.

Field	Argument	Type	Description
submitPlugins		[OnboardingPluginSubmissionResult!]!	Submits user choices or data for one or more onboarding plugins.
input		[OnboardingPluginSubmissionInput!]!

ViewerStats

Aggregated statistics for the current authenticated user.

Field	Argument	Type	Description
applicationStrategyHealth		ApplicationStrategyHealth!	Health and strategy assessment of the user's scholarship applications.
scholarships		ScholarshipStats!	Summary of scholarship-related metrics (e.g., number of eligible, saved, or new scholarships).

Winner

Information about a student who won a scholarship.

Field	Argument	Type	Description
amountWon		String
id		ID!
major		String
name		String
photoUrl		String
scholarship		Scholarship
scholarshipTitle		String
school		String
story		String
testimonialText		String
testimonialVideo		String
winnerPhoto		String
wonAt		String
year		Int

WinnerConnection

A paginated collection of scholarship winners.

Field	Argument	Type	Description
nodes		[Winner!]!
pageInfo		PageInfo!
totalCount		Int!

ZipData

Geographic information associated with a specific zip code.

Field	Argument	Type	Description
city		String	The name of the city.
state		ZipState	The state the zip code belongs to.

ZipState

Details of a geographic state linked to a zip code.

Field	Type	Description
abbreviation	String!	The standard two-letter state abbreviation.
id	ID!	Unique identifier for the state.
name	String!	The full name of the state.

Inputs

AccountRegistrationInput

Comprehensive input for account registration, including profile details.

Field	Type	Description
address	AddressInput
careerGoal	CareerGoalType
citizenship	CitizenshipStatus
dateOfBirth	DateTime
education	EducationInput!
email	String!
ethnicity	EthnicityType
firstName	String!
lastName	String!
militaryAffiliation	MilitaryAffiliationType
phone	String
socialProvider	SocialProvider	The social identity provider used for registration.
socialToken	String	The authentication token from the social provider.

AccountUpdateInput

Input for updating the current user's profile and account settings.

Field		Type	Description
address		AddressInput
careerGoal		CareerGoalType
citizenship		CitizenshipStatus
dateOfBirth		DateTime
education		EducationInput!
ethnicity		EthnicityType
firstName		String
lastName		String
militaryAffiliation		MilitaryAffiliationType
phone		String

AddressInput

Physical address details.

Field		Type	Description
addressLine1		String
city		String
state		State
zip		String

ApplicationFileInput

Input for creating or updating a file upload response.

Field		Type	Description
fileBase64		String!
fileName		String!
id		ID
requirementId		ID!
scholarshipId		ID!

ApplicationFilters

Filtering options for querying scholarship applications.

Field	Type	Description
derivedStatus	[DerivedApplicationStatus!]	Filter by one or more derived application statuses (the detailed post-submission status).
scholarshipId	ID	Filter by a specific scholarship ID.
status	[ApplicationStatus!]	Filter by one or more application statuses.
submittedAfter	DateTime	Filter applications submitted after this date.
submittedBefore	DateTime	Filter applications submitted before this date.

ApplicationGoalInput

Input for creating or updating a goal selection response.

Field		Type	Description
description		String
id		ID
requirementId		ID!
scholarshipId		ID!

ApplicationImageInput

Input for creating or updating an image upload response.

Field		Type	Description
fileBase64		String!
fileName		String!
id		ID
requirementId		ID!
scholarshipId		ID!

ApplicationInputInput

Input for creating or updating a simple input requirement response.

Field		Type	Description
id		ID
requirementId		ID!
scholarshipId		ID!
text		String!

ApplicationRequirementInput

Unified input for submitting or updating any type of requirement response. Ensure only the fields relevant to the type are provided.

Field	Type	Description
accountFileId	ID	ID of an already uploaded file to reuse for this response.
aiGeneratedText	String	The original AI-generated essay text, used to compute similarity scores when the user edits an AI-generated essay. Only relevant for TEXT types. When provided, the server computes cosine/jaccard/levenshtein similarity between this text and the submitted text, storing the result in extra.aiSimilarity.
answers	JSON	Answer set for SURVEY types, provided as a JSON object mapping question IDs to values.
fileBase64	String	Base64-encoded file content for FILE and IMAGE types.
fileName	String	Name of the file being uploaded for FILE and IMAGE types.
goalValue	String	Selection value for GOAL types.
id	ID	The ID of the existing response if performing an update.
requirementId	ID!	The ID of the requirement definition being fulfilled.
scholarshipId	ID!	The ID of the scholarship the requirement belongs to.
source	String	Attribution source for TEXT types (e.g. "search", "recommended").
specialEligibilityValue	String	Verification value for SPECIAL_ELIGIBILITY types.
text	String	Written content for TEXT and INPUT types.
type	RequirementTypeEnum!	The type of requirement being submitted.

ApplicationSort

Field		Type	Description
direction		SortDirection!
field		ApplicationSortField!

ApplicationSpecialEligibilityInput

Input for creating or updating a special eligibility response.

Field		Type	Description
id		ID
requirementId		ID!
scholarshipId		ID!
specialEligibilityValue		String!

ApplicationSurveyInput

Input for creating or updating a survey requirement response.

Field		Type	Description
answers		JSON!
id		ID
requirementId		ID!
scholarshipId		ID!

ApplicationTextInput

Input for creating or updating a text-based requirement response. (Consider using the unified ApplicationRequirementInput instead).

Field		Type	Description
accountFileId		ID
extra		JSON
fileBase64		String
fileName		String
id		ID
requirementId		ID!
scholarshipId		ID!
text		String

BillingSubscriptionCancellationSurveyInput

Input for submitting a subscription cancellation reason.

Field	Type	Description
details	String	Additional details or feedback from the user.
optionId	ID!	The ID of the selected cancellation reason option.
subscriptionId	ID!	The ID of the subscription being canceled.

ConnectSocialAccountInput

Input for linking a third-party social account.

Field	Type	Description
profile	JSON	Optional profile information from the provider.
provider	String!	The social provider name (e.g., "google").
token	String!	The identity token from the provider.

CreateUserInput

Comprehensive input for creating a new user, typically used in a registration flow.

Field	Type	Description
address	UserAddressInput	Physical mailing address.
autoApplyConsent	Boolean	Indicates whether the user consents to being automatically applied for certain scholarships.
careerGoal	CareerGoalType
citizenship	CitizenshipStatus
dateOfBirth	DateTime
education	RegistrationEducationInput	Initial education details.
email	String!	The unique email address for the new account.
ethnicity	EthnicityType
firstName	String
gender	String	User's gender identity.
lastName	String
militaryAffiliation	MilitaryAffiliationType
password	String	The account password.
phone	String
registrationSource	String	Internal identifier for the registration channel or campaign.
utmParams	JSON	Marketing tracking parameters (e.g., utm_source, utm_medium).

DateRangeInput

Input for filtering results within a specific date and time range.

Field		Type	Description
from		DateTime	The start of the range (inclusive).
to		DateTime	The end of the range (inclusive).

DictionaryFilters

Filtering options for dictionary queries.

Field	Type	Description
category	String	Filter items by a specific category.
country	String	Filter items by country code.
isActive	Boolean	Whether to return only active items.
search	String	Search term to match against names or descriptions.
state	String	Filter items by state code.

EducationInput

Education history entry.

Field	Type	Description
collegeAddress	String	The address of the college or university.
collegeGraduationMonth	Int	The month of college graduation or expected graduation.
collegeGraduationYear	Int	The year of college graduation or expected graduation.
collegeName	String	The name of university.
degree	DegreeField	The degree or qualification pursued or earned.
degreeType	DegreeTypeEnum	Broad types of academic degrees.
enrolled	Boolean	Whether the user is currently enrolled in college.
fieldOfStudy	String	The primary area of study.
gpa	Float	The Grade Point Average (GPA) achieved.
highSchoolAddress	String	The address of the high school.
highSchoolGraduationMonth	Int	The month of high shool graduation or expected graduation.
highSchoolGraduationYear	Int	The year of high school graduation or expected graduation.
highSchoolName	String	The name of the high shool educational institution.
schoolLevel	SchoolLevelType	The level of education (e.g., "High school freshman, "College 4th year").

ExchangeCookieInput

Input for exchanging a legacy session cookie for a JWT token.

Field		Type	Description
cookie		String!	The legacy session cookie (e.g., "sowl=eyJ...").

FloatRangeFilter

Field		Type	Description
max		Float
min		Float

GenerateEssayDiffInput

Input parameters for computing an essay diff.

Field		Type	Description
aiGeneratedText		String!
userEditedText		String!

GenerateEssayInput

Input parameters for AI essay generation.

Field	Type	Description
essayTopicId	ID	The ID of the EssayTopic entity (used to fetch personalization Q&A).
requirementId	ID!
topic	String	The essay topic text (used for essay generation prompt).
userInput	String

GoogleAuthInput

Input for authenticating via Google OAuth.

Field	Type	Description
action	GoogleAuthAction!	The action being performed (LOGIN or SIGNUP).
code	String!	The authorization code returned by the Google identity provider.
redirectUri	String!	The URI Google should redirect to after authentication.
remember	Boolean	Whether to extend the session duration.

IntRangeFilter

Field		Type	Description
max		Int
min		Int

LoginInput

Input for authenticating with email and password.

Field	Type	Description
email	String!
password	String!
remember	Boolean	Whether to extend the session duration.

OnboardingPluginSubmissionInput

Input for submitting data for an onboarding plugin.

Field		Type	Description
extra		JSON	The user-provided data or selections for the plugin.
id		ID!	The ID of the plugin being submitted.

PaginationInput

Input for cursor-based forward pagination.

Field		Type	Description
after		String	The cursor after which to start returning results.
first		Int	The number of items to return in the page (defaults to 20).

PasswordChangeInput

Input for changing the current user's password.

Field	Type	Description
currentPassword	String!	The user's current password.
newPassword	String!	The new password to set.
retypePassword	String!	Confirmation of the new password.

PasswordResetInput

Input for requesting a password reset email.

Field		Type	Description
email		String!	The email address associated with the account.

PostEligibilityInput

Input for a lightweight eligibility check, typically used before full registration.

Field		Type	Description
degreeType		String!	The type of degree the user is pursuing or planning to pursue.
dob		String!	The user's date of birth string.

ProfileUpdateInput

Input for updating general profile information.

Field		Type	Description
address		AddressInput
careerGoal		String
dateOfBirth		DateTime
education		EducationInput!
ethnicity		String
firstName		String
lastName		String
militaryAffiliation		String
phone		String

QuickApplyInput

Input parameters for performing a Quick Apply.

Field		Type	Description
answerId		String!
scholarshipId		ID!

RegisterAccountInput

Input for registering a basic account.

Field		Type	Description
email		String!
firstName		String!
lastName		String!
password		String!

RegistrationEducationInput

Education details collected during or after registration.

Field	Type	Description
collegeAddress	String	The address of the college or university.
collegeGraduationMonth	Int	The month of college graduation or expected graduation.
collegeGraduationYear	Int	The year of college graduation or expected graduation.
collegeName	String	The name of university.
degree	DegreeField	The degree or qualification pursued or earned.
degreeType	DegreeTypeEnum	Broad types of academic degrees.
enrolled	Boolean	Whether the user is currently enrolled in college.
enrollmentMonth	Int	The month of college enrollment.
enrollmentYear	Int	The year of college enrollment.
fieldOfStudy	String	The primary area of study.
gpa	Float	The Grade Point Average (GPA) achieved.
highSchoolAddress	String	The address of the high school.
highSchoolGraduationMonth	Int	The month of high shool graduation or expected graduation.
highSchoolGraduationYear	Int	The year of high school graduation or expected graduation.
highSchoolName	String	The name of the high shool educational institution.
schoolLevel	SchoolLevelType	The level of education (e.g., "High school freshman, "College 4th year").

RequirementTypeFilter

Field		Type	Description
mode		RequirementFilterMode!	Whether to include or exclude scholarships with these types
types		[RequirementTypeEnum!]!	List of requirement types to filter by

ResetPasswordInput

Input for resetting a password using a verification token.

Field	Type	Description
email	String!	The user's email address.
password	String!	The new password to set.
retypePassword	String!	Confirmation of the new password.
token	String!	The verification token received via email.

ScholarshipFilters

Field		Type	Description
age		IntRangeFilter
categories		[String!]
credibilityLevel		[CredibilityLevel!]
deadlineAfter		DateTime
deadlineBefore		DateTime
degree		[String!]
ethnicity		[String!]
expirationAfter		DateTime
expirationBefore		DateTime
fieldOfStudy		[String!]
gender		[String!]
gpa		FloatRangeFilter
hasApplication		Boolean
isActive		Boolean
isEasy		Boolean
isEligible		Boolean
isFavorite		Boolean
isIgnored		Boolean
isRecommended		Boolean
isReported		Boolean
isSaved		Boolean
isStarted		Boolean
isSubmitted		Boolean
maxAmount		Float
maxApplicants		Int
maxRequirements		Int
militaryAffiliation		[String!]
minAmount		Float
minApplicants		Int
minCredibilityScore		Float
organizationId		[ID!]
payoutMethodId		[ID!]
requirementTypes		RequirementTypeFilter
schoolLevel		[String!]
search		String
state		[String!]
status		[ScholarshipStatus!]

ScholarshipSort

Field		Type	Description
direction		SortDirection!
field		ScholarshipSortField!

SearchInput

Input for performing text search operations.

Field	Type	Description
fields	[String!]	Optional list of specific fields to search within.
fuzzy	Boolean	Whether to use fuzzy matching for the search query.
query	String!	The search query string.

SetPasswordInput

Input for setting a password on an existing account (e.g., during multi-step registration).

Field		Type	Description
accountId		ID!	The ID of the account to update.
password		String!	The new password.

SocialLoginInput

Input for authenticating via a social provider.

Field		Type	Description
provider		SocialProvider!	The social provider (e.g., GOOGLE, FACEBOOK).
token		String!	The identity token provided by the social platform.

SortInput

Input for sorting a list of results.

Field		Type	Description
direction		SortDirection!	The direction in which to sort (ASC or DESC).
field		String!	The name of the field to sort by.

UpdateUserInput

Input for updating the profile fields of the current user.

Field	Type	Description
address	UserAddressInput
autoApplyConsent	Boolean
careerGoal	CareerGoalType
citizenship	CitizenshipStatus
currentPassword	String	The user's current password, required for sensitive changes like updating email or password.
dateOfBirth	DateTime
education	RegistrationEducationInput
email	String
ethnicity	EthnicityType
firstName	String
gender	String
lastName	String
militaryAffiliation	MilitaryAffiliationType
newPassword	String	The new password to set.
password	String	Updates the account password.
passwordConfirmation	String	Verification of the new password.
phone	String

UpsertEssayPersonalizationAnswerInput

Input for upserting an essay personalization answer.

Field		Type	Description
answer		String
questionId		ID!
skipped		Boolean!

UserAddressInput

Physical address details for a user.

Field		Type	Description
addressLine1		String
city		String
state		State
zip		String

WinnersInput

Input for querying scholarship winners.

Field		Type	Description
externalScholarshipTemplateId		String
pagination		PaginationInput
sort		String

Enums

ApplicationSortField

Value	Description
AMOUNT
DATE_APPLIED
DEADLINE
STATUS_UPDATED_AT

ApplicationStatus

Value	Description
INCOMPLETE
IN_PROGRESS
READY_TO_SUBMIT
SUBMITTED

CapUrgency

Value	Description
critical
safe
warning

CareerGoalType

Enum for user career goals.

Value	Description
ART_DESIGN_FASHION
BEAUTY_COSMETOLOGY
BUSINESS_MARKETING_MANAGEMENT
COMPUTERS_IT_TECHNOLOGY
CULINARY_ARTS
HEALTH_CARE_NURSING
LAW_CRIMINAL_JUSTICE
OTHER
TEACHING_EDUCATION
VOCATIONAL_TECHNICAL

CitizenshipStatus

Enum for user citizenship status.

Value	Description
US_CITIZEN
US_PERMANENT_RESIDENT
US_TEMPORARY_RESIDENT

CredibilityLevel

Value	Description
HIGH
LOW
MEDIUM
VERIFIED

DegreeField

Enum for specific academic fields/degrees.

Value	Description
AGRICULTURE
ARCHITECTURE
AREA_ETHNIC_CULTURAL_GENDER_STUDIES
BIOLOGICAL_BIOMEDICAL_SCIENCES
BUSINESS_MANAGEMENT_MARKETING
COMMUNICATION_JOURNALISM
COMPUTER_INFORMATION_SCIENCES
CONSTRUCTION_TRADES
EDUCATION
ENGINEERING
ENGLISH_LANGUAGE_LITERATURE
FAMILY_CONSUMER_SCIENCES
FOREIGN_LANGUAGES_LITERATURE_LINGUISTICS
HEALTH_PROFESSIONS_CLINICAL_SCIENCES
HISTORY
LEGAL_PROFESSIONS_LAW_STUDIES
LIBERAL_ARTS_GENERAL_STUDIES
LIBRARY_SCIENCE
MATHEMATICS_STATISTICS
MECHANIC_REPAIR_TECH
MILITARY_TECHNOLOGIES
MULTI_INTERDISCIPLINARY_STUDIES
NATURAL_RESOURCES_CONSERVATION
OTHER
PARKS_RECREATION_FITNESS
PERSONAL_CULINARY_SERVICES
PHILOSOPHY_RELIGIOUS_STUDIES
PHYSICAL_SCIENCES
PRECISION_PRODUCTION
PSYCHOLOGY
PUBLIC_ADMINISTRATION_SOCIAL_SERVICE
SECURITY_PROTECTIVE_SERVICES
SOCIAL_SCIENCES
TECHNOLOGY_EDUCATION_INDUSTRIAL_ARTS
THEOLOGY_RELIGIOUS_VOCATIONS
TRANSPORTATION_MATERIALS_MOVING
VISUAL_PERFORMING_ARTS

DegreeTypeEnum

Enum for academic degree levels.

Value	Description
ASSOCIATES
BACHELORS
CERTIFICATE
DOCTORAL
GRADUATE_CERTIFICATE
MASTERS
UNDECIDED

DerivedApplicationStatus

Value	Description
AWARDED
CHOOSING_A_WINNER
DECLINED
DRAW_CLOSED
MISSED
NOT_SELECTED
REVIEWED
SENT
UNDER_REVIEW
WON

DictionaryType

The categories of dictionary data available on the platform.

Value	Description
CAREER_GOAL
CITIZENSHIP
DEGREE
DEGREE_TYPE
ETHNICITY
GENDER
HIGH_SCHOOL
MILITARY_AFFILIATION
SCHOOL_LEVEL
STATE

EligibilityOperator

Value	Description
BETWEEN
EQUALS
GREATER_THAN
GREATER_THAN_OR_EQUAL
IN
LESS_THAN
LESS_THAN_OR_EQUAL
NOT_IN

EligibilityType

Value	Description
AGE
CUSTOM
DEGREE
ETHNICITY
FIELD_OF_STUDY
GENDER
GPA
MILITARY_AFFILIATION
SCHOOL_LEVEL
STATE

EthnicityType

Enum for user ethnicity background.

Value	Description
AFRICAN_AMERICAN
AMERICAN_INDIAN_NATIVE_ALASKAN
ASIAN_PACIFIC_ISLANDER
CAUCASIAN
HISPANIC_LATINO
OTHER

GoogleAuthAction

The type of authentication action to perform via Google.

Value	Description
LOGIN	Authenticate an existing user.
SIGNUP	Register a new user.

MilitaryAffiliationType

Enum for military service status and affiliation.

Value	Description
ACTIVE_MILITARY_CHILD
ACTIVE_MILITARY_SPOUSE
AIR_FORCE
ARMY
CIVIL_AIR_PATROL
COAST_GUARD
DISABLED
DISABLED_CHILD
DISABLED_SPOUSE
DISMISSED
DISMISSED_CHILD
DISMISSED_SPOUSE
MARINES
MARINE_CORPS_LEAGUE
MEDAL_OF_HONOR_CHILD
MEDAL_OF_HONOR_RECIPIENT
MEDAL_OF_HONOR_SPOUSE
NATIONAL_GUARD
NAVY
NONE
RESERVE
RESERVE_CHILD
RESERVE_SPOUSE
RETIRED
RETIRED_CHILD
RETIRED_SPOUSE
VETERAN
VETERAN_CHILD
VETERAN_SPOUSE

PayoutMethod

Value	Description
COLLEGE
NON_MONETARY_AWARDS
NOT_STATED
STUDENT

RegistrationSource

The original source or channel through which a user registered.

Value	Description
DIRECT	Registered directly via the platform's signup form.
INVITATION	Registered via an invitation from another user.
SOCIAL_LOGIN	Registered using a social media account.
THIRD_PARTY	Registered through an external partner or integration.

ReportReason

The primary reason for reporting a scholarship listing.

Value	Description
BROKEN_LINK
INAPPROPRIATE
MISLEADING
OTHER
SPAM

RequirementFilterMode

Value	Description
EXCLUDE	Exclude scholarships that have any of these requirement types
INCLUDE	Include scholarships that have any of these requirement types

RequirementTypeEnum

The available types of scholarship requirements.

Value	Description
FILE	A general file upload (e.g., PDF, DOCX).
GOAL	Selection of educational or career goals.
IMAGE	An image file upload (e.g., JPG, PNG).
INPUT	A single text input field.
SPECIAL_ELIGIBILITY	Special criteria that must be confirmed by the student.
SURVEY	A set of survey questions.
TEXT	A written response or essay.

ScholarshipAction

Scholarship action enum for status updates

Value	Description
FAVORITE
IGNORE
SAVE
UNFAVORITE
UNIGNORE
UNSAVE

ScholarshipSortField

Value	Description
AMOUNT
APPLICATION_COUNT
CREATED_AT
CREDIBILITY_SCORE
DEADLINE
DEFAULT_PRIORITY
RELEVANCE
REQUIREMENT_COUNT
TITLE
UPDATED_AT

ScholarshipStatus

Value	Description
CANCELED
CANCELED_AND_EXPIRED
EXPIRED
PUBLISHED
UNPROCESSABLE
UNPUBLISHED

SchoolLevelType

Enum for educational levels.

Value	Description
ADULT_NON_TRADITIONAL
COLLEGE_1ST_YEAR
COLLEGE_2ND_YEAR
COLLEGE_3RD_YEAR
COLLEGE_4TH_YEAR
GRADUATE_STUDENT
HIGH_SCHOOL_FRESHMAN
HIGH_SCHOOL_JUNIOR
HIGH_SCHOOL_SENIOR
HIGH_SCHOOL_SOPHOMORE

SchoolType

The type of educational institution.

Value	Description
COLLEGE
HIGH_SCHOOL
UNIVERSITY

SocialProvider

Available third-party identity providers for social authentication.

Value	Description
APPLE
FACEBOOK
GOOGLE
LINKEDIN

SortDirection

The direction of a sort operation.

Value	Description
ASC	Ascending order (e.g., A-Z, 0-9).
DESC	Descending order (e.g., Z-A, 9-0).

State

Enum for US states and territories (for address state field).

Value	Description
ALABAMA
ALASKA
AMERICAN_SAMOA
ARIZONA
ARKANSAS
ARMED_FORCES_AMERICA
ARMED_FORCES_EUROPE
ARMED_FORCES_PACIFIC
CALIFORNIA
COLORADO
COMMONWEALTH_OF_THE_NORTHERN_MARIANA_ISLANDS
CONNECTICUT
DELAWARE
DISTRICT_OF_COLUMBIA
FLORIDA
GEORGIA
GUAM
HAWAII
IDAHO
ILLINOIS
INDIANA
IOWA
KANSAS
KENTUCKY
LOUISIANA
MAINE
MARYLAND
MASSACHUSETTS
MICHIGAN
MINNESOTA
MISSISSIPPI
MISSOURI
MONTANA
NEBRASKA
NEVADA
NEW_HAMPSHIRE
NEW_JERSEY
NEW_MEXICO
NEW_YORK
NORTH_CAROLINA
NORTH_DAKOTA
OHIO
OKLAHOMA
OREGON
PENNSYLVANIA
PUERTO_RICO
RHODE_ISLAND
SOUTH_CAROLINA
SOUTH_DAKOTA
TENNESSEE
TEXAS
US_VIRGIN_ISLANDS
UTAH
VERMONT
VIRGINIA
WASHINGTON
WEST_VIRGINIA
WISCONSIN
WYOMING

StrategyHealthState

Value	Description
CALIBRATION
SCORED

StrategyHealthZone

Value	Description
BLUE
GREEN
RED

SurveyQuestionType

Input types for survey questions.

Value	Description
CHECKBOX	Multiple-choice selection using checkboxes.
RADIO	Single-choice selection using radio buttons.
SELECT	Single-choice selection using a dropdown menu.
TEXT	A single-line text input.
TEXTAREA	Multi-line text input for longer responses.

Scalars

Boolean

The Boolean scalar type represents true or false.

DateTime

The DateTime scalar type represents a Date and Time string in ISO 8601 format (e.g., "2023-12-25T12:00:00Z").

Float

The Float scalar type represents signed double-precision fractional values as specified by IEEE 754.

ID

The ID scalar type represents a unique identifier, often used to refetch an object or as key for a cache. The ID type appears in a JSON response as a String; however, it is not intended to be human-readable. When expected as an input type, any string (such as "4") or integer (such as 4) input value will be accepted as an ID.

Int

The Int scalar type represents non-fractional signed whole numeric values. Int can represent values between -(2^31) and 2^31 - 1.

JSON

The JSON scalar type represents a JSON-compatible structure (object, array, string, number, or boolean).

String

The String scalar type represents textual data, represented as UTF-8 character sequences. The String type is most often used by GraphQL to represent free-form human-readable text.

Upload

The Upload scalar type represents a file upload in a multi-part request.

Interfaces

ApplicationRequirement

Base interface for all student responses to scholarship requirements. These objects store the actual content or files provided by the student.

Field	Type	Description
createdAt	DateTime!	When the response was first created.
id	ID!	Unique identifier for the response.
source	String	The source of the response (e.g., manual entry, AI generated).
updatedAt	DateTime	When the response was last updated.

Possible Types: ApplicationFile, ApplicationGoal, ApplicationImage, ApplicationInput, ApplicationSpecialEligibility, ApplicationSurvey, ApplicationText

Requirement

Base interface for all scholarship requirements. Requirements define what a student must provide (e.g., an essay, a file, a survey) to apply for a scholarship.

Field	Type	Description
createdAt	DateTime!	Timestamp when the requirement was created.
description	String	Instructions or description for the student on how to fulfill the requirement.
id	ID!	Unique identifier for the requirement.
isOptional	Boolean!	Whether this requirement is optional or mandatory for application submission.
name	String!	Internal name for the requirement.
permanentTag	String	Stable identifier used for categorization and automated processing.
title	String	Public-facing title of the requirement (e.g., "Personal Statement").
type	RequirementTypeEnum!	The category of the requirement (e.g., TEXT, FILE, SURVEY).
updatedAt	DateTime	Timestamp when the requirement was last updated.

Possible Types: RequirementFile, RequirementGoal, RequirementImage, RequirementInput, RequirementSpecialEligibility, RequirementSurvey, RequirementText

Schema Types ​

Query ​

Mutation ​

Objects ​

Account ​

AccountFile ​

Address ​

AllDictionaries ​

Application ​

ApplicationConnection ​

ApplicationFile ​

ApplicationGoal ​

ApplicationImage ​

ApplicationInput ​

ApplicationPreviewApplicationData ​

ApplicationPreviewData ​

ApplicationPreviewField ​

ApplicationSpecialEligibility ​

ApplicationStrategyHealth ​

ApplicationSurvey ​

ApplicationText ​

AuthMutations ​

AuthResponse ​

AutomaticScholarship ​

BillingMutations ​

BillingPackage ​

BillingPaymentPopupDetails ​

BillingQuery ​

BillingSpecialOfferPage ​

BillingSpecialOfferPageConnection ​

BrandIdentity ​

BrandSocials ​

CareerGoal ​

CategoryStats ​

CoregApplication ​

Degree ​

DegreeType ​

DictionaryItem ​

DictionaryState ​

Document ​

Education ​

Eligibility ​

EligibilityField ​

EnumDisplayItem ​

EssayDiffResult ​

EssayGenerationResult ​

EssayTopic ​

Ethnicity ​

EthnicityConnection ​

EthnicityEdge ​

GraphQLError ​

HighSchool ​

HighSchoolConnection ​

HighSchoolEdge ​

IpData ​

Membership ​

OnboardingPlugin ​

OnboardingPluginSubmissionResult ​

Organization ​

Package ​

PageInfo ​

PersonalizationAnswer ​

PersonalizationQuestion ​

PostEligibilityResult ​

ProfileCompletion ​

ProfileProgress ​

ProviderStats ​

QuickApplyPayload ​

RecommendedAction ​

ReferencesQuery ​

RegistrationProgress ​

ReportScholarshipOption ​

RequirementFile ​

RequirementGoal ​

RequirementImage ​

RequirementInput ​

RequirementMapEntry ​

RequirementSpecialEligibility ​

RequirementStats ​

RequirementSurvey ​