---
title: "Get Buyer Attribute"
method: GET
path: "/api/external/buyer/{buyerId}/attribute/{buyerAttribute}"
tags: ["Buyer", "External MCP", "External API"]
---

# Get Buyer Attribute

`GET /api/external/buyer/{buyerId}/attribute/{buyerAttribute}`

## Request

- Base URL: `https://dashboard.starbridge.ai`
- URL: `https://dashboard.starbridge.ai/api/external/buyer/{buyerId}/attribute/{buyerAttribute}`
- Auth: HTTP bearer
- TypeScript: <https://skmtc.dev/starbridge/apis/starbridge-external-public-api/docs/api/external/buyer/:buyerId/attribute/:buyerAttribute/get.ts> (a function with typed inputs; its response is checked against the schema)

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.

## Path parameters

- `buyerId` string, required
- `buyerAttribute` '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', required

## Response `200`

The requested attribute value wrapped in BuyerAttributeResponse.

- BuyerAttributeResponse
  - `buyerData` unknown, required

## Other responses

- `400`: Invalid request body or format
- `401`: Missing or invalid authentication
- `403`: Unauthorized to access resource or perform action
- `404`: Resource not found
- `415`: Unsupported media type or request body format
- `429`: Rate limit exceeded
- `500`: Internal server error

---

[API](https://skmtc.dev/starbridge/apis/starbridge-external-public-api.md) - [All operations](https://skmtc.dev/starbridge/apis/starbridge-external-public-api/llms.txt) - [OpenAPI document](https://skmtc.dev/starbridge/apis/starbridge-external-public-api/revisions/dc7faf636b78?raw)