Organization

An organization such as a company, business, institution, healthcare facility, or any formal business entity

21 properties

Schema

Properties

Property	Type	Mode	Description	Required
name	string	stored	Name of the organization Example: `"Acme Corporation"`	Required
alias	string[]	stored	Alternate names or trading names for the organization Example: `["Acme","Acme Corp"]`	Optional
legalName	string	stored	Legal registered name of the organization Example: `"Acme Corporation Inc."`	Optional
status	string	enum	Current operational status of the organization Values: `active, inactive, suspended, pending, dissolved` Example: `"active"`	Optional
identifier	Identifier[]	stored	Official identifiers from various systems - tax IDs (SIREN, SIRET, EIN, VAT), registration numbers (DUNS, LEI), etc. Supports all country-specific identification systems	Optional
telecoms	ContactPoint[]	stored	Contact points for the organization - phone numbers, emails, fax, etc. Supports multiple contacts with different purposes and priorities	Optional
onlinePresence	OnlinePresence[]	stored	Online presence - website, social media profiles (LinkedIn, Twitter, Facebook, GitHub, etc.)	Optional
address	PostalAddress[]	stored	Physical addresses of the organization (headquarters, branches, warehouses, mailing, etc.). Use the 'use' and 'label' fields to distinguish between address types	Required
foundingDate	Date	stored	Date when the organization was founded Example: `"2010-05-15"`	Optional
numberOfEmployees	number	stored	Number of employees Example: `250`	Optional
parentOrganization	Organization	stored	Parent organization if this is a subsidiary or division	Optional
childOrganizations	Organization[]	stored	List of subsidiary or child organizations	Optional
logo	string	stored	URL to the organization logo Example: `"https://example.com/logo.png"`	Optional
description	string	stored	Detailed description of the organization and its activities	Optional
shortDescription	string	stored	Brief description for summaries and previews	Optional
organizationType	string	stored	Legal form of organization (Corporation, LLC, SARL, NGO, Association, etc.) Example: `"Corporation"`	Optional
activities	BusinessActivity[]	stored	Business activities and industry sectors (primary and secondary). Supports multiple activity codes from different classification systems	Optional
bankAccounts	BankAccount[]	stored	Bank accounts of the organization (main, payroll, international, etc.)	Optional
contacts	OrganizationContact[]	stored	Professional contacts within the organization (sales representatives, managers, support agents, etc.)	Optional
slug	string	stored	URL-friendly identifier for the organization Example: `"acme-corporation"`	Optional
metadata	object	stored	Additional metadata for extensibility and custom fields	Optional

Examples

Example 1

{
  "@type": "Organization",
  "name": "Acme Corp",
  "alias": [
    "Acme",
    "Acme Corporation"
  ],
  "legalName": "Acme Corporation Inc.",
  "status": "active",
  "identifier": [
    {
      "@type": "Identifier",
      "system": "EIN",
      "value": "12-3456789",
      "type": "tax",
      "country": "US",
      "label": "US Employer Identification Number",
      "use": "official"
    },
    {
      "@type": "Identifier",
      "system": "DUNS",
      "value": "123456789",
      "type": "financial",
      "label": "D-U-N-S Number"
    }
  ],
  "telecoms": [
    {
      "@type": "ContactPoint",
      "system": "phone",
      "value": "+1-555-0100",
      "use": "work",
      "rank": 1,
      "label": "Main Office"
    },
    {
      "@type": "ContactPoint",
      "system": "email",
      "value": "contact@acme.com",
      "use": "work",
      "rank": 1,
      "label": "General Inquiries"
    },
    {
      "@type": "ContactPoint",
      "system": "email",
      "value": "sales@acme.com",
      "use": "work",
      "rank": 2,
      "label": "Sales Department"
    },
    {
      "@type": "ContactPoint",
      "system": "fax",
      "value": "+1-555-0101",
      "use": "work"
    }
  ],
  "onlinePresence": [
    {
      "@type": "OnlinePresence",
      "platform": "website",
      "url": "https://acme.com",
      "primary": true
    }
  ],
  "address": [
    {
      "@type": "PostalAddress",
      "use": "headquarters",
      "label": "Head Office",
      "streetAddress": "123 Main Street",
      "addressLocality": "San Francisco",
      "addressRegion": "CA",
      "postalCode": "94105",
      "addressCountry": "US",
      "latitude": 37.7749,
      "longitude": -122.4194
    },
    {
      "@type": "PostalAddress",
      "use": "mailing",
      "label": "Mailing Address",
      "postOfficeBoxNumber": "PO Box 5000",
      "addressLocality": "San Francisco",
      "addressRegion": "CA",
      "postalCode": "94105",
      "addressCountry": "US"
    }
  ],
  "foundingDate": "2010-05-15",
  "numberOfEmployees": 250,
  "organizationType": "Corporation",
  "slug": "acme-corp"
}

