# app.xptracker.job.listing

> Published by [xptracker.app](https://lexicon.garden/identity/did:plc:sjdzta3aangdjnmvktxvei22)

✓ This is the authoritative definition for this NSID.

## Links

- [View on Lexicon Garden](https://lexicon.garden/lexicon/did:plc:sjdzta3aangdjnmvktxvei22/app.xptracker.job.listing)
- [Documentation](https://lexicon.garden/lexicon/did:plc:sjdzta3aangdjnmvktxvei22/app.xptracker.job.listing/docs)
- [Examples](https://lexicon.garden/lexicon/did:plc:sjdzta3aangdjnmvktxvei22/app.xptracker.job.listing/examples)

## Definitions

### `app.xptracker.job.listing`

**Type**: `record`

A job listing published on the AT Protocol.

**Key**: `tid`

| Property | Type | Required | Description |
|----------|------|----------|-------------|
| `title` | `string` | Yes | Job title or role name. |
| `skills` | `array` | No | Free-form skill labels for this listing. |
| `company` | `string` | Yes | Name of the hiring organization. |
| `jobType` | `ref` → `app.xptracker.job.defs#jobType` | No |  |
| `location` | `string` | No | Human-readable location string. |
| `postedAt` | `string` (datetime) | No | When the job was posted on the source platform. |
| `sourceId` | `string` | No | Identifier from the source system for deduplication. |
| `createdAt` | `string` (datetime) | Yes | When this record was created on the PDS. |
| `expiresAt` | `string` (datetime) | No | When the listing is expected to expire. |
| `sourceUri` | `string` (uri) | Yes | Canonical URL of the original job listing. |
| `provenance` | `ref` → `app.xptracker.job.defs#provenanceMethod` | No | How this record was created. |
| `description` | `string` | No | Full job description or body text. Plain text preferred. |
| `publisherDid` | `string` (did) | No | DID of the publishing entity, if different from repo owner. |
| `employmentType` | `ref` → `app.xptracker.job.defs#employmentType` | No |  |

## Raw Schema

```json
{
  "id": "app.xptracker.job.listing",
  "defs": {
    "main": {
      "key": "tid",
      "type": "record",
      "record": {
        "type": "object",
        "required": [
          "title",
          "company",
          "sourceUri",
          "createdAt"
        ],
        "properties": {
          "title": {
            "type": "string",
            "maxLength": 256,
            "description": "Job title or role name."
          },
          "skills": {
            "type": "array",
            "items": {
              "type": "string",
              "maxLength": 128
            },
            "maxLength": 100,
            "description": "Free-form skill labels for this listing."
          },
          "company": {
            "type": "string",
            "maxLength": 256,
            "description": "Name of the hiring organization."
          },
          "jobType": {
            "ref": "app.xptracker.job.defs#jobType",
            "type": "ref"
          },
          "location": {
            "type": "string",
            "maxLength": 256,
            "description": "Human-readable location string."
          },
          "postedAt": {
            "type": "string",
            "format": "datetime",
            "description": "When the job was posted on the source platform."
          },
          "sourceId": {
            "type": "string",
            "maxLength": 256,
            "description": "Identifier from the source system for deduplication."
          },
          "createdAt": {
            "type": "string",
            "format": "datetime",
            "description": "When this record was created on the PDS."
          },
          "expiresAt": {
            "type": "string",
            "format": "datetime",
            "description": "When the listing is expected to expire."
          },
          "sourceUri": {
            "type": "string",
            "format": "uri",
            "description": "Canonical URL of the original job listing."
          },
          "provenance": {
            "ref": "app.xptracker.job.defs#provenanceMethod",
            "type": "ref",
            "description": "How this record was created."
          },
          "description": {
            "type": "string",
            "maxLength": 100000,
            "description": "Full job description or body text. Plain text preferred."
          },
          "publisherDid": {
            "type": "string",
            "format": "did",
            "description": "DID of the publishing entity, if different from repo owner."
          },
          "employmentType": {
            "ref": "app.xptracker.job.defs#employmentType",
            "type": "ref"
          }
        }
      },
      "description": "A job listing published on the AT Protocol."
    }
  },
  "$type": "com.atproto.lexicon.schema",
  "lexicon": 1
}
```