> ## 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 or id > Returns organization details for an EIN, with or without the hyphen, or an Endaoment organization id. No authentication is required. ## OpenAPI ````yaml https://api.dev.endaoment.org/oas-json get /v1/orgs/{identifier} 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.dev.endaoment.org description: Dev (canary) 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/{identifier}: get: tags: - Nonprofit Organizations summary: Get organization by EIN or id description: |2- Returns organization details for an EIN, with or without the hyphen, or an Endaoment organization id. No authentication is required. operationId: OrgsController_findByIdentifier_v1 parameters: - name: identifier required: true in: path description: >- IRS Employer Identification Number, with or without hyphen, or the Endaoment organization id. examples: ein: summary: EIN value: '530196605' hyphenatedEin: summary: EIN with hyphen value: 53-0196605 id: summary: Endaoment organization id value: 6ef86866-e694-4936-9ced-13e57e17c215 schema: {} responses: '200': description: Organization details content: application/json: schema: $ref: '#/components/schemas/OrgDetailsDto' '400': description: The identifier is neither an EIN nor an organization id '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: {} ````