> ## 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 Attributes in bulk

> Retrieve multiple structured attributes about a buyer (institution) in a single call, so you don't have to make one request per attribute (which clutters MCP / Ask Starbridge sessions). Buyers include cities, counties, higher-education institutions, school districts, police and fire departments, federal agencies, and other public-sector entities. Pass one or more `attribute` query parameters (each a BuyerField key, the same keys `getBuyerSchema` documents) to select what to return, or omit `attribute` entirely to get every available attribute. The response `buyerData` maps each requested key to its value (JsonNull when the attribute is unset). Find a buyer's id first with `searchBuyersByCriteria`, and call `getBuyerSchema` to list the available attribute keys and what each one returns.



## OpenAPI

````yaml https://core-http2-157602306522.us-central1.run.app/external/public/swagger/documentation.yaml get /api/external/buyer/{buyerId}/attributes
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}/attributes:
    get:
      tags:
        - External MCP
        - External API
        - Buyer
      summary: Get Buyer Attributes in bulk
      description: >-
        Retrieve multiple structured attributes about a buyer (institution) in a
        single call, so you don't have to make one request per attribute (which
        clutters MCP / Ask Starbridge sessions). Buyers include cities,
        counties, higher-education institutions, school districts, police and
        fire departments, federal agencies, and other public-sector entities.
        Pass one or more `attribute` query parameters (each a BuyerField key,
        the same keys `getBuyerSchema` documents) to select what to return, or
        omit `attribute` entirely to get every available attribute. The response
        `buyerData` maps each requested key to its value (JsonNull when the
        attribute is unset). Find a buyer's id first with
        `searchBuyersByCriteria`, and call `getBuyerSchema` to list the
        available attribute keys and what each one returns.
      operationId: getBuyerAttributesBulk
      parameters:
        - name: buyerId
          in: path
          required: true
          schema:
            type: string
        - name: attribute
          in: query
          description: >-
            The attribute keys to retrieve. Pass multiple `attribute` parameters
            for multiple keys, or omit entirely to return all available
            attributes. Each key is a BuyerField value; `getBuyerSchema` lists
            them with what each one returns.
          schema:
            type: array
            items:
              type: string
              enum:
                - Id
                - Name
                - CommonName
                - ParentName
                - ParentBuyerId
                - Type
                - Classifications
                - Url
                - LinkedinSlug
                - Zip
                - CountryCode
                - StateCode
                - StateName
                - City
                - County
                - Address
                - Street1
                - Street2
                - MainPhoneNumber
                - EmailDomains
                - Population
                - PopulationTrend
                - PopulationOneYearChangePercentage
                - PopulationFiveYearChangePercentage
                - PopulationDensityPerSquareMile
                - CountyHudAssistedHousingUnitCount
                - HudAreaMedianFamilyIncome
                - CountyMedicareAdvantageEnrollmentCount
                - CountyMedicareAdvantagePenetrationPercentage
                - CountyMedicareMedicaidEnrolleeCount
                - CountyOriginalMedicareEnrollmentCount
                - FemaDisasterDeclarationCount
                - FemaFireDisasterDeclarationCount
                - FemaFloodDisasterDeclarationCount
                - FemaSevereStormDisasterDeclarationCount
                - FemaWinterStormDisasterDeclarationCount
                - 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
                - HigherEdTotalExpenses
                - HigherEdMascot
                - HigherEdNumberOfOnCampusResidents
                - HigherEdNumberOfFullTimeEmployees
                - HigherEdSisModernizationStatus
                - HigherEdPrimaryRegionalAccreditor
                - HigherEdAccreditationSummary
                - HigherEdAccreditationStatus
                - DapipId
                - HigherEdNextAccreditationReviewDate
                - HigherEdSystem
                - CommunityCollegeSystem
                - HigherEdContinuingProfessionalEducationOffered
                - Sis
                - LmsArray
                - SchoolDistrictLocale
                - SchoolDistrictFullTimeEquivalentTeachers
                - LowestGradeOffered
                - HighestGradeOffered
                - SchoolYearStartDate
                - SchoolYearEndDate
                - SchoolDistrictNumberOfSchools
                - SchoolDistrictNewlyOpenedSchoolCount
                - SchoolDistrictClosedSchoolCount
                - 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
                - PoliceDepartmentType
                - HasCampusPolice
                - Psap
                - StateAgencySector
                - EmployeeFte
                - WaterSystemPopulationServed
                - SpecialDistrictResidentPopulationEstimate
                - MotorCarrierPowerUnits
                - PropensityToSpendScore
                - PropensityToSpendSummary
                - BudgetChangeAnalysisSourceUrls
                - PropensityToSpend
                - YoyChangeInEnrollment
                - EnrollmentTrend
                - EnrollmentTrendBasedOnFte
                - AtsiDesignation
                - SpecialEducationEnrollment
                - SpecialEducationEnrollmentPercentage
                - TsiDesignation
                - CsiDesignation
                - SchoolDistrictTotalRevenue
                - SchoolDistrictFederalRevenue
                - SchoolDistrictStateRevenue
                - SchoolDistrictLocalRevenue
                - PerPupilExpenditure
                - MathProficiencyPercentage
                - ElaProficiencyPercentage
                - GraduationRatePercentage
                - ChronicAbsenteeismPercentage
                - MathProficiencyStatePercentile
                - ElaProficiencyStatePercentile
                - TitleIFunding
                - TitleIiFunding
                - TitleIiiFunding
                - TitleIvFunding
                - TitleVFunding
                - FederalGrantComplianceRisk
                - FederalGrantComplianceCapSummary
                - ErateFunding
                - IhbgFinalAllocationAmount
                - TribalTransportationProgramShare
                - BuyerLocationLatitude
                - BuyerLocationLongitude
                - StarbridgeUrl
          style: form
          explode: false
      responses:
        '200':
          description: >-
            Requested attribute values keyed by BuyerField name, wrapped in
            BuyerAttributesBulkResponse.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/BuyerAttributesBulkResponse'
        '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:
    BuyerAttributesBulkResponse:
      type: object
      title: BuyerAttributesBulkResponse
      required:
        - buyerId
      properties:
        buyerId:
          type: string
          format: uuid
        buyerData:
          type:
            - object
            - 'null'
          description: >-
            Map of BuyerField attribute key to its value. A value is null when
            that attribute is not set on the buyer.
          additionalProperties: true
  securitySchemes:
    apiKey:
      scheme: bearer
      description: HTTP Bearer Authentication
      type: http

````

This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.