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
    • NTEE Major Codes
    • NTEE Minor Codes
    • IRS Subsections
    • Foundation Codes
    • MSA
    • Counties
    • Cities
    • Geographic Areas Listing (State, MSA, County, and City)

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}

HTTP Request

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: {
      total_revenue: {
        min: 0,
        max: 0
      },
      total_expenses: {
        min: 0,
        max: 0
      },
      total_assets: {
        min: 0,
        max: 0
      }
    }
  }
}
                

HTTP Response Codes

HTTP JSON Response

{
  "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": "",
        "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"
}
                                

{
  search_terms: "soccer"
}
                                

{
  filters: {
    geography: {
      state: ["CA", "VA"],
    }
  }
}
                                

{
  search_terms: "soccer",
  filters: {
    geography: {
      state: ["CA", "VA"],
    }
  }
}
                                

// 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"
    }
  }
}
                                

{
  search_terms: "soccer",
  filters: {
    geography: {
      zip: "23188",
      radius: 50
    }
  } 
}

{
  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"
      ]
    }
  }
}
                                

// 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"
      ]
    }
  }
}
                                

// 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"
      ]
    }
  }
}
                                

{
  search_terms: "nonprofit",
  filters: {
    organization: {
      subsection_codes: [
        "501(c)(3) Public Charity"
      ]
    }
  }
}
                                

{
  search_terms: "nonprofit",
  filters: {
    organization: {
      foundation_codes: [
        "15"
      ]
    }
  }
}
                                

// 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"
}
                                

// 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: false
      },
    }
  }
}
// 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);
        }
    }
}                      

Retrieving Specific Organization's Charity Check Information

HTTP Request

URL Parameters

HTTP Responses

HTTP Request

HTTP Request Body

  {
    "eins": [
      "54-1774039",
      "56-2618866",
      "94-2618409"
    ]
  }
                

HTTP Responses

Retrieving Specific Organization's PDF Charity Check Information

HTTP Request

URL Parameters

HTTP Responses

Retrieving Specific Organization's Profile

HTTP Request

URL Parameters

HTTP Responses

HTTP JSON Response

{
  "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

URL Parameters

HTTP Responses

Retrieving Specific Organization's Financial Trend Analysis PDF Information

HTTP Request

URL Parameters

HTTP Responses