Introduction

The GuideStar APIs are RESTful. They are simple, predictable, and uses 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.

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/v1
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: [],
      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
      }
    }
  }
}
                
  • 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
      • 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 Code
Description
200
OK, all went through!
401
Access denied due to invalid subscription key. Make sure to provide a valid key for an active subscription.
403
Forbidden, we found insufficient to grant access to the resources. Please check the detailed message of the response. E.g., subscription or trial period has ended.
404
Not Found, search did not find anything!
429
Rate limit is exceeded. Try again later!
5xx
Internal Server Error, we had a problem with our server. Try again later.
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",
        "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 for...
Request Body
Searching for an organization using EIN. You can set the search_terms as "54-1774039" which is GuideStar's EIN.
{
  search_terms: "54-1774039"
}
                                
Searching for organization(s) using the name. You can set the search_terms as "guidestar".
{
  search_terms: "guidestar"
}
                                
Searching search_terms "soccer".

 

Hint: You need a search_term or a filter
{
  search_terms: "soccer"
}
                                
Search using a filter state "CA" and "VA" without search_terms.

 

Hint: You need a search_term or a filter
{
  filters: {
    geography: {
      state: ["CA", "VA"],
    }
  }
}
                                
Searching search_terms "soccer" that are in state of "CA" and "VA".
{
  search_terms: "soccer",
  filters: {
    geography: {
      state: ["CA", "VA"],
    }
  }
}
                                
Searching for search_terms "soccer" and ordering the result. Available options are,
  • 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
  },
}
                                
Searching search_terms "soccer" with pagination. Response will include first 10 hits. Pagination of results can be done by using the from and size parameters. The from parameter defines the offset from the first result you want to fetch. The from parameter allows you to configure the maximum amount of hits to be returned. from and size parameters are optional and when omitted, from defaults to 0 and sizedefaults to 25.
// fetch first 10 hits (page 1)
{
  search_terms: "soccer",
  from: 0,
  size: 10,
}
                                
Searching search_terms "soccer" with pagination. Response will include second 10 hits. In this example, from offset from the first result was set to 10, which means to fetch 10 h, from 11th position, query 10 hits.
// fetch next 10 hits (page 2)
{
  search_terms: "soccer",
  from: 10,
  size: 10,
}
                                
Searching search_terms "soccer" in zip 23188 (Williamsburg, VA).
{
  search_terms: "soccer",
  filters: {
    geography: {
      zip: "23188"
    }
  }
}
                                
Searching search_terms "soccer" within 50 miles radius of zip 23188 (Williamsburg, VA).

 

Hint: Exceeding 50 miles will default to 50 miles
{
  search_terms: "soccer",
  filters: {
    geography: {
      zip: "23188",
      radius: 50
    }
  } 
}
Searching search_terms "soccer" in the specified MSA

 

You can use the MSA Lookup tool to access complete list.

{
  search_terms: "soccer",
  filters: {
    geography: {
      msa: [
        "AK - Anchorage",
        "AL - Dothan"
      ]
    }
  }
}
                                
Searching search_terms "soccer" in the specified city of Williamsburg.
{
  search_terms: "soccer",
  filters: {
    geography: {
      city: [
        "Williamsburg"
      ]
    }
  }
}
                                
Searching search_terms "soccer" in the specified county
{
  search_terms: "soccer",
  filters: {
    geography: {
      county: [
        "New York",
        "Norfolk"
      ]
    }
  }
}
                                
Searching search_terms "nonprofit", filtering by the specified NTEE Major Codes

 

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"
      ]
    }
  }
}
                                
Searching for search_terms "nonprofit", filtering by the specified NTEE Minor Codes

 

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"
      ]
    }
  }
}
                                
Searching for search_terms "nonprofit", filtering by the specified subsection_codes

 

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"
      ]
    }
  }
}
                                
Searching for search_terms "nonprofit", filtering by the specified Affiliation Type parent, subordinate, independent, and headquarter
// 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
      },
    }
  }
}
                                
Searching for search_terms "nonprofit", filtering by the Specific Exclusion exclude_revoked_organizations and exclude_defunct_or_merged_organizations
// 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
      },
    }
  }
}
                                
Searching for search_terms "nonprofit", filtering by the number_of_employees_range between 1 and 100, less than or equal to 100, and greater than 100 or more.
// 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
      }
    }
  }
}
                                
Searching for search_terms "nonprofit", filtering by the IRS Form Type f990, f990pf, and required_to_file_990t
// 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
      }
    }
  }
}
                                
Searching for search_terms "nonprofit", filtering by the Audit a_133_audit_performed
{
  search_terms: "nonprofit",
  filters: {
    organization: {
      audits: {
        a_133_audit_performed: true
      }
    }
  }
}
                                
