Organizations#

How to describe an organization — the manufacturers, labs, and publishers other records point at.

Identity is the same_as registry link (ROR, Wikidata); the body carries the display name and its variants.
Other records point here: manufacturer.id on specs, publisher on datasets.
An editorial block records curation decisions (for example, supersession on a name change).

Define one#

A manufacturer#

Python

from battinfo.api import create_organization

record = create_organization(
    name="Example Instruments",
    type="Manufacturer",
    legal_name="Example Instruments GmbH",
    url="https://www.example-instruments.test",
    same_as=["https://ror.org/000000000"],
    location={"address_country": "DE", "address_locality": "Ulm"},
    description="Fictional bench-equipment manufacturer for this example.",
    source_url="https://www.example-instruments.test",
    retrieved_at=1750000000,
)

Canonical record

{
  "schema_version": "0.2.0",
  "organization": {
    "id": "https://w3id.org/battinfo/organization/7d9k-2m4p-8t3x-6nq5",
    "short_id": "7d9k2m",
    "name": "Example Instruments",
    "type": "Manufacturer",
    "legal_name": "Example Instruments GmbH",
    "url": "https://www.example-instruments.test",
    "same_as": [
      "https://ror.org/000000000"
    ],
    "location": {
      "address_country": "DE",
      "address_locality": "Ulm"
    },
    "description": "Fictional bench-equipment manufacturer for this example."
  },
  "provenance": {
    "source_type": "manual",
    "retrieved_at": 1750000000,
    "battinfo_version": "0.7.0",
    "source_url": "https://www.example-instruments.test"
  }
}

JSON-LD

Emitted by record_to_jsonld, hosted-context mode.

{
  "@context": "https://w3id.org/battinfo/context/records/v1.json",
  "@type": "schema:Organization",
  "@id": "https://w3id.org/battinfo/organization/7d9k-2m4p-8t3x-6nq5",
  "schema:name": "Example Instruments",
  "schema:legalName": "Example Instruments GmbH",
  "schema:additionalType": "Manufacturer",
  "schema:url": "https://www.example-instruments.test",
  "schema:sameAs": {
    "@id": "https://ror.org/000000000"
  },
  "schema:address": {
    "@type": "schema:PostalAddress",
    "schema:addressCountry": "DE",
    "schema:addressLocality": "Ulm"
  },
  "schema:description": "Fictional bench-equipment manufacturer for this example.",
  "dcterms:source": {
    "@type": "prov:Entity",
    "dcterms:type": "manual",
    "prov:hadPrimarySource": {
      "@id": "https://www.example-instruments.test"
    },
    "prov:generatedAtTime": "2025-06-15T15:06:40+00:00"
  }
}

What to notice:

create_organization mints the IRI deterministically from the normalized name — creating “A123 Systems” twice lands on the same record.
Pure schema.org emission (schema:Organization, with Corporation/ResearchOrganization/… stacked when the type IS a schema.org class); same_as carries the Wikidata/ROR identity anchors.

Common examples#

A selection of real, validated records from the packaged examples corpus — each one click away, included from its single source under examples/. The full, living library is the registry: browse it there.

Fields#

Generated from the packaged JSON Schemas — the same files battinfo validate and the registry’s publish gate enforce. Every record also carries the shared envelope (schema_version, provenance, and optional notes, funding, contributor, license). Quantities are {value, unit} maps and may also carry value_basis (Measured, Conventional, Rated, or Nominal) and conditions (the parameters under which the value holds, each itself a quantity; a qualitative condition may be value_text alone). In JSON-LD, conditions ride a measurement node the quantity isOutputOf; the voltage_reference key instead becomes a hasMetrologicalReference datum on the quantity, beside its unit. When authoring, an instance references its spec with the spec_id= kwarg; the record stores the self-describing <type>_spec_id key shown in the tables below.

organization fields#

Schema: organization.schema.json · required at top level: schema_version, organization, provenance

The organization block:

Field	Type	Required	Description
`id`	→ OrganizationIri	yes	Canonical IRI of this organization record.
`short_id`	→ ShortId
`type`	`Organization` \| `Corporation` \| `Manufacturer` \| `ResearchOrganization` … (8 values)		Organization kind (schema.org type).
`name`	string	yes	Current preferred name of the organization.
`legalName`	string		DEPRECATED alias of `legal_name` (pre-snake_case spelling): accepted forever, normalized on round-trip, never taught.
`alternateName`	string or array of string		DEPRECATED alias of `alternate_name` (pre-snake_case spelling): accepted forever, normalized on round-trip, never taught.
`url`	string		Official website URL.
`same_as`	string or array of string		Canonical external IRIs (Wikidata, ROR, GRID, LEI) that identify this organization.
`location`	object		Headquarters or principal location.
`foundingDate`	string		DEPRECATED alias of `founding_date` (pre-snake_case spelling): accepted forever, normalized on round-trip, never taught.
`dissolutionDate`	string		DEPRECATED alias of `dissolution_date` (pre-snake_case spelling): accepted forever, normalized on round-trip, never taught.
`description`	string		Short description of the organization.
`parentOrganization`	→ OrganizationIri or object		DEPRECATED alias of `parent_organization` (pre-snake_case spelling): accepted forever, normalized on round-trip, never taught.
`legal_name`	string		Full legal name, if different from name.
`alternate_name`	string or array of string		Former names, abbreviations, or brand names (e.g. ‘LG Chem’ for LG Energy Solution).
`founding_date`	string		Year or ISO 8601 date the organization was founded.
`dissolution_date`	string		Year or ISO 8601 date the organization was dissolved, if applicable.
`parent_organization`	→ OrganizationIri or object		Parent organization, if this is a subsidiary or division.

Top-level editorial: Internal editorial metadata — not forwarded to the registry semantic payload.