Organization Details

← Back to Question Bank

Details

Sample version of the rendered form.

Primary Applicant Organization Details

Organization Legal Name*

Employer Identification Number (EIN)

Unique Entity Identifier (UEI)

DUNS Number

Mission Statement

Year Founded

Address

Street Address (Line 1)*

Street Address (Line 2)

City*

State*

Country*

Postal Code*

Phone Number

Country Code*

Phone Number*

Extension

Is Mobile?

Organization Email Address

Form Data

What the form data looks like when it is submitted.

{
  "name": "Example Organization",
  "ein": "12-3456789",
  "uei": "12ABC34DEF56",
  "duns": "123456789-1234",
  "mission": "To advance scientific research and education.",
  "yearFounded": "2025",
  "address": {
    "street1": "456 Main St",
    "street2": "Suite 100",
    "city": "Anytown",
    "state": "CA",
    "country": "US",
    "postalCode": "12345"
  },
  "phone": {
    "countryCode": "+1",
    "number": "444-456-1230",
    "isMobile": true
  },
  "email": "test@example.com"
}

CommonGrants Data

What the data looks like translated to the CommonGrants data model using the mapping-to-cg.

{
  "organizations": {
    "primary": {
      "name": "Example Organization",
      "ein": "12-3456789",
      "uei": "12ABC34DEF56",
      "duns": "123456789-1234",
      "mission": "To advance scientific research and education.",
      "yearFounded": "2025",
      "addresses": {
        "primary": {
          "street1": "456 Main St",
          "street2": "Suite 100",
          "city": "Anytown",
          "stateOrProvince": "CA",
          "country": "US",
          "postalCode": "12345"
        }
      },
      "phones": {
        "primary": {
          "countryCode": "+1",
          "number": "444-456-1230",
          "isMobile": true
        }
      },
      "emails": {
        "primary": "test@example.com"
      }
    }
  }
}

JSON Schema

Provides the structure and data validation for this question.

$id: QuestionOrgDetails.yaml
type: object
required:
  - name
unevaluatedProperties:
  not: {}
description: A composite question capturing key details about the primary applicant organization
x-ui-schema:
  type: Group
  label: Primary Applicant Organization Details
  elements:
    - type: Control
      scope: '#/properties/name'
      label: Organization Legal Name
    - type: Control
      scope: '#/properties/ein'
      label: Employer Identification Number (EIN)
    - type: Control
      scope: '#/properties/uei'
      label: Unique Entity Identifier (UEI)
    - type: Control
      scope: '#/properties/duns'
      label: DUNS Number
    - type: Control
      scope: '#/properties/mission'
      label: Mission Statement
    - type: Control
      scope: '#/properties/yearFounded'
      label: Year Founded
    - type: Group
      label: Address
      elements:
        - type: Control
          scope: '#/properties/address/properties/street1'
          label: Street Address (Line 1)
        - type: Control
          scope: '#/properties/address/properties/street2'
          label: Street Address (Line 2)
        - type: Control
          scope: '#/properties/address/properties/city'
          label: City
        - type: Control
          scope: '#/properties/address/properties/state'
          label: State
        - type: Control
          scope: '#/properties/address/properties/country'
          label: Country
        - type: Control
          scope: '#/properties/address/properties/postalCode'
          label: Postal Code
    - type: Group
      label: Phone Number
      elements:
        - type: Control
          scope: '#/properties/phone/properties/countryCode'
          label: Country Code
        - type: Control
          scope: '#/properties/phone/properties/number'
          label: Phone Number
        - type: Control
          scope: '#/properties/phone/properties/extension'
          label: Extension
        - type: Control
          scope: '#/properties/phone/properties/isMobile'
          label: Is Mobile?
    - type: Control
      scope: '#/properties/email'
      label: Organization Email Address
