Organization

OrganizationBase

An organization that can apply to or host funding opportunities.

Table

Property	Type	Required	Description
id	uuid	Yes	The organization’s unique identifier.
name	string	Yes	The organization’s legal name as registered with relevant authorities.
orgType	PCSOrgType	No	The organization’s type within the Philanthropy Classification System (PCS).
ein	employerTaxId	No	The organization’s Employer Identification Number (EIN).
uei	samUEI	No	The organization’s Unique Entity Identifier (UEI).
duns	duns	No	The organization’s Data Universal Numbering System (DUNS) number.
addresses	AddressCollection	No	Collection of physical addresses associated with the organization.
phones	PhoneCollection	No	Collection of phone numbers associated with the organization.
emails	EmailCollection	No	Collection of email addresses associated with the organization.
mission	string	No	The organization’s mission statement.
yearFounded	calendarYear	No	The calendar year the organization was founded.
socials	OrgSocialLinks	No	The organization’s social media and web presence links.
customFields	Record<CustomField>	No	Custom fields for the organization.

Formats

Example

A JSON example of this model.

{
  "id": "083b4567-e89d-42c8-a439-6c1234567890",
  "name": "Example Organization",
  "orgType": {
    "term": "Nonprofit",
    "class": "Organization types",
    "code": "UC000000",
    "description": "Nonprofit organization"
  },
  "ein": "19-1234567",
  "uei": "ABCD123456789",
  "duns": "123456789",
  "addresses": {
    "primary": {
      "street1": "456 Main St",
      "street2": "Suite 100",
      "city": "Anytown",
      "stateOrProvince": "CA",
      "country": "US",
      "postalCode": "12345"
    },
    "otherAddresses": {
      "satellite": {
        "street1": "456 Main St",
        "street2": "Suite 100",
        "city": "Anytown",
        "stateOrProvince": "CA",
        "country": "US",
        "postalCode": "12345"
      },
      "international": {
        "street1": "123 Rue Principale",
        "city": "Montreal",
        "stateOrProvince": "QC",
        "country": "CA",
        "postalCode": "H2Y 1C6"
      }
    }
  },
  "phones": {
    "primary": {
      "countryCode": "+1",
      "number": "444-456-1230",
      "isMobile": true
    },
    "fax": {
      "countryCode": "+1",
      "number": "555-123-4567",
      "extension": "123",
      "isMobile": false
    },
    "otherPhones": {
      "support": {
        "countryCode": "+1",
        "number": "333-456-1230",
        "isMobile": false
      },
      "marketing": {
        "countryCode": "+1",
        "number": "444-456-1230",
        "isMobile": true
      }
    }
  },
  "emails": {
    "primary": "info@example.com",
    "otherEmails": {
      "support": "support@example.com",
      "marketing": "marketing@example.com"
    }
  },
  "mission": "To provide support and resources to the community.",
  "yearFounded": "2024",
  "socials": {
    "website": "https://www.example.com",
    "facebook": "https://www.facebook.com/example",
    "twitterOrX": "https://x.com/example",
    "instagram": "https://www.instagram.com/example",
    "linkedin": "https://www.linkedin.com/company/example",
    "otherSocials": {
      "youtube": "https://www.youtube.com/example"
    }
  }
}

JSON Schema

The JSON Schema for this model.

$schema: https://json-schema.org/draft/2020-12/schema
$id: OrganizationBase.yaml
type: object
properties:
  id:
    $ref: uuid.yaml
    description: The organization's unique identifier.
  name:
    type: string
    description: The organization's legal name as registered with relevant authorities.
  orgType:
    $ref: PCSOrgType.yaml
    description: The organization's type within the Philanthropy Classification System (PCS).
  ein:
    $ref: employerTaxId.yaml
    description: The organization's Employer Identification Number (EIN), a unique identifier assigned by the IRS.
  uei:
    $ref: samUEI.yaml
    description: The organization's Unique Entity Identifier (UEI) from SAM.gov, used for federal contracting.
  duns:
    $ref: duns.yaml
    description: The organization's Data Universal Numbering System (DUNS) number, a unique identifier for businesses.
  addresses:
    $ref: AddressCollection.yaml
    description: Collection of physical addresses associated with the organization.
  phones:
    $ref: PhoneCollection.yaml
    description: Collection of phone numbers associated with the organization.
  emails:
    $ref: EmailCollection.yaml
    description: Collection of email addresses associated with the organization.
  mission:
    type: string
    description: The organization's mission statement.
  yearFounded:
    $ref: calendarYear.yaml
    description: The calendar year the organization was founded.
  socials:
    $ref: OrgSocialLinks.yaml
    description: Collection of the organization's social media and web presence links.
  customFields:
    $ref: "#/$defs/RecordCustomField"
    description: Custom fields for the organization.
required:
  - id
  - name
unevaluatedProperties:
  not: {}
examples:
  - id: 083b4567-e89d-42c8-a439-6c1234567890
    name: Example Organization
    orgType:
      term: Hospital
      class: Organization types
      description: Institutions with the primary purpose of providing in-patient physical and mental health services...
      code: EO000000
    ein: 12-3456789
    uei: AB1234567890
    duns: "123456789012"
    addresses:
      primary:
        street1: 456 Main St
        street2: Suite 100
        city: Anytown
        stateOrProvince: CA
        country: US
        postalCode: "12345"
      otherAddresses:
        satellite:
          street1: 456 Main St
          street2: Suite 100
          city: Anytown
          stateOrProvince: CA
          country: US
          postalCode: "12345"
        international:
          street1: 123 Rue Principale
          city: Montreal
          stateOrProvince: QC
          country: CA
          postalCode: H2Y 1C6
    phones:
      primary:
        countryCode: "+1"
        number: 444-456-1230
        isMobile: true
      fax:
        countryCode: "+1"
        number: 555-123-4567
        extension: "123"
        isMobile: false
      otherPhones:
        support:
          countryCode: "+1"
          number: 333-456-1230
          isMobile: false
        marketing:
          countryCode: "+1"
          number: 444-456-1230
          isMobile: true
    emails:
      primary: info@example.com
      otherEmails:
        support: support@example.com
        marketing: marketing@example.com
    mission: To provide support and resources to the community.
    yearFounded: "2024"
    socials:
      website: https://www.example.com
      facebook: https://www.facebook.com/example
      twitterOrX: https://x.com/example
      instagram: https://www.instagram.com/example
      linkedin: https://www.linkedin.com/company/example
      otherSocials:
        youtube: https://www.youtube.com/example
