Organization Details

← Back to Question Bank

Details

Sample version of the rendered form.

Primary Applicant Organization Details

Organization Legal Name*

The organization's legal name

Employer Identification Number (EIN)

The organization's Employer Identification Number

Unique Entity Identifier (UEI)

The organization's Unique Entity Identifier from SAM.gov

DUNS Number

The organization's DUNS number

Mission Statement

The organization's mission statement

Year Founded

The calendar year the organization was founded

Address

Street Address (Line 1)*

The primary street address line

Street Address (Line 2)

Additional street address information

City*

The city or municipality

State*

The US state, territory, or "Outside the US"

Country*

The country

Postal Code*

The postal or ZIP code

Phone Number

Country Code*

The international country code (e.g., "+1" for US/Canada).

Phone Number*

The local phone number without the country code.

Extension

Optional extension number for the phone line.

Is Mobile?

Indicates whether this is a mobile/cell phone number.

Organization Email Address

The organization's primary 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.

type: object
required:
  - name
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
    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
    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
    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
    type: string
    examples:
      - '2025'
    pattern: ^[0-9]{4}$
  address:
    description: The organization's primary address
    $schema: https://json-schema.org/draft/2020-12/schema
    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
        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
    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
    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"
  }
}