x-mapping-to-cg:
  organizations:
    primary:
      name:
        field: name
      ein:
        field: ein
      uei:
        field: uei
      duns:
        field: duns
      mission:
        field: mission
      yearFounded:
        field: yearFounded
      addresses:
        primary:
          street1:
            field: address.street1
          street2:
            field: address.street2
          city:
            field: address.city
          stateOrProvince:
            field: address.state
          country:
            field: address.country
          postalCode:
            field: address.postalCode
      phones:
        primary:
          countryCode:
            field: phone.countryCode
          number:
            field: phone.number
          extension:
            field: phone.extension
          isMobile:
            field: phone.isMobile
      emails:
        primary:
          field: email
x-mapping-from-cg:
  name:
    field: organizations.primary.name
  ein:
    field: organizations.primary.ein
  uei:
    field: organizations.primary.uei
  duns:
    field: organizations.primary.duns
  mission:
    field: organizations.primary.mission
  yearFounded:
    field: organizations.primary.yearFounded
  address:
    street1:
      field: organizations.primary.addresses.primary.street1
    street2:
      field: organizations.primary.addresses.primary.street2
    city:
      field: organizations.primary.addresses.primary.city
    state:
      field: organizations.primary.addresses.primary.stateOrProvince
    country:
      field: organizations.primary.addresses.primary.country
    postalCode:
      field: organizations.primary.addresses.primary.postalCode
  phone:
    countryCode:
      field: organizations.primary.phones.primary.countryCode
    number:
      field: organizations.primary.phones.primary.number
    extension:
      field: organizations.primary.phones.primary.extension
    isMobile:
      field: organizations.primary.phones.primary.isMobile
  email:
    field: organizations.primary.emails.primary
x-entity:
  - primaryOrg
x-tags:
  - organization
  - details