Example 2

{
  "@type": "Organization",
  "name": "City Hospital",
  "legalName": "City General Hospital LLC",
  "status": "active",
  "telecoms": [
    {
      "@type": "ContactPoint",
      "system": "phone",
      "value": "+1-555-0200",
      "use": "work",
      "label": "Main Reception"
    },
    {
      "@type": "ContactPoint",
      "system": "phone",
      "value": "+1-555-0911",
      "use": "emergency",
      "rank": 1,
      "label": "Emergency Room"
    },
    {
      "@type": "ContactPoint",
      "system": "email",
      "value": "info@cityhospital.org",
      "use": "work"
    },
    {
      "@type": "ContactPoint",
      "system": "email",
      "value": "appointments@cityhospital.org",
      "use": "work",
      "label": "Appointments"
    }
  ],
  "onlinePresence": [
    {
      "@type": "OnlinePresence",
      "platform": "website",
      "url": "https://cityhospital.org",
      "primary": true
    }
  ],
  "address": [
    {
      "@type": "PostalAddress",
      "use": "work",
      "label": "Main Hospital",
      "streetAddress": "456 Health Avenue",
      "addressLocality": "Boston",
      "addressRegion": "MA",
      "postalCode": "02115",
      "addressCountry": "US"
    }
  ],
  "organizationType": "Healthcare",
  "numberOfEmployees": 1200
}

Example 3

{
  "@type": "Organization",
  "name": "TechStart SARL",
  "legalName": "TechStart Société à Responsabilité Limitée",
  "status": "active",
  "identifier": [
    {
      "@type": "Identifier",
      "system": "SIREN",
      "value": "123456789",
      "type": "registration",
      "country": "FR",
      "issuer": "INSEE France",
      "label": "Numéro SIREN",
      "use": "official"
    },
    {
      "@type": "Identifier",
      "system": "SIRET",
      "value": "12345678900012",
      "type": "registration",
      "country": "FR",
      "label": "Numéro SIRET"
    },
    {
      "@type": "Identifier",
      "system": "VAT",
      "value": "FR12345678901",
      "type": "tax",
      "country": "FR",
      "label": "Numéro TVA Intracommunautaire"
    }
  ],
  "telecoms": [
    {
      "@type": "ContactPoint",
      "system": "phone",
      "value": "+33 1 42 00 00 00",
      "use": "work",
      "label": "Standard"
    },
    {
      "@type": "ContactPoint",
      "system": "email",
      "value": "contact@techstart.fr",
      "use": "work"
    }
  ],
  "onlinePresence": [
    {
      "@type": "OnlinePresence",
      "platform": "website",
      "url": "https://techstart.fr",
      "primary": true
    },
    {
      "@type": "OnlinePresence",
      "platform": "linkedin",
      "url": "https://linkedin.com/company/techstart",
      "handle": "techstart",
      "verified": true
    }
  ],
  "address": [
    {
      "@type": "PostalAddress",
      "use": "headquarters",
      "label": "Siège Social",
      "streetAddress": "10 Rue de la Paix",
      "addressLocality": "Paris",
      "postalCode": "75002",
      "addressCountry": "FR",
      "latitude": 48.8698,
      "longitude": 2.3308
    }
  ],
  "foundingDate": "2015-03-20",
  "numberOfEmployees": 45,
  "organizationType": "Corporation",
  "slug": "techstart-sarl"
}