description: An organization that can apply for grants.
$defs:
  RecordCustomField:
    type: object
    properties: {}
    unevaluatedProperties:
      $ref: CustomField.yaml

TypeSpec

The TypeSpec code for this model.

/** An organization that can apply for grants. */
@example(Examples.Organization.exampleOrg)
@Versioning.added(CommonGrants.Versions.v0_2)
model OrganizationBase {
  /** The organization's unique identifier. */
  id: Types.uuid;

  /** The organization's legal name as registered with relevant authorities. */
  name: string;

  /** The organization's type within the Philanthropy Classification System (PCS). */
  orgType?: Fields.PCSOrgType;

  /** The organization's Employer Identification Number (EIN), a unique identifier assigned by the IRS. */
  ein?: Types.employerTaxId;

  /** The organization's Unique Entity Identifier (UEI) from SAM.gov, used for federal contracting. */
  uei?: Types.samUEI;

  /** The organization's Data Universal Numbering System (DUNS) number, a unique identifier for businesses. */
  duns?: Types.duns;

  /** Collection of physical addresses associated with the organization. */
  addresses?: Fields.AddressCollection;

  /** Collection of phone numbers associated with the organization. */
  phones?: Fields.PhoneCollection;

  /** Collection of email addresses associated with the organization. */
  emails?: Fields.EmailCollection;

  /** The organization's mission statement. */
  mission?: string;

  /** The calendar year the organization was founded. */
  yearFounded?: Types.calendarYear;

  /** Collection of the organization's social media and web presence links. */
  socials?: OrgSocialLinks;

  /** Custom fields for the organization. */
  customFields?: Record<Fields.CustomField>;
}

Changelog

Version	Changes	Schema
0.2.0	Added OrganizationBase model	OrganizationBase.yaml

OrgSocialLinks

A collection of social media and web presence links for an organization.

Table

Property	Type	Required	Description
website	url	No	The organization’s primary website URL.
facebook	url	No	The organization’s Facebook profile URL.
twitterOrX	url	No	The organization’s Twitter/X profile URL.
bluesky	url	No	The organization’s Bluesky profile URL.
instagram	url	No	The organization’s Instagram profile URL.
linkedin	url	No	The organization’s LinkedIn profile URL.
otherSocials	Record<url>	No	Additional social media profiles not covered by the standard fields.

Formats

Example

A JSON example of this model.

{
  "website": "https://www.example.com",
  "facebook": "https://www.facebook.com/example",
  "twitterOrX": "https://x.com/example",
  "bluesky": "https://bsky.app/profile/example",
  "instagram": "https://www.instagram.com/example",
  "linkedin": "https://www.linkedin.com/company/example",
  "otherSocials": {
    "youtube": "https://www.youtube.com/example",
    "tiktok": "https://tiktok.com/example"
  }
}

JSON Schema

The JSON Schema for this model.

$schema: https://json-schema.org/draft/2020-12/schema
$id: OrgSocialLinks.yaml
type: object
properties:
  website:
    type: string
    format: uri
    description: The organization's primary website URL.
  facebook:
    type: string
    format: uri
    description: The organization's Facebook profile URL.
  twitterOrX:
    type: string
    format: uri
    description: The organization's Twitter/X profile URL.
  bluesky:
    type: string
    format: uri
    description: The organization's BlueSky profile URL.
  instagram:
    type: string
    format: uri
    description: The organization's Instagram profile URL.
  linkedin:
    type: string
    format: uri
    description: The organization's LinkedIn profile URL.
  otherSocials:
    $ref: "#/$defs/RecordUrl"
    description: Additional social media profiles not covered by the standard fields.
unevaluatedProperties:
  not: {}
examples:
  - website: https://www.example.com
    facebook: https://www.facebook.com/example
    twitterOrX: https://x.com/example
    instagram: https://www.instagram.com/example
    linkedin: https://www.linkedin.com/company/example
    otherSocials:
      youtube: https://www.youtube.com/example
description: A collection of social media and web presence links for an organization.
$defs:
  RecordUrl:
    type: object
    properties: {}
    unevaluatedProperties:
      type: string
      format: uri

TypeSpec

The TypeSpec code for this model.

/** A collection of social media and web presence links for an organization. */
@example(Examples.Organization.exampleSocials)
@Versioning.added(CommonGrants.Versions.v0_2)
model OrgSocialLinks {
  /** The organization's primary website URL. */
  website?: url;

  /** The organization's Facebook profile URL. */
  facebook?: url;

  /** The organization's Twitter/X profile URL. */
  twitterOrX?: url;

  /** The organization's BlueSky profile URL. */
  bluesky?: url;

  /** The organization's Instagram profile URL. */
  instagram?: url;

  /** The organization's LinkedIn profile URL. */
  linkedin?: url;

  /** Additional social media profiles not covered by the standard fields. */
  otherSocials?: Record<url>;
}

Changelog

Version	Changes	Schema
0.2.0	Added OrgSocialLinks model	OrgSocialLinks.yaml