properties:
  name:
    type: string
    examples:
      - Example Organization
    description: The organization's legal name
  ein:
    description: The organization's Employer Identification Number
    $schema: https://json-schema.org/draft/2020-12/schema
    $id: employerTaxId.yaml
    type: string
    examples:
      - 12-3456789
    pattern: ^[0-9]{2}-[0-9]{7}$
  uei:
    description: The organization's Unique Entity Identifier from SAM.gov
    $schema: https://json-schema.org/draft/2020-12/schema
    $id: samUEI.yaml
    type: string
    examples:
      - 12ABC34DEF56
    pattern: ^[A-z0-9]{12}$
  duns:
    description: The organization's DUNS number
    $schema: https://json-schema.org/draft/2020-12/schema
    $id: duns.yaml
    type: string
    examples:
      - 123456789-1234
      - 12-345-6789
      - '123456789'
  mission:
    type: string
    examples:
      - To advance scientific research and education.
    description: The organization's mission statement
  yearFounded:
    description: The calendar year the organization was founded
    $schema: https://json-schema.org/draft/2020-12/schema
    $id: calendarYear.yaml
    type: string
    examples:
      - '2025'
    pattern: ^[0-9]{4}$
  address:
    description: The organization's primary address
    $schema: https://json-schema.org/draft/2020-12/schema
    $id: QuestionAddress.yaml
    type: object
    required:
      - street1
      - city
      - state
      - country
      - postalCode
    examples:
      - street1: 456 Main St
        street2: Suite 100
        city: Anytown
        state: CA
        country: US
        postalCode: '12345'
    x-ui-schema:
      type: Group
      label: Address
      elements:
        - type: Control
          scope: '#/properties/street1'
          label: Street Address (Line 1)
        - type: Control
          scope: '#/properties/street2'
          label: Street Address (Line 2)
        - type: Control
          scope: '#/properties/city'
          label: City
        - type: Control
          scope: '#/properties/state'
          label: State
        - type: Control
          scope: '#/properties/stateOrProvince'
          label: State or Province
          rule:
            effect: SHOW
            condition:
              scope: '#/properties/state'
              schema:
                pattern: ^Outside the US$
        - type: Control
          scope: '#/properties/country'
          label: Country
        - type: Control
          scope: '#/properties/postalCode'
          label: Postal Code
    x-mapping-to-cg:
      street1:
        field: street1
      street2:
        field: street2
      city:
        field: city
      stateOrProvince:
        field: state
      country:
        field: country
      postalCode:
        field: postalCode
    x-mapping-from-cg:
      street1:
        field: street1
      street2:
        field: street2
      city:
        field: city
      state:
        field: stateOrProvince
      country:
        field: country
      postalCode:
        field: postalCode
    x-tags:
      - generic
      - address
    properties:
      street1:
        type: string
        description: The primary street address line
      street2:
        type: string
        description: Additional street address information
      city:
        type: string
        description: The city or municipality
      state:
        description: The US state, territory, or "Outside the US"
        $schema: https://json-schema.org/draft/2020-12/schema
        $id: USState.yaml
        type: string
        enum:
          - AL
          - AK
          - AZ
          - AR
          - CA
          - CO
          - CT
          - DE
          - FL
          - GA
          - HI
          - ID
          - IL
          - IN
          - IA
          - KS
          - KY
          - LA
          - ME
          - MD
          - MA
          - MI
          - MN
          - MS
          - MO
          - MT
          - NE
          - NV
          - NH
          - NJ
          - NM
          - NY
          - NC
          - ND
          - OH
          - OK
          - OR
          - PA
          - RI
          - SC
          - SD
          - TN
          - TX
          - UT
          - VT
          - VA
          - WA
          - WV
          - WI
          - WY
          - DC
          - AS
          - GU
          - MP
          - PR
          - VI
          - Outside the US
      stateOrProvince:
        type: string
        description: State or province name (for non-US addresses)
      country:
        type: string
        description: The country
      postalCode:
        type: string
        description: The postal or ZIP code
  phone:
    description: The organization's primary phone number
    $schema: https://json-schema.org/draft/2020-12/schema
    $id: QuestionPhone.yaml
    type: object
    examples:
      - countryCode: '+1'
        number: 444-456-1230
        isMobile: true
      - countryCode: '+1'
        number: 555-123-4567
        extension: '123'
        isMobile: false
    x-ui-schema:
      type: Group
      label: Phone Number
      elements:
        - type: Control
          scope: '#/properties/countryCode'
          label: Country Code
        - type: Control
          scope: '#/properties/number'
          label: Phone Number
        - type: Control
          scope: '#/properties/extension'
          label: Extension
        - type: Control
          scope: '#/properties/isMobile'
          label: Is Mobile?
    x-mapping-to-cg:
      countryCode:
        field: countryCode
      number:
        field: number
      extension:
        field: extension
      isMobile:
        field: isMobile
    x-mapping-from-cg:
      countryCode:
        field: countryCode
      number:
        field: number
      extension:
        field: extension
      isMobile:
        field: isMobile
    x-tags:
      - generic
      - phone
    required:
      - countryCode
      - number
    properties:
      countryCode:
        type: string
        pattern: ^\+[1-9][0-9]{0,3}$
        description: The international country code (e.g., "+1" for US/Canada).
      number:
        type: string
        description: The local phone number without the country code.
      extension:
        type: string
        description: Optional extension number for the phone line.
      isMobile:
        type: boolean
        default: false
        description: Indicates whether this is a mobile/cell phone number.
  email:
    description: The organization's primary email address
    $schema: https://json-schema.org/draft/2020-12/schema
    $id: email.yaml
    type: string
    examples:
      - test@example.com
    format: email

UI Schema

Describes how to present the question in the form UI.

