Premier
API change historyThe GuideStar Premier API combines nonprofit-supplied data from the GuideStar Exchange program with data from other sources to provide comprehensive information about millions of organizations. API returns data in JSON/PDF format.
Get Premier v3
Premier API requires either EIN or an Organization Id as the parameter. Organization Id is an unique Id for an organization and can be retrieved using the Essentials (Search) API. To expedite the API experience, you are welcome to try and use the GuideStar's EIN 54-1774039 or Organization Id 7831216. Use either of these as a value to the "organization_id" parameter and try it out!
Try itRequest
Request URL
Request parameters
-
string
EIN or Organization Id. Organization Id is an unique Id for an organization and can be retrieved using the Essentials (Search) API.
Request headers
Request body
Responses
200 OK
OK
Representations
{
"code": 0,
"message": "string",
"took": 0,
"errors": [
{
"resource": "string",
"reason": "string"
}
],
"data": {
"summary": {
"organization_id": 0,
"organization_name": "string",
"ein": "string",
"bridge_id": "string",
"address_line_1": "string",
"address_line_2": "string",
"city": "string",
"state": "string",
"zip": "string",
"county": "string",
"latitude": "string",
"longitude": "string",
"fax": "string",
"govt_registered_name": "string",
"also_known_as": "string",
"fiscal_year_end": "string",
"fiscal_year_start": "string",
"affiliation_code": "string",
"affiliation_description": "string",
"contact_name": "string",
"contact_title": "string",
"contact_email": "string",
"contact_phone": "string",
"contact_fax": "string",
"gs_profile_update_level": "string",
"gs_profile_update_level_logo": "string",
"deductibility_code": "string",
"deductibility_description": "string",
"donation_to_ein": "string",
"donation_to_name": "string",
"areas_served_narrative": "string",
"ruling_year": "string",
"gs_public_report": "string",
"gs_pro_pdf": "string",
"gs_financial_trends_analysis_pdf": "string",
"impact_statement": "string",
"subsection_code": "string",
"subsection_description": "string",
"keywords": "string",
"logo_url": "string",
"mission": "string",
"is_national_hq": true,
"ntee_code": "string",
"sdg": {
"id": 0,
"description": "string"
},
"website_url": "string",
"year_founded": "string",
"year_incorporated": "string",
"is_non_bmf_org": true,
"first_on_bmf_date": "string",
"last_on_bmf_date": "string",
"profile_data_change_dates": {
"primary_address_last_modified": "string",
"payment_address_last_modified": "string",
"primary_contact_email_last_modified": "string",
"fundraising_contact_email_last_modified": "string",
"org_website_last_modified": "string"
},
"addresses": [
{
"address_line_1": "string",
"address_line_2": "string",
"city": "string",
"state": "string",
"postal_code": "string",
"country": "string",
"address_type": "string"
}
],
"affiliations": [
{
"row_id": "string",
"affiliation": "string",
"year": "string"
}
],
"awards": [
{
"awarding_external_org": "string",
"award_name": "string",
"award_year": "string"
}
],
"formerly_known_as": [
{
"former_name": "string",
"year": "string"
}
],
"forms_1023_1024": [
"string"
],
"letters_of_determination": [
{
"letter_of_determination_doc_name": "string",
"letter_of_determination_url": "string"
}
],
"letters_of_dissolution": [
{
"name": "string",
"year": "string",
"letter_of_dissolution_url": "string"
}
],
"ntee_codes": [
{
"ntee_code": "string",
"primary_code": "string",
"primary_description": "string",
"sub_code": "string",
"sub_description": "string"
}
],
"naics_code": {
"naics_code": "string",
"naics_description": "string"
},
"sic_codes": [
{
"sic_code": "string",
"sic_description": "string"
}
],
"platinum_evaluation_documents": [
{
"document_name": "string",
"document_year": "string",
"document_url": "string",
"document_type": "id"
}
],
"other_documents": [
{
"document_name": "string",
"document_year": "string",
"otherdocument_contents": "string",
"document_url": "string"
}
],
"photos": [
{
"picture_url": "string",
"caption": "string"
}
],
"social_media_urls": [
"string"
],
"telephone_numbers": [
{
"telephone_number": "string",
"telephone_type": "string"
}
],
"videos": [
{
"video_caption": "string",
"video_url": "string"
}
],
"org_collect_feedback": true,
"org_feedback_example": "string",
"org_quiz_interest": true,
"org_learn_more": true,
"feedback_responses": [
{
"ResponseId": 0,
"QuestionText": "string",
"ResponseText": "string"
}
],
"pcs_codes": [
{
"pcs_facet": "string",
"pcs_code": "string",
"pcs_description": "string",
"pcs_parent_code": "string",
"pcs_parent_description": "string"
}
],
"profile_sdg_codes": [
{
"id": 0,
"description": "string"
}
]
},
"programs": {
"programs": [
{
"name": "string",
"description": "string",
"target_population": "string",
"budget": "string",
"areas_served": [
"string"
]
}
],
"platinum_metrics": [
{
"metric": "string",
"years": [
{
"year": 0,
"value": 0
}
],
"target_population_served": [
"string"
],
"type_of_metric": "string",
"direction_of_success": "string"
}
],
"charting_impact_answers": [
{
"question": "string",
"answer": "string"
}
]
},
"financials": {
"most_recent_year_financials": {
"period_begin": "string",
"period_end": "string",
"fiscal_year": 0,
"form_type": "string",
"data_source": "string",
"assets_total": 0,
"total_liabilities": 0,
"revenue_contributions": 0,
"revenue_govt_grants": 0,
"revenue_program_services": 0,
"revenue_investments": 0,
"revenue_special_events": 0,
"revenue_sales": 0,
"revenue_other": 0,
"total_revenue": 0,
"expense_administration": 0,
"expense_program_services": 0,
"expense_fundraising": 0,
"expense_accounting": 0,
"expense_advertising_promotion": 0,
"expense_info_technology": 0,
"expense_insurance": 0,
"expense_interest": 0,
"expense_investment_management": 0,
"expense_legal": 0,
"expense_pension_plan": 0,
"expense_professional_fundraising": 0,
"unrestricted_net_assets": 0,
"net_fixed_assets_LBE": 0,
"notes_payable_mortgages": 0,
"months_of_cash": 0,
"expense_professional_fees": 0,
"expense_publications": 0,
"expense_operating_admin": 0,
"expense_gifts_grants_paid": 0,
"total_expense_disbursements": 0,
"expenses_total": 0,
"net_gain_loss": 0,
"expense_salaries_employee_benefits": 0,
"cash_and_equivalent_assets": 0,
"investments_us_government": 0,
"investments_stock": 0,
"investments_bonds": 0,
"investments_other": 0,
"land_buildings_equipment": 0,
"other_assets": 0
},
"f990_financials": [
{
"period_begin": "string",
"period_end": "string",
"membership_dues": 0,
"revenue_contributions": 0,
"revenue_govt_grants": 0,
"revenue_program_services": 0,
"revenue_investments": 0,
"revenue_special_events": 0,
"revenue_sales": 0,
"revenue_other": 0,
"revenue_total": 0,
"affiliate_net_payments": 0,
"expense_program_services": 0,
"expense_administration": 0,
"expense_fundraising": 0,
"expenses_total": 0,
"net_gain_loss": 0,
"expense_accounting": 0,
"expense_advertising_promotion": 0,
"expense_info_technology": 0,
"expense_insurance": 0,
"expense_interest": 0,
"expense_investment_management": 0,
"expense_legal": 0,
"expense_pension_plan": 0,
"expense_publications": 0,
"expense_profesional_fundraising": 0,
"assets_total": 0,
"unrestricted_net_assets": 0,
"net_fixed_assets_LBE": 0,
"net_assets_end_of_year": 0,
"other_expense": 0,
"notes_payable_mortgages": 0,
"liabilities_total": 0,
"months_of_cash": "string",
"part_8_revenue": {
"federated_campaigns": 0,
"membership_dues": 0,
"fundraising_events": 0,
"related_orgs": 0,
"government_grants": 0,
"contributions_other": 0,
"contributions_noncash": 0,
"contributions_all": 0,
"service_revenue": 0,
"income_investment": 0,
"income_bonds": 0,
"royalties": 0,
"rents_real": 0,
"rents_personal": 0,
"rent_expenses_real": 0,
"rent_expenses_personal": 0,
"rent_income_real": 0,
"rent_income_personal": 0,
"net_rental": 0,
"gross_securities": 0,
"gross_other": 0,
"cost_securities": 0,
"cost_other": 0,
"gain_securities": 0,
"gain_other": 0,
"net_sales": 0,
"contributions": 0,
"gross_special": 0,
"direct_expenses": 0,
"net_special": 0,
"gaming_income": 0,
"gaming_expenses": 0,
"gaming_net": 0,
"gross_sales": 0,
"cost_goods": 0,
"gross_profit": 0,
"revenue_other": 0,
"revenue_total": 0,
"service_description_a": "string",
"service_code_a": 0,
"service_amount_a": 0,
"service_description_b": "string",
"service_code_b": 0,
"service_amount_b": 0,
"service_description_c": "string",
"service_code_c": 0,
"service_amount_c": 0,
"service_description_d": "string",
"service_code_d": 0,
"service_amount_d": 0,
"service_description_e": "string",
"service_code_e": 0,
"service_amount_e": 0,
"service_description_f": "string",
"service_code_f": 0,
"service_amount_f": 0
},
"part_9_expenses": {
"grants_orgs_us": 0,
"grants_individuals_us": 0,
"grants_orgs_non_us": 0,
"benefits_total": 0,
"compensation_current": 0,
"compensation_disqualified": 0,
"wages_total": 0,
"pension_total": 0,
"employee_benefits_total": 0,
"payroll_tax_total": 0,
"fees_management": 0,
"fees_legal": 0,
"accounting_fees_total": 0,
"fees_lobbying": 0,
"fundraising_total": 0,
"fees_investments": 0,
"fees_other": 0,
"ads_promo": 0,
"office": 0,
"information_technology": 0,
"expense_royalties": 0,
"occupancy_total": 0,
"travel_total": 0,
"entertain_officials": 0,
"meetings_total": 0,
"interest_total": 0,
"payments": 0,
"depreciation_total": 0,
"insurance": 0,
"expense_a_total": 0,
"expense_b_total": 0,
"expense_c_total": 0,
"expense_d_total": 0,
"expense_e_total": 0,
"expenses_total": 0,
"total_program_services": 0,
"total_management": 0,
"total_fundraising": 0,
"expense_joint_total": 0,
"joint_services": 0,
"joint_general": 0,
"joint_fundraising": 0,
"all_other_expenses": 0,
"expense_a_description": "string",
"expense_b_description": "string",
"expense_c_description": "string",
"expense_d_description": "string"
},
"part_10_balance_sheet": {
"cash_boy": 0,
"cash_eoy": 0,
"savings_boy": 0,
"savings_eoy": 0,
"pledges_grants_boy": 0,
"pledges_grants_eoy": 0,
"accounts_receivable_boy": 0,
"accounts_receivable_eoy": 0,
"qualified_receivable_boy": 0,
"qualified_receivable_eoy": 0,
"disqualified_receivable_boy": 0,
"disqualified_receivable_eoy": 0,
"loans_receivable_boy": 0,
"loans_receivable_eoy": 0,
"inventory_boy": 0,
"inventory_eoy": 0,
"prepaid_boy": 0,
"prepaid_eoy": 0,
"lbe_base": 0,
"less_depreciation": 0,
"lbe_boy": 0,
"lbe_eoy": 0,
"public_securities_boy": 0,
"public_securities_eoy": 0,
"other_securities_boy": 0,
"other_securities_eoy": 0,
"investment_programs_boy": 0,
"investment_programs_eoy": 0,
"intangible_assets_boy": 0,
"intangible_assets_eoy": 0,
"other_assets_boy": 0,
"other_assets_eoy": 0,
"assets_total_boy": 0,
"assets_total_eoy": 0,
"accounts_payable_boy": 0,
"accounts_payable_eoy": 0,
"grants_payable_boy": 0,
"grants_payable_eoy": 0,
"deferred_revenue_boy": 0,
"deferred_revenue_eoy": 0,
"tax_exempt_bonds_boy": 0,
"tax_exempt_bonds_eoy": 0,
"escrow_liability_boy": 0,
"escrow_liability_eoy": 0,
"payable_officiers_boy": 0,
"payable_officiers_eoy": 0,
"secured_notes_payable_boy": 0,
"secured_notes_payable_eoy": 0,
"unsecured_notes_payable_boy": 0,
"unsecured_notes_payable_eoy": 0,
"liability_other_boy": 0,
"liability_other_eoy": 0,
"liability_total_boy": 0,
"liability_total_eoy": 0,
"unrestricted_boy": 0,
"unrestricted_eoy": 0,
"temporarily_restricted_boy": 0,
"temporarily_restricted_eoy": 0,
"permanently_restricted_boy": 0,
"permanently_restricted_eoy": 0,
"capital_boy": 0,
"capital_eoy": 0,
"paid_in_boy": 0,
"paid_in_eoy": 0,
"retained_boy": 0,
"retained_eoy": 0,
"net_total_boy": 0,
"net_total_eoy": 0,
"balances_boy": 0,
"balances_eoy": 0
}
}
],
"pf990_financials": [
{
"period_begin": "string",
"period_end": "string",
"cash_equivalent_investible_assets": 0,
"investments_us_state_government": 0,
"adjusted_net_income": 0,
"total_operating_expenses": 0,
"contributions": 0,
"total_expenses": 0,
"expense_accounting": 0,
"expense_interest": 0,
"expense_legal": 0,
"expense_professional_fees": 0,
"expense_pension_plans": 0,
"expense_publications": 0,
"investments_us_state_govt": 0,
"investments_stocks": 0,
"investments_bonds": 0,
"investments_other": 0,
"land_buildings_equipment": 0,
"other_assets": 0,
"total_assets": 0,
"total_liabilities": 0,
"net_assetss": 0
}
],
"f990ez_financials": [
{
"period_begin": "string",
"period_end": "string",
"accounting_method": "string",
"organization_type": "string",
"date_last_modified": "string",
"revenue_contributions": 0,
"revenue_program_services": 0,
"revenue_membership_dues": 0,
"revenue_investments": 0,
"revenue_sales_other": 0,
"revenue_special_events": 0,
"revenue_sales_inventory": 0,
"revenue_sales": 0,
"revenue_other": 0,
"total_revenue": 0,
"expense_grants": 0,
"expense_benefits": 0,
"expense_salaries_employee_benefits": 0,
"expense_professional_fees": 0,
"expense_occupancy": 0,
"expense_printing_publications_postage": 0,
"expense_other": 0,
"total_expenses": 0,
"net_gain_loss": 0,
"other_changes": 0,
"cash_savings_investments_boy": 0,
"land_and_buidings_boy": 0,
"other_assets_boy": 0,
"total_assets_boy": 0,
"total_liabilities_boy": 0,
"net_assets_boy": 0,
"cash_savings_investments_eoy": 0,
"land_and_buidings_eoy": 0,
"other_assets_eoy": 0,
"total_assets_eoy": 0,
"total_liabilities_eoy": 0,
"net_assets_eoy": 0,
"part_1_revenue_expenses": {
"contributions_total": 0,
"service_revenue": 0,
"membership_dues": 0,
"income_investments": 0,
"gross_other": 0,
"cost_other": 0,
"gain_other": 0,
"gross_gaming": 0,
"gross_fundraising": 0,
"gross_special": 0,
"direct_expenses": 0,
"net_special": 0,
"gross_sales": 0,
"cost_goods": 0,
"gross_profit": 0,
"revenue_other": 0,
"revenue_total": 0,
"grants_total": 0,
"benefits_total": 0,
"compensation_total": 0,
"fundraising_total": 0,
"occupancy_total": 0,
"printing_total": 0,
"other_expenses_total": 0,
"functional_expenses_total": 0,
"year_excess": 0,
"net_assets_boy": 0,
"assets_change": 0,
"net_assets_eoy": 0
},
"part_2_balance_sheet": {
"cash_boy": 0,
"lbe_boy": 0,
"assets_other_boy": 0,
"assets_total_boy": 0,
"liability_total_boy": 0,
"net_total_boy": 0,
"cash_eoy": 0,
"lbe_eoy": 0,
"assets_other_eoy": 0,
"assets_total_eoy": 0,
"liability_total_eoy": 0,
"net_total_eoy": 0
}
}
],
"financial_trends_analysis": [
{
"fiscal_year": "string",
"business_model_indicators": {
"profitability": {
"Unrestricted_surplus_(deficit)_before_depreciation": 0,
"surplus_as_percent_of_expenses_before_depreciation": "string",
"Unrestricted_surplus_(deficit)_after_depreciation": 0,
"surplus_as_percent_of_expenses_after_depreciation": "string"
},
"revenue_composition": {
"total_revenue_unrestricted_and_restricted": 0,
"total_revenue_percent_change_over_prior_year": "string",
"total_revenue_prior": 0,
"program_svcs_revenue": "string",
"membership_dues": "string",
"investment_income": "string",
"government_grants": "string",
"other_grants_contributions": "string",
"other_revenue": "string"
},
"expense_composition": {
"total_expenses_before_depreciation": 0,
"total_expenses_percent_change_over_prior_year": "string",
"personnel": "string",
"professional_fees": "string",
"occupancy": "string",
"interest_expense": "string",
"pass_through": "string",
"all_other_expenses": "string"
},
"full_cost_components": {
"total_expenses_after_depreciation": 0,
"one_month_of_savings": 0,
"debt_principal_payment": 0,
"fixed_asset_additions": 0,
"total_full_costs_estimated": 0
}
},
"capital_structure_indicators": {
"liquidity": {
"months_of_cash": 0,
"months_of_cash_and_investments": 0,
"months_of_estimated_liquid_unrestricted_net_assets": 0
},
"balance_sheet_composition": {
"cash": 0,
"investments": 0,
"receivables": 0,
"gross_land_buildings_and_equipment_lbe": 0,
"accumulated_depreciation_as_percent_of_lbe": "string",
"liabilities_as_percent_of_net_assets": "string",
"unrestricted_net_assets": 0,
"temporarily_restricted_net_assets": 0,
"permanently_restricted_net_assets": 0,
"total_net_assets": 0
}
},
"key_data_checks": {
"data_check_errors": true
}
}
],
"financial_documents": [
{
"form990_name": "string",
"form990_year": "string",
"form990_url": "string",
"form990_source": "string"
}
],
"forms_990T": [
{
"form990t_name": "string",
"form990t_url": "string"
}
],
"funding_needs": [
{
"funding_need": "string",
"amount_needed": "string"
}
],
"funding_sources": [
{
"funding_source": "string",
"funding_amount": "string"
}
],
"financial_statements": [
{
"fiscal_year_begin": "string",
"fiscal_year_end": "string",
"auditing_company": "string",
"doc_name": "string",
"document_url": "string"
}
],
"annual_reports": [
{
"doc_name": "string",
"contents": "string",
"year": "string",
"url": "string"
}
],
"accounting_ratios": [
{
"year": 0,
"months_of_cash": "string",
"liquidity": "string",
"fringe_rate": "string",
"net_gain_loss": "string"
}
]
},
"operations": {
"leader_name": "string",
"leader_profile": "string",
"co_leader_name": "string",
"co_leader_profile": "string",
"no_of_employees": 0,
"no_of_volunteers": 0,
"organization_email": "string",
"organization_details_year": 0,
"officers_directors_key_employees": [
{
"name": "string",
"title": "string",
"type": [
"string"
],
"compensation": 0,
"related_compensation": 0,
"other_compensation": 0,
"hours": "string",
"benefits": "string"
}
],
"highest_paid_employees": [
{
"name": "string",
"title": "string",
"type": [
"string"
],
"compensation": 0,
"related_compensation": 0,
"other_compensation": 0,
"hours": "string",
"benefits": "string"
}
],
"employees_greater_than_100K": 0,
"board_chair_name": "string",
"board_chair_affiliation": "string",
"board_chair_term_start": "string",
"board_chair_term_end": "string",
"board_co_chair_name": "string",
"board_co_chair_affiliation": "string",
"board_co_chair_term_start": "string",
"board_co_chair_term_end": "string",
"board_of_directors": [
{
"name": "string",
"title": "string",
"company": "string"
}
],
"board_leadership_practices": [
{
"question": "string",
"answer": "string"
}
],
"organization_demographics": {
"total_board_members": 0,
"total_fulltime_staff": 0,
"total_parttime_staff": 0,
"total_staff": 0,
"total_senior_staff": 0,
"tracks_staffboardvol_retention": true,
"tracks_staffboard_income": true,
"tracks_staffboard_age": true,
"tracks_vendor_diversity": true,
"has_diversity_committee": true,
"has_diversity_manager": true,
"diversity_manager_fulltime": true,
"diversity_plan": true,
"supports_diversity_via_other_methods": true,
"equity_strategies": {
"data_compensation": true,
"data_disparities": true,
"data_root_cause": true,
"data_programming_goals": true,
"data_feedback": true,
"data_demographics": true,
"data_strategic_plan": true,
"policy_standards": true,
"policy_promotion": true,
"policy_evaluation": true,
"policy_community": true,
"policy_leadership": true,
"policy_satisfaction": true,
"policy_equity": true,
"equity_strategy_last_modified": "string"
},
"categories": [
{
"category": "string",
"org_does_not_collect_for": {},
"subcategories": [
{
"subcategory": "string",
"staff_levels": [
{
"staff_level": "string",
"count": 0
}
]
}
]
}
]
},
"demographics": {
"staff_level_totals": {
"total_board_members": "string",
"total_staff": "string",
"total_senior_staff": "string"
},
"equity_strategies": {
"data_compensation": true,
"data_disparities": true,
"data_root_cause": true,
"data_programming_goals": true,
"data_feedback": true,
"data_demographics": true,
"data_strategic_plan": true,
"policy_standards": true,
"policy_promotion": true,
"policy_evaluation": true,
"policy_community": true,
"policy_leadership": true,
"policy_satisfaction": true,
"policy_equity": true,
"equity_strategy_last_modified": "string"
},
"categories": [
{
"category": "string",
"board_members_not_collected": true,
"staff_not_collected": true,
"senior_staff_not_collected": true,
"subcategories": [
{
"subcategory": "string",
"board_members": 0,
"staff": 0,
"senior_staff": 0,
"reported_by_ceo": true,
"reported_by_coceo": true
}
]
}
]
},
"contractors": [
{
"name": "string",
"address": "string",
"compensation": "string",
"service_type": "string"
}
],
"blog_url": "string",
"fundraising_contact_name": "string",
"fundraising_contact_title": "string",
"fundraising_contact_email": "string",
"fundraising_contact_phone": "string",
"preparer_firm_name": "string",
"preparer_firm_address": "string",
"preparer_firm_ein": "string",
"preparer_firm_phone": "string",
"senior_staff": [
{
"name": "string",
"title": "string",
"experience": "string"
}
],
"other_staff": [
{
"name": "string",
"title": "string",
"type": "string"
}
],
"accreditations": [
{
"accreditation": "string",
"year": "string"
}
]
},
"charitycheck": {
"organization_id": "string",
"organization_info_last_modified": "string",
"ein": "string",
"organization_name": "string",
"organization_name_aka": "string",
"address_line1": "string",
"address_line2": "string",
"city": "string",
"state": "string",
"state_name": "string",
"zip": "string",
"filing_req_code": "string",
"charity_check_last_modified": "string",
"pub78_church_message": "string",
"pub78_organization_name": "string",
"pub78_ein": "string",
"pub78_verified": "string",
"pub78_city": "string",
"pub78_state": "string",
"pub78_indicator": "string",
"organization_types": [
{
"organization_type": "string",
"deductibility_limitation": "string",
"deductibility_status_description": "string"
}
],
"most_recent_pub78": "string",
"most_recent_irb": "string",
"bmf_church_message": "string",
"bmf_organization_name": "string",
"bmf_ein": "string",
"bmf_status": "string",
"most_recent_bmf": "string",
"bmf_subsection": "string",
"subsection_description": "string",
"foundation_code": "string",
"foundation_code_description": "string",
"ruling_month": "string",
"ruling_year": "string",
"adv_ruling_month": "string",
"adv_ruling_year": "string",
"group_exemption": "string",
"exempt_status_code": "string",
"ofac_status": "string",
"revocation_code": "string",
"revocation_date": "string",
"reinstatement_date": "string",
"irs_bmf_pub78_conflict": "string",
"foundation_509a_status": "string",
"irb_organization_id": "string",
"bulletin_number": "string",
"bulletin_url": "string",
"effective_date": "string",
"irb_last_modified": "string",
"report_date": "string",
"foundation_type_code": "string",
"foundation_type_description": "string",
"parent_organizations": [
{
"ein": "string",
"organization_name": "string",
"group_exemption": "string"
}
]
}
}
}{
"type": "object",
"properties": {}
}{}{
"type": "object",
"properties": {}
}Code samples
@ECHO OFF
curl -v -X GET "https://apidata.guidestar.org/premier/v3/{organization_id}"
-H "Subscription-Key: {subscription key}"
--data-ascii "{body}"
using System;
using System.Net.Http.Headers;
using System.Text;
using System.Net.Http;
using System.Web;
namespace CSHttpClientSample
{
static class Program
{
static void Main()
{
MakeRequest();
Console.WriteLine("Hit ENTER to exit...");
Console.ReadLine();
}
static async void MakeRequest()
{
var client = new HttpClient();
var queryString = HttpUtility.ParseQueryString(string.Empty);
// Request headers
client.DefaultRequestHeaders.Add("Subscription-Key", "{subscription key}");
var uri = "https://apidata.guidestar.org/premier/v3/{organization_id}?" + queryString;
var response = await client.GetAsync(uri);
}
}
} // // This sample uses the Apache HTTP client from HTTP Components (http://hc.apache.org/httpcomponents-client-ga/)
import java.net.URI;
import org.apache.http.HttpEntity;
import org.apache.http.HttpResponse;
import org.apache.http.client.HttpClient;
import org.apache.http.client.methods.HttpGet;
import org.apache.http.client.utils.URIBuilder;
import org.apache.http.impl.client.HttpClients;
import org.apache.http.util.EntityUtils;
public class JavaSample
{
public static void main(String[] args)
{
HttpClient httpclient = HttpClients.createDefault();
try
{
URIBuilder builder = new URIBuilder("https://apidata.guidestar.org/premier/v3/{organization_id}");
URI uri = builder.build();
HttpGet request = new HttpGet(uri);
request.setHeader("Subscription-Key", "{subscription key}");
// Request body
StringEntity reqEntity = new StringEntity("{body}");
request.setEntity(reqEntity);
HttpResponse response = httpclient.execute(request);
HttpEntity entity = response.getEntity();
if (entity != null)
{
System.out.println(EntityUtils.toString(entity));
}
}
catch (Exception e)
{
System.out.println(e.getMessage());
}
}
}
We do not support Cross-Origin Resource Sharing (CORS).#import <Foundation/Foundation.h>
int main(int argc, const char * argv[])
{
NSAutoreleasePool * pool = [[NSAutoreleasePool alloc] init];
NSString* path = @"https://apidata.guidestar.org/premier/v3/{organization_id}";
NSArray* array = @[
// Request parameters
@"entities=true",
];
NSString* string = [array componentsJoinedByString:@"&"];
path = [path stringByAppendingFormat:@"?%@", string];
NSLog(@"%@", path);
NSMutableURLRequest* _request = [NSMutableURLRequest requestWithURL:[NSURL URLWithString:path]];
[_request setHTTPMethod:@"GET"];
// Request headers
[_request setValue:@"{subscription key}" forHTTPHeaderField:@"Subscription-Key"];
// Request body
[_request setHTTPBody:[@"{body}" dataUsingEncoding:NSUTF8StringEncoding]];
NSURLResponse *response = nil;
NSError *error = nil;
NSData* _connectionData = [NSURLConnection sendSynchronousRequest:_request returningResponse:&response error:&error];
if (nil != error)
{
NSLog(@"Error: %@", error);
}
else
{
NSError* error = nil;
NSMutableDictionary* json = nil;
NSString* dataString = [[NSString alloc] initWithData:_connectionData encoding:NSUTF8StringEncoding];
NSLog(@"%@", dataString);
if (nil != _connectionData)
{
json = [NSJSONSerialization JSONObjectWithData:_connectionData options:NSJSONReadingMutableContainers error:&error];
}
if (error || !json)
{
NSLog(@"Could not parse loaded json with error:%@", error);
}
NSLog(@"%@", json);
_connectionData = nil;
}
[pool drain];
return 0;
}
<?php
// This sample uses the Apache HTTP client from HTTP Components (http://hc.apache.org/httpcomponents-client-ga/)
require_once 'HTTP/Request2.php';
$request = new Http_Request2('https://apidata.guidestar.org/premier/v3/{organization_id}');
$url = $request->getUrl();
$headers = array(
// Request headers
'Subscription-Key' => '{subscription key}',
);
$request->setHeader($headers);
$parameters = array(
// Request parameters
);
$url->setQueryVariables($parameters);
$request->setMethod(HTTP_Request2::METHOD_GET);
// Request body
$request->setBody("{body}");
try
{
$response = $request->send();
echo $response->getBody();
}
catch (HttpException $ex)
{
echo $ex;
}
?>########### Python 2.7 #############
import httplib, urllib, base64
headers = {
# Request headers
'Subscription-Key': '{subscription key}',
}
params = urllib.urlencode({
})
try:
conn = httplib.HTTPSConnection('apidata.guidestar.org')
conn.request("GET", "/premier/v3/{organization_id}?%s" % params, "{body}", headers)
response = conn.getresponse()
data = response.read()
print(data)
conn.close()
except Exception as e:
print("[Errno {0}] {1}".format(e.errno, e.strerror))
####################################
########### Python 3.2 #############
import http.client, urllib.request, urllib.parse, urllib.error, base64
headers = {
# Request headers
'Subscription-Key': '{subscription key}',
}
params = urllib.parse.urlencode({
})
try:
conn = http.client.HTTPSConnection('apidata.guidestar.org')
conn.request("GET", "/premier/v3/{organization_id}?%s" % params, "{body}", headers)
response = conn.getresponse()
data = response.read()
print(data)
conn.close()
except Exception as e:
print("[Errno {0}] {1}".format(e.errno, e.strerror))
####################################require 'net/http'
uri = URI('https://apidata.guidestar.org/premier/v3/{organization_id}')
request = Net::HTTP::Get.new(uri.request_uri)
# Request headers
request['Subscription-Key'] = '{subscription key}'
# Request body
request.body = "{body}"
response = Net::HTTP.start(uri.host, uri.port, :use_ssl => uri.scheme == 'https') do |http|
http.request(request)
end
puts response.body