# today.joblist.company

> A company or organization, described by anyone, like a wiki page: each author's record is one version. The record key is the organization's domain, normalised: the website's host name, lowercase, without 'www.' (e.g. 'example.org' for https://www.Example.org/jobs), at most 253 characters (a DNS name). When the author's handle equals that domain, the record is the organization's own.

- Kind: record
- Record key: any
- Authority: joblist.today
- Lexicon: 1
- Published by [joblist.today](https://lexicon.garden/identity/did:plc:jqaucxlucukeif3bltpuc7zx), the NSID's authority

## Links

- [Documentation](https://lexicon.garden/lexicon/did:plc:jqaucxlucukeif3bltpuc7zx/today.joblist.company)
- [Schema JSON](https://lexicon.garden/lexicon/did:plc:jqaucxlucukeif3bltpuc7zx/today.joblist.company/schema.json)
- [Analytics](https://lexicon.garden/lexicon/did:plc:jqaucxlucukeif3bltpuc7zx/today.joblist.company/analytics)

## Record (`today.joblist.company`)

Type: record · key any

### Properties

- `createdAt` (string · datetime, required): When this author first described the organization.
- `description` (string)
  - Constraints: maxLength: 30000, maxGraphemes: 3000
- `jobBoard` (ref)
  - Reference: `#jobBoard`
- `kind` (string): What sort of organization it is: a company, a cooperative, a nonprofit, a collective, a project, a public body. Apps show others as unknown.
  - Constraints: maxLength: 64, knownValues: company | cooperative | nonprofit | collective | project | public
- `links` (array): Other public pages of the organization (social profiles, wikipedia, etc.).
  - Constraints: maxLength: 20
  - `items` (string · uri)
- `locations` (array)
  - Constraints: maxLength: 50
  - `items` (ref)
    - Reference: `#location`
- `name` (string, required)
  - Constraints: maxLength: 1000, maxGraphemes: 100
- `tags` (array)
  - Constraints: maxLength: 20
  - `items` (string)
    - Constraints: maxLength: 640, maxGraphemes: 64
- `updatedAt` (string · datetime): When this author last saved this version. The most recently edited version is the one shown, unless the organization publishes its own.
- `url` (string · uri): The organization's website.

## #jobBoard (`today.joblist.company#jobBoard`)

Type: object

Where the organization publishes its jobs.

### Properties

- `id` (string): The organization's identifier at the provider.
  - Constraints: maxLength: 256
- `provider` (string)
  - Constraints: maxLength: 64, knownValues: ashby | greenhouse | lever | personio | recruitee | rippling | smartrecruiters | workable
- `url` (string · uri): Careers page, when there is no supported provider.

## #location (`today.joblist.company#location`)

Type: object

### Properties

- `address` (string)
  - Constraints: maxLength: 2000, maxGraphemes: 200
- `country` (string)
  - Constraints: maxLength: 1000, maxGraphemes: 100
- `countryCode` (string): ISO 3166-1 alpha-2 code of the country (e.g. 'DE'), alongside its name.
  - Constraints: minLength: 2, maxLength: 2
- `latitude` (string): Decimal degrees, as a string.
  - Constraints: maxLength: 32
- `longitude` (string): Decimal degrees, as a string.
  - Constraints: maxLength: 32
- `name` (string): City or place name.
  - Constraints: maxLength: 1000, maxGraphemes: 100

## Schema

```json
{
  "$type": "com.atproto.lexicon.schema",
  "defs": {
    "jobBoard": {
      "description": "Where the organization publishes its jobs.",
      "properties": {
        "id": {
          "description": "The organization's identifier at the provider.",
          "maxLength": 256,
          "type": "string"
        },
        "provider": {
          "knownValues": [
            "ashby",
            "greenhouse",
            "lever",
            "personio",
            "recruitee",
            "rippling",
            "smartrecruiters",
            "workable"
          ],
          "maxLength": 64,
          "type": "string"
        },
        "url": {
          "description": "Careers page, when there is no supported provider.",
          "format": "uri",
          "type": "string"
        }
      },
      "type": "object"
    },
    "location": {
      "properties": {
        "address": {
          "maxGraphemes": 200,
          "maxLength": 2000,
          "type": "string"
        },
        "country": {
          "maxGraphemes": 100,
          "maxLength": 1000,
          "type": "string"
        },
        "countryCode": {
          "description": "ISO 3166-1 alpha-2 code of the country (e.g. 'DE'), alongside its name.",
          "maxLength": 2,
          "minLength": 2,
          "type": "string"
        },
        "latitude": {
          "description": "Decimal degrees, as a string.",
          "maxLength": 32,
          "type": "string"
        },
        "longitude": {
          "description": "Decimal degrees, as a string.",
          "maxLength": 32,
          "type": "string"
        },
        "name": {
          "description": "City or place name.",
          "maxGraphemes": 100,
          "maxLength": 1000,
          "type": "string"
        }
      },
      "type": "object"
    },
    "main": {
      "key": "any",
      "record": {
        "properties": {
          "createdAt": {
            "description": "When this author first described the organization.",
            "format": "datetime",
            "type": "string"
          },
          "description": {
            "maxGraphemes": 3000,
            "maxLength": 30000,
            "type": "string"
          },
          "jobBoard": {
            "ref": "#jobBoard",
            "type": "ref"
          },
          "kind": {
            "description": "What sort of organization it is: a company, a cooperative, a nonprofit, a collective, a project, a public body. Apps show others as unknown.",
            "knownValues": [
              "company",
              "cooperative",
              "nonprofit",
              "collective",
              "project",
              "public"
            ],
            "maxLength": 64,
            "type": "string"
          },
          "links": {
            "description": "Other public pages of the organization (social profiles, wikipedia, etc.).",
            "items": {
              "format": "uri",
              "type": "string"
            },
            "maxLength": 20,
            "type": "array"
          },
          "locations": {
            "items": {
              "ref": "#location",
              "type": "ref"
            },
            "maxLength": 50,
            "type": "array"
          },
          "name": {
            "maxGraphemes": 100,
            "maxLength": 1000,
            "type": "string"
          },
          "tags": {
            "items": {
              "maxGraphemes": 64,
              "maxLength": 640,
              "type": "string"
            },
            "maxLength": 20,
            "type": "array"
          },
          "updatedAt": {
            "description": "When this author last saved this version. The most recently edited version is the one shown, unless the organization publishes its own.",
            "format": "datetime",
            "type": "string"
          },
          "url": {
            "description": "The organization's website.",
            "format": "uri",
            "type": "string"
          }
        },
        "required": [
          "name",
          "createdAt"
        ],
        "type": "object"
      },
      "type": "record"
    }
  },
  "description": "A company or organization, described by anyone, like a wiki page: each author's record is one version. The record key is the organization's domain, normalised: the website's host name, lowercase, without 'www.' (e.g. 'example.org' for https://www.Example.org/jobs), at most 253 characters (a DNS name). When the author's handle equals that domain, the record is the organization's own.",
  "id": "today.joblist.company",
  "lexicon": 1
}
```