Searching for search_terms "nonprofit", filtering by the Financials form990_total_revenue between $10,000 and $100,000, less than or equal to $100,000, and greater than $100,000 or more.
// 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
      }
    }
  }
}
                                
Searching for search_terms "nonprofit", filtering by the Financials form990_total_expenses between $10,000 and $100,000, less than or equal to $100,000, and greater than $100,000 or more.
// 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
      }
    }
  }
}
                                
Searching for search_terms "nonprofit", filtering by the Financials form990_total_assets between $10,000 and $100,000, less than or equal to $100,000, and greater than $100,000 or more.
// 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/v1";
            // 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
Parameter
Description
EIN
The Organization Employer Identification Number (EIN)
HTTP Responses
HTTP Code
Description
200
OK, all went through!
401
Access denied due to invalid subscription key. Make sure to provide a valid key for an active subscription.
403
Forbidden, we found insufficient to grant access to the resources. Please check the detailed message of the response. E.g., subscription or trial period has ended.
404
Not Found, the specified EIN could not be found
429
Rate limit is exceeded. Try again later!
5xx
Internal Server Error, we had a problem with our server. Try again later.

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
HTTP Code
Description
200
OK, all went through!
206
Partially OK, there were one or more EIN(s) we could not find. We have returned what we can!
400
Bad Request, either you didn't provide an EIN or have exceeded maximum number of EINs allowed in the request
401
Access denied due to invalid subscription key. Make sure to provide a valid key for an active subscription.
403
Forbidden, we found insufficient to grant access to the resources. Please check the detailed message of the response. E.g., subscription or trial period has ended.
404
Not Found, the specified EIN could not be found
429
Rate limit is exceeded. Try again later!
5xx
Internal Server Error, we had a problem with our server. Try again later.

Retrieving Specific Organization's PDF Charity Check Information

HTTP Request
GET: https://apidata.guidestar.org/charitycheckpdf/v1/pdf/{EIN}

Note: When you try the API using the swagger, you will see byte stream being returned in the response. To see an actual PDF, you can just use the browser using the following URL format: Here is an example of GuideStar Charity Check PDF, https://apidata.guidestar.org/charitycheckpdf/v1/pdf/54-1774039?Subscription-Key={YourSubscriptionKey}
URL Parameters
Parameter
Description
EIN
The Organization Employer Identification Number (EIN)
HTTP Responses
HTTP Code
Description
200
OK, all went through! PDF byte stream is returned
401
Access denied due to invalid subscription key. Make sure to provide a valid key for an active subscription.
403
Forbidden, we found insufficient to grant access to the resources. Please check the detailed message of the response. E.g., subscription or trial period has ended.
404
Not Found, the specified EIN could not be found
429
Rate limit is exceeded. Try again later!
5xx
Internal Server Error, we had a problem with our server. Try again later.

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/v1/{OrganizationID}
URL Parameters
Parameter
Description
Organization ID
Unique Organization ID Organization Id can be retrieved using the Essentials (Search) API
HTTP Responses
HTTP Code
Description
200
OK, all went through!
401
Access denied due to invalid subscription key. Make sure to provide a valid key for an active subscription.
403
Forbidden, we found insufficient to grant access to the resources. Please check the detailed message of the response. E.g., subscription or trial period has ended.
404
Not Found, the specified Organization ID could not be found
429
Rate limit is exceeded. Try again later!
5xx
Internal Server Error, we had a problem with our server. Try again later.
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_premium_pdf": "string",
      "impact_statement": "string",
      "incorporation_year": "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",
      "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"
        }
      ],
      "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"
          ]
        }
      ],
      "charting_impact_answers": [
        {
          "question": "string",
          "answer": "string"
        }
      ]
    },
    "financials": {
      "most_recent_year_financials": {
        "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,
        "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,
        "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": "2018-03-15T13:43:14.419Z",
          "period_end": "2018-03-15T13:43:14.419Z",
          "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,
          "other_revenue": 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,
          "net_assets_eoy": 0,
          "assets_total": 0,
          "liabilities_total": 0,
          "months_of_cash": 0,
          "other_expense": 0,
          "income_total": 0
        }
      ],
      "pf990_financials": [
        {
          "period_begin": "2018-03-15T13:43:14.420Z",
          "period_end": "2018-03-15T13:43:14.420Z",
          "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
        }
      ],
      "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"
        }
      ],
      "highest_paid_employees": [
        {
          "name": "string",
          "title": "string",
          "type": [
            "string"
          ],
          "compensation": 0,
          "related_compensation": 0,
          "other_compensation": 0,
          "hours": "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_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"
        }
      ]
    }
  }
}