{
  "type": "Group",
  "label": "Primary Applicant Organization Details",
  "elements": [
    {
      "type": "Control",
      "scope": "#/properties/name",
      "label": "Organization Legal Name"
    },
    {
      "type": "Control",
      "scope": "#/properties/ein",
      "label": "Employer Identification Number (EIN)"
    },
    {
      "type": "Control",
      "scope": "#/properties/uei",
      "label": "Unique Entity Identifier (UEI)"
    },
    {
      "type": "Control",
      "scope": "#/properties/duns",
      "label": "DUNS Number"
    },
    {
      "type": "Control",
      "scope": "#/properties/mission",
      "label": "Mission Statement"
    },
    {
      "type": "Control",
      "scope": "#/properties/yearFounded",
      "label": "Year Founded"
    },
    {
      "type": "Group",
      "label": "Address",
      "elements": [
        {
          "type": "Control",
          "scope": "#/properties/address/properties/street1",
          "label": "Street Address (Line 1)"
        },
        {
          "type": "Control",
          "scope": "#/properties/address/properties/street2",
          "label": "Street Address (Line 2)"
        },
        {
          "type": "Control",
          "scope": "#/properties/address/properties/city",
          "label": "City"
        },
        {
          "type": "Control",
          "scope": "#/properties/address/properties/state",
          "label": "State"
        },
        {
          "type": "Control",
          "scope": "#/properties/address/properties/country",
          "label": "Country"
        },
        {
          "type": "Control",
          "scope": "#/properties/address/properties/postalCode",
          "label": "Postal Code"
        }
      ]
    },
    {
      "type": "Group",
      "label": "Phone Number",
      "elements": [
        {
          "type": "Control",
          "scope": "#/properties/phone/properties/countryCode",
          "label": "Country Code"
        },
        {
          "type": "Control",
          "scope": "#/properties/phone/properties/number",
          "label": "Phone Number"
        },
        {
          "type": "Control",
          "scope": "#/properties/phone/properties/extension",
          "label": "Extension"
        },
        {
          "type": "Control",
          "scope": "#/properties/phone/properties/isMobile",
          "label": "Is Mobile?"
        }
      ]
    },
    {
      "type": "Control",
      "scope": "#/properties/email",
      "label": "Organization Email Address"
    }
  ]
}

Mapping to CommonGrants

How to translate this question into the CommonGrants ProposalBase data model.

{
  "organizations": {
    "primary": {
      "name": {
        "field": "name"
      },
      "ein": {
        "field": "ein"
      },
      "uei": {
        "field": "uei"
      },
      "duns": {
        "field": "duns"
      },
      "mission": {
        "field": "mission"
      },
      "yearFounded": {
        "field": "yearFounded"
      },
      "addresses": {
        "primary": {
          "street1": {
            "field": "address.street1"
          },
          "street2": {
            "field": "address.street2"
          },
          "city": {
            "field": "address.city"
          },
          "stateOrProvince": {
            "field": "address.state"
          },
          "country": {
            "field": "address.country"
          },
          "postalCode": {
            "field": "address.postalCode"
          }
        }
      },
      "phones": {
        "primary": {
          "countryCode": {
            "field": "phone.countryCode"
          },
          "number": {
            "field": "phone.number"
          },
          "extension": {
            "field": "phone.extension"
          },
          "isMobile": {
            "field": "phone.isMobile"
          }
        }
      },
      "emails": {
        "primary": {
          "field": "email"
        }
      }
    }
  }
}

Mapping from CommonGrants

How to pre-fill this question with data from the ProposalBase data model.

{
  "name": {
    "field": "organizations.primary.name"
  },
  "ein": {
    "field": "organizations.primary.ein"
  },
  "uei": {
    "field": "organizations.primary.uei"
  },
  "duns": {
    "field": "organizations.primary.duns"
  },
  "mission": {
    "field": "organizations.primary.mission"
  },
  "yearFounded": {
    "field": "organizations.primary.yearFounded"
  },
  "address": {
    "street1": {
      "field": "organizations.primary.addresses.primary.street1"
    },
    "street2": {
      "field": "organizations.primary.addresses.primary.street2"
    },
    "city": {
      "field": "organizations.primary.addresses.primary.city"
    },
    "state": {
      "field": "organizations.primary.addresses.primary.stateOrProvince"
    },
    "country": {
      "field": "organizations.primary.addresses.primary.country"
    },
    "postalCode": {
      "field": "organizations.primary.addresses.primary.postalCode"
    }
  },
  "phone": {
    "countryCode": {
      "field": "organizations.primary.phones.primary.countryCode"
    },
    "number": {
      "field": "organizations.primary.phones.primary.number"
    },
    "extension": {
      "field": "organizations.primary.phones.primary.extension"
    },
    "isMobile": {
      "field": "organizations.primary.phones.primary.isMobile"
    }
  },
  "email": {
    "field": "organizations.primary.emails.primary"
  }
}