> ## Documentation Index > Fetch the complete documentation index at: https://docs.endaoment.org/llms.txt > Use this file to discover all available pages before exploring further. # Get organization by EIN > Returns enriched organization details for an EIN. This endpoint may resolve an existing database organization or, for trusted Endaoment server callers, create the organization from external nonprofit data when available. No authentication is required for existing organizations. ## OpenAPI ````yaml https://api.endaoment.org/oas-json get /v1/orgs/ein/{ein} openapi: 3.0.0 info: title: Endaoment API description: >- The official Endaoment API endpoints. Dev (canary) = newest features; Staging (stable) = pre-production. version: 0.0.0-dev contact: {} servers: - url: https://api.endaoment.org description: Production security: [] tags: - name: Partner Endpoints description: Tech-platform partner server-to-server APIs - name: Authentication description: OAuth callers, API keys, and session verification - name: Funds description: Donor-advised fund lifecycle - name: Donations description: Donation pledges, supported assets, and impact totals - name: Portfolios description: Investment portfolio catalog - name: Nonprofit Organizations description: Nonprofit lookup, subprojects, and missing-org intake - name: Grant Transfers description: Grant and entity transfers - name: Collaboration description: Collaborator recommendations and fund collaboration - name: Activity description: Public and scoped activity feeds paths: /v1/orgs/ein/{ein}: get: tags: - Nonprofit Organizations summary: Get organization by EIN description: |2- Returns enriched organization details for an EIN. This endpoint may resolve an existing database organization or, for trusted Endaoment server callers, create the organization from external nonprofit data when available. No authentication is required for existing organizations. operationId: OrgsController_findByEin_v1 parameters: - name: ein required: true in: path description: IRS Employer Identification Number, with or without hyphen. schema: example: '530196605' type: string responses: '200': description: Organization details content: application/json: schema: $ref: '#/components/schemas/OrgDetailsDto' '404': description: Organization not found components: schemas: OrgDetailsDto: type: object properties: id: type: string description: Unique identifier of the organization in Endaoment database. format: uuid example: 123e4567-e89b-12d3-a456-426614174000 nullable: true ein: type: object description: IRS Employer Identification Number (EIN) without hyphen example: '530196605' nullable: true name: type: string description: Name of the organization example: American Red Cross description: type: object description: Description or mission statement of the organization example: Providing disaster relief and emergency assistance nullable: true address: description: Physical address of the organization allOf: - $ref: '#/components/schemas/OrgAddress' website: type: object description: Website URL of the organization example: https://www.redcross.org nullable: true logo: type: string description: URL to the organization logo example: https://example.com/logo.png nteeCode: type: string description: NTEE (National Taxonomy of Exempt Entities) Code example: E91 externalDocs: url: https://nccs.urban.org/publication/irs-activity-codes description: Full NTEE Code List nteeDescription: type: string description: Human-readable description of the NTEE code example: Nursing, Convalescent (Geriatric and Nursing) featuredIndex: type: number description: Priority index for featured organizations (higher = shows first) example: 100 minimum: 0 claimedDateUtc: type: object description: UTC timestamp when the organization was claimed format: date-time example: '2024-03-20T10:30:00Z' nullable: true claimedType: type: string description: Type of organization claim enum: - WalletClaim - WireClaim example: DIRECT nullable: true claimed: type: boolean description: Whether the organization has been claimed example: true contractAddress: type: object description: Smart contract address on the default chain (deprecated) example: '0x1234567890123456789012345678901234567890' nullable: true deprecated: true deployments: description: >- List of smart contract deployments across different chains. Includes only deployed orgs. type: array items: $ref: '#/components/schemas/OrgDeployment' compliant: type: boolean description: Deprecated compliance flag. Use isCompliant instead. example: true deprecated: true isCompliant: type: boolean description: Whether the organization is currently compliant. example: true nonComplianceReasons: description: Reasons why the organization is non-compliant, when applicable. example: null nullable: true type: array items: type: string lifetimeContributionsUsdc: type: string description: >- Lifetime contributions to this organization in USDC micro-units (1000000 = 1 USD). example: '1000000' usdcBalance: type: string description: >- Current USDC balance of the organization contract in micro-units (1000000 = 1 USD). example: '2000000' financials: description: Financial information for the organization. allOf: - $ref: '#/components/schemas/Financials' socials: description: Social links for the organization. allOf: - $ref: '#/components/schemas/Socials' staffNotes: type: object description: >- Staff notes for this organization. Currently null for public organizations. example: null nullable: true paypalId: type: object description: PayPal ID of the organization, when available. example: null nullable: true partnerId: type: string description: Partner that onboarded the organization, when applicable. enum: - tgb - gg example: null nullable: true donationsReceived: type: number description: Number of inbound donations made to the organization. example: 42 grantsReceived: type: number description: Number of grants made to this organization. example: 7 required: - id - ein - name - description - address - website - logo - nteeCode - nteeDescription - featuredIndex - claimedDateUtc - claimedType - claimed - contractAddress - deployments - compliant - isCompliant - nonComplianceReasons - lifetimeContributionsUsdc - usdcBalance - financials - socials - staffNotes - paypalId - partnerId - donationsReceived - grantsReceived OrgAddress: type: object properties: line1: type: string description: Street address including building/apartment number example: 123 Main St nullable: true city: type: string description: City name example: San Francisco nullable: true state: type: string description: State or province code example: CA nullable: true zip: type: string description: Postal code example: '94105' nullable: true country: type: string description: ISO 3166-1 alpha-3 country code example: USA enum: - ABW - AFG - AGO - AIA - ALA - ALB - AND - ARE - ARG - ARM - ASM - ATA - ATF - ATG - AUS - AUT - AZE - BDI - BEL - BEN - BES - BFA - BGD - BGR - BHR - BHS - BIH - BLM - BLR - BLZ - BMU - BOL - BRA - BRB - BRN - BTN - BVT - BWA - CAF - CAN - CCK - CHE - CHL - CHN - CIV - CMR - COD - COG - COK - COL - COM - CPV - CRI - CUB - CUW - CXR - CYM - CYP - CZE - DEU - DJI - DMA - DNK - DOM - DZA - ECU - EGY - ERI - ESH - ESP - EST - ETH - FIN - FJI - FLK - FRA - FRO - FSM - GAB - GBR - GEO - GGY - GHA - GIB - GIN - GLP - GMB - GNB - GNQ - GRC - GRD - GRL - GTM - GUF - GUM - GUY - HKG - HMD - HND - HRV - HTI - HUN - IDN - IMN - IND - IOT - IRL - IRN - IRQ - ISL - ISR - ITA - JAM - JEY - JOR - JPN - KAZ - KEN - KGZ - KHM - KIR - KNA - KOR - KWT - LAO - LBN - LBR - LBY - LCA - LIE - LKA - LSO - LTU - LUX - LVA - MAC - MAF - MAR - MCO - MDA - MDG - MDV - MEX - MHL - MKD - MLI - MLT - MMR - MNE - MNG - MNP - MOZ - MRT - MSR - MTQ - MUS - MWI - MYS - MYT - NAM - NCL - NER - NFK - NGA - NIC - NIU - NLD - NOR - NPL - NRU - NZL - OMN - PAK - PAN - PCN - PER - PHL - PLW - PNG - POL - PRI - PRK - PRT - PRY - PSE - PYF - QAT - REU - ROU - RUS - RWA - SAU - SDN - SEN - SGP - SGS - SHN - SJM - SLB - SLE - SLV - SMR - SOM - SPM - SRB - SSD - STP - SUR - SVK - SVN - SWE - SWZ - SXM - SYC - SYR - TCA - TCD - TGO - THA - TJK - TKL - TKM - TLS - TON - TTO - TUN - TUR - TUV - TWN - TZA - UGA - UKR - UMI - URY - USA - UZB - VAT - VCT - VEN - VGB - VIR - VNM - VUT - WLF - WSM - XKX - YEM - ZAF - ZMB - ZWE nullable: true required: - line1 - city - state - zip - country OrgDeployment: type: object properties: chainId: type: number description: ID of the blockchain network where the contract is deployed example: 1 contractAddress: type: string description: Smart contract address on the specified chain example: '0x1234567890123456789012345678901234567890' usdcBalance: type: object description: >- Current USDC balance of the org contract in the smallest currency unit (1000000 = 1 USD) example: '2000000' nullable: true isDeployed: type: boolean description: >- Whether the org contract is deployed on the specified chain (true) or not (false). Even if a contract is not deployed, its address can already be used to receive direct transfer donations. example: true required: - chainId - contractAddress - usdcBalance - isDeployed Financials: type: object properties: form990FiscalYear: type: object description: Fiscal year of the latest Form 990. Deprecated and may be null. example: null nullable: true deprecated: true summary: description: >- Deprecated financial summary. Monetary values are expressed in USD cents. deprecated: true allOf: - $ref: '#/components/schemas/FinancialSummary' expenses: description: >- Deprecated expense summary. Monetary values are expressed in USD cents. deprecated: true allOf: - $ref: '#/components/schemas/FinancialExpenses' required: - form990FiscalYear - summary - expenses Socials: type: object properties: twitter: type: object description: Twitter/X profile URL for the organization. example: null nullable: true facebook: type: object description: Facebook profile URL for the organization. example: null nullable: true linkedin: type: object description: LinkedIn profile URL for the organization. example: null nullable: true instagram: type: object description: Instagram profile URL for the organization. example: null nullable: true required: - twitter - facebook - linkedin - instagram FinancialSummary: type: object properties: totalLiabilities: type: object description: Total liabilities in USD cents. Deprecated and may be null. example: null nullable: true deprecated: true totalAssets: type: object description: Total assets in USD cents. Deprecated and may be null. example: null nullable: true deprecated: true contributionsAll: type: object description: Revenue from contributions in USD cents. Deprecated and may be null. example: null nullable: true deprecated: true totalExpenses: type: object description: Total expenses in USD cents. Deprecated and may be null. example: null nullable: true deprecated: true totalRevenue: type: object description: Total revenue in USD cents. Deprecated and may be null. example: null nullable: true deprecated: true netIncome: type: object description: Net income in USD cents. Deprecated and may be null. example: null nullable: true deprecated: true required: - totalLiabilities - totalAssets - contributionsAll - totalExpenses - totalRevenue - netIncome FinancialExpenses: type: object properties: {} ````