> ## Documentation Index > Fetch the complete documentation index at: https://hc.starbridge.ai/llms.txt > Use this file to discover all available pages before exploring further. # Get Buyer Attribute > Retrieve a single structured attribute about a buyer (institution) by its key, as defined in the BuyerField enum. Buyers include cities, counties, higher-education institutions, school districts, police and fire departments, federal agencies, and other public-sector entities. See the `buyerAttribute` parameter for the full list of available keys and what each one returns. If you need more than one attribute for the same buyer, use the bulk endpoint `getBuyerAttributesBulk` instead. It returns multiple attributes in a single request, saving you from making separate calls for each one. ## OpenAPI ````yaml https://core-http2-157602306522.us-central1.run.app/external/public/swagger/documentation.yaml get /api/external/buyer/{buyerId}/attribute/{buyerAttribute} openapi: 3.1.1 info: title: Starbridge External Public API version: '1.0' servers: - url: https://dashboard.starbridge.ai security: [] paths: /api/external/buyer/{buyerId}/attribute/{buyerAttribute}: get: tags: - Buyer - External MCP - External API summary: Get Buyer Attribute description: >- Retrieve a single structured attribute about a buyer (institution) by its key, as defined in the BuyerField enum. Buyers include cities, counties, higher-education institutions, school districts, police and fire departments, federal agencies, and other public-sector entities. See the `buyerAttribute` parameter for the full list of available keys and what each one returns. If you need more than one attribute for the same buyer, use the bulk endpoint `getBuyerAttributesBulk` instead. It returns multiple attributes in a single request, saving you from making separate calls for each one. operationId: getBuyerAttribute parameters: - name: buyerId in: path required: true schema: type: string - name: buyerAttribute in: path description: >- The attribute key to retrieve. Must be one of the following BuyerField values: - `Id` (Buyer ID) — The unique Starbridge ID associated with a buyer. - `Name` (Buyer Name) — The name of the buyer. - `CommonName` (Buyer Common Name) — A buyer's common-use name or abbreviation, distinct from its full legal name. - `ParentName` (Buyer Parent Name) — The name of the parent buyer. - `ParentBuyerId` (Buyer Parent ID) — The unique Starbridge ID of the parent buyer. - `Type` (Buyer Type) — The type of buyer this is such as school district, higher ed, city, county, state agency, police, hospital or federal. - `Classifications` (Buyer Classifications) - `Url` (Buyer Homepage URL) — The website URL of the buyer. - `LinkedinSlug` (LinkedIn Slug) — The LinkedIn organization slug, e.g. "starbridge-ai" for https://www.linkedin.com/company/starbridge-ai. - `Zip` (Buyer Zip) — The zip code of the buyer. - `CountryCode` (Buyer Country Code) — The country code of the buyer such as US for United States or CA for Canada. - `StateCode` (Buyer State Code) — The state code of the buyer. - `StateName` (Buyer State Name) — The full state name of the buyer. - `City` (Buyer City) — The city of the buyer. - `County` (Buyer County) — The county of the buyer. - `Address` (Buyer Full Address) — The full address of the buyer. - `Street1` (Buyer Street1) — The primary street address of the buyer. - `Street2` (Buyer Street2) — The secondary street address of the buyer. - `MainPhoneNumber` (Buyer Phone Number) — The primary contact phone number for the buyer. - `EmailDomains` (Buyer Email Domains) - `Population` (Population) — Commonly used by sales teams in the government market to size and prioritize opportunities, since larger populations often correlate with bigger budgets and more complex procurement needs. It also helps tailor outreach by aligning messaging and product positioning to the scale of the community being served. - `BudgetAmount` (Operating Budget Amount) — The estimated amount of operating expenditures noted in the budget from a city, county, state agency or special district (not applicable for schools) in the latest year found. This is commonly used for account scoring: accounts with more budget are usually a larger focus. Note that while for most buyers we are able to extract the actual budget amount from their online budget document, for some buyers we create an estimated projection of their budget. There is another field called budget confidence which outlines whether the estimated budget amount was actual (pulled from a document) or inferred (an estimate). - `BudgetSbita` (Budget Subscription Based IT Spend) — The amount of actual subscription based IT expenditures noted in the budget from a city, county, state agency or special district (not applicable for schools). This field is commonly used for account scoring: accounts with more budget are usually a larger focus. - `BudgetUrl` (Budget URL) — The actual URL of a city, county or special district's most recent budget document. - `BudgetLatestYear` (Latest Budget Year) — The most recent year that a budget was published that Starbridge indexed. Ties to the budget operating expenditures amount field and sometimes provides in a CRM integration for richer context on the Starbridge budget amount. - `BudgetConfidence` (Budget Confidence) — Either verified (the budget was pulled from a document made available online) or inferred (an estimate based on population and other web sources). - `SchoolDistrictType` (School District Type) — Categorizes the school district based on its administrative structure, such as whether it is a regular local district, a component of a larger supervisory union, a charter district, or a state or federal education agency. - `HigherEdFullTimeEnrollment` (Higher Education Full Time Equivalent Enrollment) — The full-time equivalent enrollment of the higher education institution. - `HigherEdInstitutionType` (Higher Education Institution Type) — A list of Higher Ed institution types including: undergraduate universities, large research universities, liberal arts schools, online schools, business schools & medical schools. This is commonly used to score accounts (for example some companies may prefer to sell to medical schools) and tailor messaging. - `DepartmentName` (Department Name) — The specific name of the department. - `DepartmentCode` (Department Code) — A unique code assigned to a department. - `AgencyName` (Agency Name) — The name of the government agency. - `OfficeCodeArray` (Office Codes) - `AgencyCode` (Agency Code) — A unique code assigned to a government agency. - `AiAdoptionScore` (AI Adoption Score) — A ranking 1 (low AI adoption) to 100 (extremely aggressive AI adoption) of how much evidence there is that the agency/school is rapidly adopting AI based on meeting minutes, purchase data and news reports and webpages. - `AiAdoptionSummary` (AI Adoption Summary) — A plaintext description of how the buyer is adopting AI: including meeting minutes discussions, web articles and purchase data. - `StartupFriendlinessScore` (Startup Friendliness Score) — A ranking 1 (not startup friendly) to 100 (extremely startup friendly) of how often this government/school seems to be an early adopter or champions startups/startup adoption in public - `StartupFriendlinessSummary` (Startup Friendliness Summary) — A plaintext description of how often the buyer prefers to buy from startups: looking at meeting minutes discussions, web articles and purchase data. - `ProcurementHellScore` (Procurement Hell Score) — A ranking from 1 to 100 of how difficult a buyer's procurement process is with 1 being the easiest to navigate and 100 being the most difficult, slow procurement process. - `AngelProcurementSummary` (How to Navigate Procurement Summary) — A summary detailing how a company can navigate the procurement process of a buyer: looking at its procurement limit, sole source policies and usage of cooperatives and resellers. - `IpedsIdNumeric` (IPEDS ID) — The most common ID used in the Higher Education market to map accounts from external databases to a CRM. Sourced from the IPEDS official dataset. - `TotalEnrollment` (Total Enrollment) — The total enrollment of an institution or a school. - `NcesId` (NCES ID) — The most common ID used in the School District market to map accounts from external databases to a CRM. Sourced from the NCES official dataset from https://nces.ed.gov/ - `NcesStateDistrictId` (NCES State District ID) — The state-specific identifier for a school district, assigned by the NCES - `CensusIdPid6` (Census ID (PID6)) — A common ID used in the Government market to map accounts from external databases to a CRM. Sourced from the official Census.gov dataset. - `CensusIdGidId` (Census ID (GID)) — The most common ID used in the Government market to map accounts from external databases to a CRM. Sourced from the official Census.gov dataset. - `SgcId` (SGC ID) — Standard Geographical Classification (SGC) Code used for Canadian government entities. This is the primary ID used to map Canadian accounts from external databases to a CRM. - `HigherEdGraduationRate` (Higher Education Graduation Rate) — The graduation rate of the higher education institution. - `HigherEdRetentionRate` (Higher Education Retention Rate) — The retention rate of the higher education institution. - `HigherEdAcceptanceRate` (Higher Education Acceptance Rate) — The percentage of applicants offered admission at the higher education institution. - `HigherEdYieldRate` (Higher Education Yield Rate) — The percentage of admitted students who enroll at the higher education institution. - `HigherEdGraduationEnrollment` (Higher Education Graduate Enrollment) — The graduate enrollment of the higher education institution. - `HigherEdUndergradEnrollment` (Higher Education Undergrad Enrollment) — The undergraduate enrollment of the higher education institution. - `HigherEdOnlineOnlyEnrollment` (Higher Education Online Only Enrollment) — Enrollment of students enrolled exclusively in distance education programs at the higher education institution. - `HigherEdControlOfInstitution` (Higher Education Institution Control) — Whether the institution is public or private. - `HigherEdForProfitStatus` (Higher Education For Profit Status) — Whether the higher education institution is operated on a for-profit basis. - `HigherEdLevelOfInstitution` (Higher Education Institution Level) — Whether a degree is complete in less than two years, two years or four years. - `HigherEdRecruitmentAdmissionsCrmArray` (Higher Education Recruitment / Admissions CRM List) - `HigherEdEndowment` (Higher Education Endowment) — The endowment of the higher education institution. - `HigherEdMascot` (Mascot) — The name of the mascot. Often used to personalize emails: for example at UCLA, ending an email with Go Bruins! - `HigherEdNumberOfOnCampusResidents` (Higher Education Number of On-Campus Residents) — The number of on-campus residents at the higher education institution. - `HigherEdNumberOfFullTimeEmployees` (Higher Education Number of Full Time Employees) — The number of full-time employees at the higher education institution. - `HigherEdSisModernizationStatus` (Higher Education SIS Modernization Status) — The SIS modernization status of the higher education institution. - `HigherEdPrimaryRegionalAccreditor` (Higher Education Main Accreditor) — The institution's primary accreditor for institutional accreditation (institution-level only, excluding program accreditors). - `HigherEdAccreditationSummary` (Higher Education Accreditation Summary) — List of accreditation details across institutional and program accreditations, including accreditors and accreditation expiration dates. - `HigherEdAccreditationStatus` (Higher Education Accreditation Status) — The institution's accreditation status for institutional accreditation (institution-level only, excluding program accreditations). - `DapipId` (DAPIP ID) — The DAPIP identifier for the higher education institution. - `HigherEdNextAccreditationReviewDate` (Higher Education Accreditation Expiration Date) — The institution's accreditation expiration date for institutional accreditation (institution-level only, excluding program accreditations). - `HigherEdSystem` (Higher Education System) — Whether the institution is a Higher Education system that looks over a number of campuses: such as the City University of New York System or the University of California System. - `CommunityCollegeSystem` (Community College System) — Whether the institution is a Community College system that oversees multiple community college campuses. - `Sis` (SIS) — The student information system used by the buyer. - `LmsArray` (LMS List) - `SchoolDistrictLocale` (School District Locale) — The locale of the school district. - `SchoolDistrictFullTimeEquivalentTeachers` (School District Full Time Equivalent Teachers) — The full-time equivalent teachers in the school district. - `LowestGradeOffered` (Lowest Grade) — The lowest grade offered by the school or school district. Values: -1 = Pre-K, 0 = Kindergarten, 1-13 = grades. - `HighestGradeOffered` (Highest Grade) — The highest grade offered by the school or school district. Values: -1 = Pre-K, 0 = Kindergarten, 1-13 = grades. - `SchoolDistrictNumberOfSchools` (School District Number of Schools) — The number of schools in the school district. - `SchoolDistrictElementarySchools` (School District Elementary Schools) — The number of elementary schools in the school district. - `SchoolDistrictMiddleSchools` (School District Middle Schools) — The number of middle schools in the school district. - `SchoolDistrictHighSchools` (School District High Schools) — The number of high schools in the school district. - `SchoolDistrictTotalStaff` (School District Total Staff) — The total staff in the school district. - `SchoolDistrictMedianHouseholdIncome` (School District Median Household Income) — The median household income for the district. A value of 250000 means $250,000 or more. - `SchoolDistrictSector` (School District Sector) — Categorizes the school district as Public or Private. - `RegionalEducationServiceAgencyName` (Regional Education Service Agency Name) — The name of the regional education service agency that serves the school district. - `RegionalEducationServiceAgencyBuyerId` (Regional Education Service Agency Buyer ID) — The unique Starbridge buyer ID of the regional education service agency that serves the school district. - `SchoolManagementOrganizationName` (School Operator Name) — The name of the management organization that serves the school. Depending on the school type, this may be an Education Management Organization or a Charter Management Organization. - `SchoolManagementOrganizationBuyerId` (School Operator Buyer ID) — The unique Starbridge buyer ID of the management organization that serves the school. Depending on the school type, this may be an Education Management Organization or a Charter Management Organization. - `EnglishLearners` (English Learner %) — The percentage of English learners in the school or school district. - `BlackPercentage` (Black or African American Students %) — The percentage of students who identify as Black or African American in the school or school district. - `LatinoPercentage` (Latino or Hispanic Students %) — The percentage of students who identify as Latino or Hispanic in the school or school district. - `WhitePercentage` (White Students %) — Percentage of students who identify as White in the school or school district. - `StudentTeacherRatio` (Student-Teacher Ratio) — Average number of enrolled students per full-time equivalent teacher. - `SchoolSector` (School Sector) — Categorizes the school as Public, Private, or Charter. - `SchoolLevel` (School Level) — Categorizes the school by its educational level: Elementary, Middle, High School, or Other. - `AlternativeSchool` (Alternative School) — Identifies schools whose primary model is alternative or non-traditional, based on NCES school data. - `SchoolCurriculumProgramArray` (Curriculum Program List) - `ReligiousAffiliation` (Religious Affiliation) — The religious affiliation of the school or higher education institution. - `StudentGenderComposition` (Student Gender Composition) — The student gender composition of the school or higher education institution. - `SchoolVirtualStatus` (School Virtual Status) — Describes the operational model of the school or district (e.g., Exclusively virtual, No virtual instruction). - `Subentity` (Government Subentity) — A classification of a special district government entity based on its function and administrative level, including specific service-providing entities like transportation, utilities, and public safety. - `FiscalYearStartDate` (Buyer Fiscal Year Start Date) — The start date of the buyer's fiscal year. - `FreeOrReducedLunchEligiblePercentage` (Free & Reduced Lunch Eligible %) — A strong indicator of a school's or district’s socioeconomic demographics such as poverty, helping sales teams identify schools that may have more limited budgets or greater funding opportunities. - `FdId` (Fire Department ID (FDID)) — Fire Department Identification number - `FireDepartmentType` (Fire Department Type) — Categorizes the department based on its primary staffing model: 'Volunteer', 'Career', or 'Combination' (a mix of volunteer and career staff). - `FireDepartmentOrganizationType` (Fire Department Organization Type) — Defines the department's governing structure, such as 'Local', 'Federal', 'State', 'Tribal', or 'Private'. - `FireDepartmentPrimaryAgency` (Fire Department Primary Agency) — Indicates if the fire department is designated as the primary agency for emergency management within its jurisdiction. - `FireDepartmentNumberOfStations` (Fire Department Number of Stations) — The total number of fire stations operated by the department. - `FireDepartmentActiveFirefightersCareer` (Fire Department Active Firefighters - Career) — The number of active, full-time paid (career) firefighters employed by the department. - `FireDepartmentActiveFirefightersVolunteer` (Fire Department Active Firefighters - Volunteer) — The number of active volunteer firefighters registered with the department. - `FireDepartmentActiveFirefightersPaidPerCall` (Fire Department Active Firefighters - Paid Per Call) — The number of active firefighters who are not full-time staff but receive payment for responding to incidents (paid-per-call). - `FireDepartmentNonFirefightingCivilian` (Fire Department Non firefighting - Civilian) — The number of paid civilian (non-firefighting) employees, such as administrative staff, dispatchers, or mechanics. - `FireDepartmentNonFirefightingVolunteer` (Fire Department Non firefighting - Volunteer) — The number of non-firefighting volunteers who support the department in administrative or other auxiliary roles. - `PoliceOri` (Originating Agency Identifier (ORI)) — The Originating Agency Identifier (ORI) is a unique identification code assigned to law enforcement agencies by the FBI. - `PoliceOfficerCt` (Total Full-Time Sworn Officers) — The total count of all full-time sworn officers employed by the police department. - `Psap` (PSAP) — Indicates if the buyer is a Public Safety Answering Point (PSAP), a call center for emergency services. - `StateAgencySector` (State Agency Sector) — Categorizes state agencies by their primary area of government responsibility (e.g., Education, Health & Human Services, Transportation & Infrastructure). Enables dynamic territory creation and account scoring by agency sector without relying on static buyer lists. - `EmployeeFte` (Employee FTE) — The total number of full-time equivalent employees. - `PropensityToSpendScore` (Propensity to Spend Score) — A predictive score from 1 (low) to 100 (high) indicating the buyer's likelihood to make purchases. - `PropensityToSpendSummary` (Propensity to Spend Summary) — A descriptive analysis highlighting the key drivers, market signals, and trends influencing the buyer's computed propensity score. - `BudgetChangeAnalysisSourceUrls` (Budget Change Analysis Source URLs) - `PropensityToSpend` (Propensity to Spend) — A categorical classification of the buyer's spending behavior: Aggressive Spender, Open to Spend, Selective, or Highly Cautious. - `YoyChangeInEnrollment` (YoY Change in Enrollment) — Year-over-year percentage change in enrollment, ranging from -100 to +100. - `EnrollmentTrend` (Enrollment Trend) — A categorical classification of the enrollment trend: Stable / Flat, Strongly Decreasing, Strongly Increasing, Moderately Increasing, Moderately Decreasing, or Not Available. - `EnrollmentTrendBasedOnFte` (Enrollment Trend Measured Based on FTE?) — Indicates whether the enrollment trend measurement is based on Full-Time Equivalent (FTE) students. - `SpecialEducationEnrollment` (Special Education Enrollment) — Number of enrolled students receiving special education services under IDEA. - `SpecialEducationEnrollmentPercentage` (Special Education Enrollment %) — Percentage of enrolled students receiving special education services under IDEA. - `PerPupilExpenditure` (Per-Pupil Expenditure) — Average total current expenditure per enrolled student (per-pupil expenditure). - `MathProficiencyPercentage` (Math Proficiency %) — Percentage of students meeting or exceeding state proficiency standards in Mathematics (0–100). - `ElaProficiencyPercentage` (ELA Proficiency %) — Percentage of students meeting or exceeding state proficiency standards in English Language Arts (0–100). - `TitleIFunding` (Title I Funding) — Total federal Title I, Part A allocation received by the district for supplemental instruction and support for low-income students. - `TitleIiFunding` (Title II Funding) — Total federal Title II, Part A allocation for educator quality improvement, professional development, and class-size reduction. - `TitleIiiFunding` (Title III Funding) — Total federal Title III, Part A allocation for English Learner instruction, language development, and immigrant student programs. - `TitleIvFunding` (Title IV Funding) — Total federal Title IV, Part A (SSAE) allocation for well-rounded education, safe and healthy schools, and effective technology use. - `TitleVFunding` (Title V Funding) — Total federal Title V allocation, primarily supporting the Rural Education Achievement Program (REAP) to assist rural and low-income school districts. - `FederalGrantComplianceRisk` (Federal Grant Compliance Risk) — Federal grant compliance risk based on FAC Single Audit data. High means serious findings like material weakness, material noncompliance, questioned costs, or repeat findings. Medium means less severe findings like significant deficiency or modified opinion. None means checked with no relevant risk. - `FederalGrantComplianceCapSummary` (Federal Grant Compliance CAP Summary) — Corrective action plans reported in FAC Single Audit data for federal grant compliance findings. - `BuyerLocationLatitude` (Buyer Location Latitude) — The geographic latitude of the buyer's primary location. Part of a coordinate pair. - `BuyerLocationLongitude` (Buyer Location Longitude) — The geographic longitude of the buyer's primary location. Part of a coordinate pair. required: true schema: type: string enum: - Id - Name - CommonName - ParentName - ParentBuyerId - Type - Classifications - Url - LinkedinSlug - Zip - CountryCode - StateCode - StateName - City - County - Address - Street1 - Street2 - MainPhoneNumber - EmailDomains - Population - BudgetAmount - BudgetSbita - BudgetUrl - BudgetLatestYear - BudgetConfidence - SchoolDistrictType - HigherEdFullTimeEnrollment - HigherEdInstitutionType - DepartmentName - DepartmentCode - AgencyName - OfficeCodeArray - AgencyCode - AiAdoptionScore - AiAdoptionSummary - StartupFriendlinessScore - StartupFriendlinessSummary - ProcurementHellScore - AngelProcurementSummary - IpedsIdNumeric - TotalEnrollment - NcesId - NcesStateDistrictId - CensusIdPid6 - CensusIdGidId - SgcId - HigherEdGraduationRate - HigherEdRetentionRate - HigherEdAcceptanceRate - HigherEdYieldRate - HigherEdGraduationEnrollment - HigherEdUndergradEnrollment - HigherEdOnlineOnlyEnrollment - HigherEdControlOfInstitution - HigherEdForProfitStatus - HigherEdLevelOfInstitution - HigherEdRecruitmentAdmissionsCrmArray - HigherEdEndowment - HigherEdMascot - HigherEdNumberOfOnCampusResidents - HigherEdNumberOfFullTimeEmployees - HigherEdSisModernizationStatus - HigherEdPrimaryRegionalAccreditor - HigherEdAccreditationSummary - HigherEdAccreditationStatus - DapipId - HigherEdNextAccreditationReviewDate - HigherEdSystem - CommunityCollegeSystem - Sis - LmsArray - SchoolDistrictLocale - SchoolDistrictFullTimeEquivalentTeachers - LowestGradeOffered - HighestGradeOffered - SchoolDistrictNumberOfSchools - SchoolDistrictElementarySchools - SchoolDistrictMiddleSchools - SchoolDistrictHighSchools - SchoolDistrictTotalStaff - SchoolDistrictMedianHouseholdIncome - SchoolDistrictSector - RegionalEducationServiceAgencyName - RegionalEducationServiceAgencyBuyerId - SchoolManagementOrganizationName - SchoolManagementOrganizationBuyerId - EnglishLearners - BlackPercentage - LatinoPercentage - WhitePercentage - StudentTeacherRatio - SchoolSector - SchoolLevel - AlternativeSchool - SchoolCurriculumProgramArray - ReligiousAffiliation - StudentGenderComposition - SchoolVirtualStatus - Subentity - FiscalYearStartDate - FreeOrReducedLunchEligiblePercentage - FdId - FireDepartmentType - FireDepartmentOrganizationType - FireDepartmentPrimaryAgency - FireDepartmentNumberOfStations - FireDepartmentActiveFirefightersCareer - FireDepartmentActiveFirefightersVolunteer - FireDepartmentActiveFirefightersPaidPerCall - FireDepartmentNonFirefightingCivilian - FireDepartmentNonFirefightingVolunteer - PoliceOri - PoliceOfficerCt - Psap - StateAgencySector - EmployeeFte - PropensityToSpendScore - PropensityToSpendSummary - BudgetChangeAnalysisSourceUrls - PropensityToSpend - YoyChangeInEnrollment - EnrollmentTrend - EnrollmentTrendBasedOnFte - SpecialEducationEnrollment - SpecialEducationEnrollmentPercentage - PerPupilExpenditure - MathProficiencyPercentage - ElaProficiencyPercentage - TitleIFunding - TitleIiFunding - TitleIiiFunding - TitleIvFunding - TitleVFunding - FederalGrantComplianceRisk - FederalGrantComplianceCapSummary - BuyerLocationLatitude - BuyerLocationLongitude responses: '200': description: The requested attribute value wrapped in BuyerAttributeResponse. content: application/json: schema: $ref: '#/components/schemas/BuyerAttributeResponse' '400': description: Invalid request body or format '401': description: Missing or invalid authentication '403': description: Unauthorized to access resource or perform action '404': description: Resource not found '415': description: Unsupported media type or request body format '429': description: Rate limit exceeded '500': description: Internal server error security: - apiKey: [] components: schemas: BuyerAttributeResponse: type: object title: BuyerAttributeResponse required: - buyerData properties: buyerData: description: >- Any JSON value - can be a string, number, boolean, object, array, or null securitySchemes: apiKey: scheme: bearer description: HTTP Bearer Authentication type: http ````