> ## Documentation Index > Fetch the complete documentation index at: https://docs.givingcompass.org/llms.txt > Use this file to discover all available pages before exploring further. # Get Nonprofit Details ## OpenAPI ````yaml GET /nonprofits/details/{ein} openapi: 3.1.0 info: title: Giving Compass Insights description: >+ ## Overview The Giving Compass Insights API provides access to nonprofit data, impact stories, financial information, and AI-powered search capabilities. ## Authentication All endpoints require an API key passed via the `X-API-Key` header. ``` X-API-Key: your_api_key_here ``` ## Core Capabilities ### Nonprofit Search Search and filter nonprofits by location, revenue, expenses, cause areas, and Charity Navigator ratings. ### Impact Data Access AI-extracted impact stories and metrics from nonprofit annual reports: - **Stories**: Human transformation narratives with emotional hooks, quotes, and before/after states - **Metrics**: Quantitative measures (people served, meals distributed, volunteers, etc.) ### Feed Data Access and filter nonprofit posts (articles, events, videos, job postings) from organizations: - **Content Types**: Filter by classification (articles, videos, events, podcasts, job postings, volunteer opportunities) - **Location Filtering**: Filter posts by nonprofit's city, county, state, ZIP code, or geographic radius (lat/lng) - **Cause Area Filtering**: Filter by NTEE codes to find posts from organizations working in specific cause areas ### AI Chat Natural language search for nonprofits and content. Example queries: - `Find articles about clean water` - `Find nonprofits in Chicago with revenue over 100k` - `Show nonprofits in TX that help the blind` - `Nonprofits that are similar to JDRF` - `Nonprofits that focus on SDG 5 with revenue between 1M and 5M` version: 1.0.0 servers: - url: https://api.givingcompass.org/insights security: [] tags: - name: Insights description: >- Search nonprofits, retrieve financial data, and access AI-powered chat for nonprofit discovery. - name: Impact description: >- Access impact stories and metrics extracted from nonprofit annual reports. Stories are human transformation narratives with emotional hooks and quotes. Metrics are quantitative measures reported by nonprofits. - name: Feed description: >- Access nonprofit posts and content feeds with advanced filtering by location, cause area, and content type. Filter posts by organization location (city, county, state, ZIP, lat/lng radius) and NTEE codes - name: Beta description: Beta endpoints - may change without notice. paths: /nonprofits/details/{ein}: get: tags: - Insights summary: Get Nonprofit Details operationId: get_nonprofit_details_nonprofits_details__ein__get parameters: - name: ein in: path required: true schema: type: string minLength: 9 maxLength: 9 pattern: ^\d{9}$ title: EIN (Employer Identification Number) description: The unique 9 digit identifier assigned to businesses by the IRS description: The unique 9 digit identifier assigned to businesses by the IRS responses: '200': description: Successful Response content: application/json: schema: $ref: '#/components/schemas/InsightsNonprofitDetailsResponse' '422': description: Validation Error content: application/json: schema: $ref: '#/components/schemas/HTTPValidationError' security: - APIKeyHeader: [] components: schemas: InsightsNonprofitDetailsResponse: properties: ein: type: string title: Ein name: type: string title: Name alt_name: anyOf: - type: string - type: 'null' title: Alt Name url: anyOf: - type: string - type: 'null' title: Url summary: anyOf: - type: string - type: 'null' title: Summary streetAddress: anyOf: - type: string - type: 'null' title: Streetaddress city: anyOf: - type: string - type: 'null' title: City state: anyOf: - type: string - type: 'null' title: State zipCode5: anyOf: - type: string - type: 'null' title: Zipcode5 ntee: anyOf: - type: string - type: 'null' title: Ntee issueArea: anyOf: - type: string - type: 'null' title: Issuearea yearFounded: anyOf: - type: integer - type: 'null' title: Yearfounded filingYear: anyOf: - type: integer - type: 'null' title: Filingyear revenueGrandTotal: anyOf: - type: number - type: 'null' title: Revenuegrandtotal netAssets: anyOf: - type: number - type: 'null' title: Netassets foundation: anyOf: - type: boolean - type: 'null' title: Foundation inactive: anyOf: - type: boolean - type: 'null' title: Inactive gcVetted: anyOf: - type: boolean - type: 'null' title: Gcvetted irsRulingDate: anyOf: - type: string format: date - type: 'null' title: Irsrulingdate irsFilingUrl: anyOf: - type: string - type: 'null' title: Irsfilingurl sdgs: anyOf: - items: type: integer type: array - type: 'null' title: Sdgs logo: anyOf: - type: string - type: 'null' title: Logo formType: anyOf: - type: string - type: 'null' title: Formtype gcVideoUrl: anyOf: - type: string - type: 'null' title: Gcvideourl gcDonationUrl: anyOf: - type: string - type: 'null' title: Gcdonationurl lat: anyOf: - type: number - type: 'null' title: Lat lng: anyOf: - type: number - type: 'null' title: Lng impactSummary: anyOf: - type: string - type: 'null' title: Impactsummary type: object required: - ein - name - url - summary - streetAddress - city - state - zipCode5 - ntee - issueArea - yearFounded - filingYear - revenueGrandTotal - netAssets - foundation - inactive - gcVetted - irsRulingDate - irsFilingUrl - sdgs - logo - formType - gcVideoUrl - gcDonationUrl - lat - lng - impactSummary title: InsightsNonprofitDetailsResponse description: |- DTO for returning nonprofit details in the public Insights API. It contains a subset of the fields from NonprofitDetailsResponse. HTTPValidationError: properties: detail: items: $ref: '#/components/schemas/ValidationError' type: array title: Detail type: object title: HTTPValidationError ValidationError: properties: loc: items: anyOf: - type: string - type: integer type: array title: Location msg: type: string title: Message type: type: string title: Error Type type: object required: - loc - msg - type title: ValidationError securitySchemes: APIKeyHeader: type: apiKey description: Add a header [X-API-Key] with the token in: header name: X-API-Key ````