Introduction
The GuideStar APIs are RESTful. They are simple, predictable, and use standard HTTP response codes to indicate statues and errors. We also use standard HTTP verbs, which are understood by all HTTP clients. All of our APIs' return responses are in JSON format.
For your convenience, we've provided various tools to assist you while learning and experimenting with our APIs.
-
For Essentials API
- Query JSON body generator - Essentials API uses the HTTP POST method and requires you to send JSON Query. To help you with the creation of the JSON Query, you can use this tool to generate the JSON Query simply by filling out the form.
- Lookup values for Filters
Authentication
You can manage your Subscription keys in the Dashboard, available through Developer Portal under your Premier page. Your Subscription keys carry many privileges, so be sure to keep them secret! Do not share your secret keys in publicly accessible areas.
There will be primary and secondary subscription keys and you might be wondering why. The purpose is to allow for "rolling" key upgrades when needed without downtime. In most cases, you can just use the primary subscription key.
Authentication to the API is performed via HTTP Header or URL as a query parameter. However, we do strongly recommend passing the key via HTTP Header Subscription-Key for production applications. During development, you may use the URL query parameter as a convinient method - append ?Subscription-Key={key}
All API requests must be made over HTTPS. Calls made over plain HTTP will fail. API requests without authentication will also fail.
Example: Subscription Key via HTTP Header (Recommended for Production)
GET https://apidata.guidestar.org/charitycheck/v1/54-1774039 HTTP/1.1 Host: apidata.guidestar.org Subscription-Key: {Your Subscription Key}
Example: Subscription Key via URL as a query parameter (Not Recommended for Production)
https://apidata.guidestar.org/charitycheck/v1/54-1774039?Subscription-Key={Your Subscription Key}
Essentials API
Search GuideStar’s most common set of data about nonprofits to quickly find organizations most relevant to your users, and use those results to get more data from our other APIs.
HTTP Request
POST: https://apidata.guidestar.org/essentials/v2
HTTP Request Body
Below is the complete essentials query JSON representation. You do not need to specify them all unless you need to. At a minimum, you will need at least one search_term or a filter for the essentials query to work.
They are made up of Query and Filters sections.
{ search_terms: "", from: 0, size: 25, sort: { sort_by: "", ascending: true }, filters: { geography: { state: [], zip: "", radius: 0, msa: [], city: [], county: [] }, organization: { profile_levels: [], ntee_major_codes: [], ntee_minor_codes: [], subsection_codes: [], foundation_codes: [], New bmf_status: null, New pub78_verified: null, New affiliation_type: { parent: false, subordinate: false, independent: false, headquarter: false }, specific_exclusions: { exclude_revoked_organizations: false, exclude_defunct_or_merged_organizations: false }, number_of_employees_range: { min: 0, max: 0 }, form_types: { f990: false, f990pf: false, required_to_file_990t: false }, audits: { a_133_audit_performed: false } }, financials: { form990_total_revenue: { min: 0, max: 0 }, form990_total_expenses: { min: 0, max: 0 }, form990_total_assets: { min: 0, max: 0 } } } }
- Query
- search_term - Full text search. You can use any terms you want including EIN, organization name, keywords and so on.
- from, size - Pagination of the essentials results can be performed by using these parameters. The from defines the offset from the first result. The size parameter defines the maximum number of hits to be retured. If omitted, from defaults to 0 and size defaults to 25 which is the maximum allowed. Remember, from + size can not be more than 10,000. If you ever reach that point, perhaps, you should consider searching again using different search terms and filters.
- sort - Essentials results can be sorted. Available sort options are relevancy which is the default, organization name, bmf_gross_receipts, and bmf_assets.
- sort_by - See available sort options using the essentials request body generator tool link
- ascending - True/False.
- FiltersFilters
- geography
- state - State code. See example using the essentials request body generator tool See complete list link
- zip - 5 digit zipcode.
- radius - Radius from the specified zipcode. Unit is in miles and allowed range is between 1 and 50 miles. Exceeding allowed max miles range will be defaulted to 50 miles.
- msa - Metropolitan Statistical Area. See complete list link
- city - US cities. See complete list link
- county - US counties.See complete list link
- organization
- profile_levels - GuideStar seal levels. Allowed levels are Bronze, Silver, Gold, and Platinum. See example using the essentials request body generator toollink
- ntee_major_codes - National Taxonomy of Exempt Entities (NTEE) Major codes. See complete list link
- ntee_minor_codes - National Taxonomy of Exempt Entities (NTEE) Minor codes. See complete list link
- subsection_codes - IRS Subsection codes. See complete list link
- foundation_codes New - Foundation codes. See complete list link
- bmf status New - Flag indicating whether organization has the most recent IRS BMF - Null/True/False.
- pub78 verified New - Flag indicating whether organization is pub78 verified - Null/True/False.
- affiliation_type
- parent, subordinate, independent, headquarter - True/False.
- specific_exclusions
- exclude_revoked_organizations, exclude_defunct_or_merged_organizations - True/False.
- number_of_employees_range
- min - Minimum number of employees.
- max - Maximum number of employees.
- form_types
- f990, f990pf, indepenrequired_to_file_990tdent - True/False.
- audits
- a_133_audit_performed - True/False.
- financials
- form990_total_revenue
- min - Minimum revenue.
- max - Maximum revenue.
- form990_total_expenses
- min - Minimum expense.
- max - Maximum expense.
- form990_total_assets
- min - Minimum asset.
- max - Maximum asset.
HTTP Response Codes
HTTP JSON Response
Below is an actual response of searching for a "guidestar".{ "code": 200, "message": "Request was processed successfully!", "took": 42, "errors": [], "data": { "took": 39, "total_hits": 1, "hits": [ { "organization_id": "7831216", "bridge_id": "7349589081", "ein": "54-1774039", "organization_name": "GuideStar USA", "also_known_as": "GuideStar", "mission": "GuideStar USA, Inc.'s mission is to revolutionize philanthropy and nonprofit practice by providing information that advances transparency, enables users to make better decisions, and encourages charitable giving.", "address_line_1": "4801 Courthouse St", "address_line_2": "Ste. 220", "city": "Williamsburg", "state": "VA", "zip": "23188", "county": "James City", "msa": "VA - Norfolk-Virginia Beach-Newport News, VA-NC", "lat_long": "37.3268,-76.7606", "ntee_code": "T50 Philanthropy / Charity / Voluntarism Promotion (General)", "profile_level": "PLATINUM", "public_report": "https://www.guidestar.org/profile/54-1774039", "subsection_code": "501(c)(3) Public Charity", "number_of_employees": "95", "form_type": "990", "website_url": "www.guidestar.org", "logo_url": "https://wwwguidestar.org/...", New "foundation_code": "15", "parent_orgs": "", // RFU "bmf_gross_receipts": "11269539", "bmf_assets": "3965331", "form990_total_revenue": "11253739", "form990_total_expenses": "12792537", "form990_total_assets": "3965331", "contact_email": "jackie.enterline@guidestar.org", "contact_name": "Ms. Jackie Enterline", "contact_phone": "(202) 637-760", "contact_title": "Marketing & Communications Manager", "properties": { "parent": false, "subordinate": false, "independent": true, "national_hq": false, "revoked": false, "defunct_or_merged": false, "audit_a133_performed": false, "bmf_status": true, "pub78_verified": true, "allow_online_giving": true } } ] } }
Example Summaries
{ search_terms: "54-1774039" }
{ search_terms: "guidestar" }
Hint: You need a search_term or a filter
{ search_terms: "soccer" }
Hint: You need a search_term or a filter
{ filters: { geography: { state: ["CA", "VA"], } } }
{ search_terms: "soccer", filters: { geography: { state: ["CA", "VA"], } } }
- relevancy (default)
- organization_name
- bmf_gross_receipts
- bmf_assets
// defaults to 'relevancy' based sort { search_terms: "soccer" } // sort by 'organization name' in an ascending order { search_terms: "soccer", sort: { sort_by: "organization_name", ascending: true }, } // sort by 'bmf gross receipts' in an ascending order { search_terms: "soccer", sort: { sort_by: "bmf_gross_receipts", ascending: true }, } // sort by 'bmf assets' in an ascending order { search_terms: "soccer", sort: { sort_by: "bmf_assets", ascending: true }, }
// fetch first 10 hits (page 1) { search_terms: "soccer", from: 0, size: 10, }
// fetch next 10 hits (page 2) { search_terms: "soccer", from: 10, size: 10, }
{ search_terms: "soccer", filters: { geography: { zip: "23188" } } }
Hint: Exceeding 50 miles will default to 50 miles
{ search_terms: "soccer", filters: { geography: { zip: "23188", radius: 50 } } }
You can use the MSA Lookup tool to access complete list.
{ search_terms: "soccer", filters: { geography: { msa: [ "AK - Anchorage", "AL - Dothan" ] } } }
{ search_terms: "soccer", filters: { geography: { city: [ "Williamsburg" ] } } }
{ search_terms: "soccer", filters: { geography: { county: [ "New York", "Norfolk" ] } } }
Examples demonstrate the use of the full string, code only, and first letter.
You can use the NTEE Major Code Lookup tool to access and reference the complete list.
// using full string { search_terms: "nonprofit", filters: { organization: { ntee_major_codes: [ "A_artsCultureAndHumanities" ] } } } // using code only { search_terms: "nonprofit", filters: { organization: { ntee_major_codes: [ "A00" ] } } } // using first letter { search_terms: "nonprofit", filters: { organization: { ntee_major_codes: [ "A" ] } } }
Examples demonstrate the use of the full string and code.
You can use the NTEE Minor Code Lookup tool to access and reference the complete list.
// using full string { search_terms: "nonprofit", filters: { organization: { ntee_minor_codes: [ "A03 Professional Societies, Associations" ] } } } // using code only { search_terms: "nonprofit", filters: { organization: { ntee_minor_codes: [ "A03" ] } } }
You can use the IRS Subsection Code Lookup tool to access and reference the complete list.
{ search_terms: "nonprofit", filters: { organization: { subsection_codes: [ "501(c)(3) Public Charity" ] } } }
You can use the Foundation Code Lookup tool to access and reference the complete list.
{ search_terms: "nonprofit", filters: { organization: { foundation_codes: [ "15" ] } } }
New
Searching for search_terms "nonprofit", filtering by the specified bmf_status// filtering organizations that // have the most recent IRS BMF { search_terms: "nonprofit", filters: { organization: { bmf_status: true } } } // filtering organizations that // does not have the most recent IRS BMF { search_terms: "nonprofit", filters: { organization: { bmf_status: false } } } // you can either omit the filter or set to 'null' // to ignore the filter like 2 examples below { search_terms: "nonprofit", filters: { organization: { bmf_status: null } } } or { search_terms: "nonprofit" }
New
Searching for search_terms "nonprofit", filtering by the specified pub78_verfified// filtering organizations that // are Pub78 Verified { search_terms: "nonprofit", filters: { organization: { pub78_verified: true } } } // filtering organizations that // aren't Pub78 Verified { search_terms: "nonprofit", filters: { organization: { pub78_verified: false } } } // you can either omit the filter or set to 'null' // to ignore the filter like 2 examples below { search_terms: "nonprofit", filters: { organization: { pub78_verified: null } } } or { search_terms: "nonprofit" }
// filter parent { search_terms: "nonprofit", filters: { organization: { affiliation_type: { parent: true, subordinate: false, independent: false, headquarter: false }, } } } // filter parent with others omitted // you can omit the filters that you don't want // so, below will achieve the same search behavior { search_terms: "nonprofit", filters: { organization: { affiliation_type: { parent: true }, } } } // filter subordinate { search_terms: "nonprofit", filters: { organization: { affiliation_type: { subordinate: true }, } } } // filter independent { search_terms: "nonprofit", filters: { organization: { affiliation_type: { independent: true }, } } } // filter headquarter { search_terms: "nonprofit", filters: { organization: { affiliation_type: { headquarter: true }, } } } // filter parent and headquarter { search_terms: "nonprofit", filters: { organization: { affiliation_type: { parent: true, headquarter: true }, } } }
// excluding revoked organizations { search_terms: "nonprofit", filters: { organization: { specific_exclusions: { exclude_revoked_organizations: true }, } } } // excluding defunct or merged organizations { search_terms: "nonprofit", filters: { organization: { specific_exclusions: { exclude_defunct_or_merged_organizations: true }, } } } // excluding revoked, defunct or merged organizations { search_terms: "nonprofit", filters: { organization: { specific_exclusions: { exclude_revoked_organizations: true, exclude_defunct_or_merged_organizations: true }, } } }
// between 1 and 100 { search_terms: "nonprofit", filters: { organization: { number_of_employees_range: { min: 1, max: 100 } } } } // less than or equal to 100 // you can set the min to 0 or omit the field { search_terms: "nonprofit", filters: { organization: { number_of_employees_range: { min: 0, max: 100 } } } } // greater than or equal to 100 // you can set the max to 0 or omit the field { search_terms: "nonprofit", filters: { organization: { number_of_employees_range: { min: 100, max: 0 } } } }
// filter f990 { search_terms: "nonprofit", filters: { organization: { form_types: { f990: true } } } } // filter f990pf { search_terms: "nonprofit", filters: { organization: { form_types: { f990pf: true } } } } // filter required_to_file_990t { search_terms: "nonprofit", filters: { organization: { form_types: { required_to_file_990t: true } } } }
{ search_terms: "nonprofit", filters: { organization: { audits: { a_133_audit_performed: true } } } }
// between $10,000 and $100,000 { search_terms: "nonprofit", filters: { financials: { form990_total_revenue: { min: 10000, max: 100000 } } } } // less than or equal to $100,000 // you can set the min to 0 or omit the field { search_terms: "nonprofit", filters: { financials: { form990_total_revenue: { min: 0, max: 100000 } } } } // greater than or equal to $100,000 // you can set the max to 0 or omit the field { search_terms: "nonprofit", filters: { financials: { form990_total_revenue: { min: 100000, max: 0 } } } }
// between $10,000 and $100,000 { search_terms: "nonprofit", filters: { financials: { form990_total_expenses: { min: 10000, max: 100000 } } } } // less than or equal to $100,000 // you can set the min to 0 or omit the field { search_terms: "nonprofit", filters: { financials: { form990_total_expenses: { min: 0, max: 100000 } } } } // greater than or equal to $100,000 // you can set the max to 0 or omit the field { search_terms: "nonprofit", filters: { financials: { form990_total_expenses: { min: 100000, max: 0 } } } }
// between $10,000 and $100,000 { search_terms: "nonprofit", filters: { financials: { form990_total_assets: { min: 10000, max: 100000 } } } } // less than or equal to $100,000 // you can set the min to 0 or omit the field { search_terms: "nonprofit", filters: { financials: { form990_total_assets: { min: 0, max: 100000 } } } } // greater than or equal to $100,000 // you can set the max to 0 or omit the field { search_terms: "nonprofit", filters: { financials: { form990_total_assets: { min: 100000, max: 0 } } } }
Example Codes
using System; using System.Net.Http; using System.Net.Http.Headers; using System.Text; using System.Threading.Tasks; using Newtonsoft.Json; namespace Sample { static class Program { static void Main() { MakeRequestWithResponse(); Console.ReadLine(); } static async void MakeRequestWithResponse() { var response = await MakeRequest(); if (response.IsSuccessStatusCode) { string x = await response.Content.ReadAsStringAsync(); Console.WriteLine(x); } else { Console.WriteLine("Error occurred: " + response.StatusCode); } Console.WriteLine("Hit ENTER to exit..."); } static Task<HttpResponseMessage> MakeRequest() { var client = new HttpClient(); // Request headers client.DefaultRequestHeaders.Add("Subscription-Key", "{Your Subscription Key}"); var uri = "https://apidata.guidestar.org/essentials/v2"; // Request body var requestObject = new { search_terms = "guidestar", from = 0, size = 25, }; var requestJson = JsonConvert.SerializeObject(requestObject); byte[] byteData = Encoding.UTF8.GetBytes(requestJson); var content = new ByteArrayContent(byteData); content.Headers.ContentType = new MediaTypeHeaderValue("application/json"); return client.PostAsync(uri, content); } } }
Charity Check API
GuideStar Charity Check is the only pre-grant due-diligence tool that is 100% compliant with IRS requirements. The GuideStar Charity Check API provides this essential data via our RESTful API in JSON and PDF formats.
Retrieving Specific Organization's Charity Check Information
HTTP Request
GET: https://apidata.guidestar.org/charitycheck/v1/{EIN}
URL Parameters
HTTP Responses
Retrieving Bulk of Organization's Charity Check Information
HTTP Request
POST: https://apidata.guidestar.org/charitycheckbulk/v1
HTTP Request Body
{ "eins": [ "54-1774039", "56-2618866", "94-2618409" ] }
HTTP Responses
Retrieving Specific Organization's PDF Charity Check Information
HTTP Request
GET: https://apidata.guidestar.org/charitycheckpdf/v1/pdf/{EIN}
URL Parameters
HTTP Responses
Premier API
The 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.
Retrieving Specific Organization's Profile
HTTP Request
GET: https://apidata.guidestar.org/premier/v2/{OrganizationID}
URL Parameters
HTTP Responses
HTTP JSON Response
Below is an example showing all available elements.{ "code": 200, "message": "OK", "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", "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", "website_url": "string", "year_founded": "string", "year_incorporated": "string", "is_non_bmf_org": true, "first_on_bmf_date": "2019-01-28T18:27:34.261Z", "last_on_bmf_date": "2019-01-28T18:27:34.261Z", "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": "string" } ], "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" } ] }, "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": "2019-01-28T18:27:34.263Z", "period_end": "2019-01-28T18:27:34.263Z", "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": "string", "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": "2019-01-28T18:27:34.265Z", "period_end": "2019-01-28T18:27:34.265Z", "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" } ], "pf990_financials": [ { "period_begin": "2019-01-28T18:27:34.265Z", "period_end": "2019-01-28T18:27:34.265Z", "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_investments": 0, "revenue_special_events": 0, "revenue_sales": 0, "revenue_other": 0, "total_revenue": 0, "expense_grants": 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, "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 } ], "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, "categories": [ { "category": "string", "org_does_not_collect_for": {}, "subcategories": [ { "subcategory": "string", "staff_levels": [ { "staff_level": "string", "count": 0 } ] } ] } ] }, "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" } ] } } }
Retrieving Specific Organization's Pro PDF Information
HTTP Request
GET: https://apidata.guidestar.org/premier/v1/propdf/{EIN}
URL Parameters
HTTP Responses
Retrieving Specific Organization's Financial Trend Analysis PDF Information
HTTP Request
GET: https://apidata.guidestar.org/premier/v1/ftapdf/{EIN}