# com.tituslegaldesign.immigration.agreement

> Published by [287g-data.tituslegaldesign.com](https://lexicon.garden/identity/did:plc:2wxsvrr5qgqwxy53ebo4kqet)

✓ This is the authoritative definition for this NSID.

## Links

- [View on Lexicon Garden](https://lexicon.garden/lexicon/did:plc:2wxsvrr5qgqwxy53ebo4kqet/com.tituslegaldesign.immigration.agreement)
- [Documentation](https://lexicon.garden/lexicon/did:plc:2wxsvrr5qgqwxy53ebo4kqet/com.tituslegaldesign.immigration.agreement/docs)
- [Examples](https://lexicon.garden/lexicon/did:plc:2wxsvrr5qgqwxy53ebo4kqet/com.tituslegaldesign.immigration.agreement/examples)

## Definitions

### `com.tituslegaldesign.immigration.agreement#document`

**Type**: `object`

An archived source document. The blob's CID is a SHA-256 content hash of the exact bytes retrieved at retrievedAt, providing tamper-evident provenance even if the original is later altered or removed. sourceUrl is optional because documents obtained by FOIA production have no public URL; in that case obtainedVia should say so.

| Property | Type | Required | Description |
|----------|------|----------|-------------|
| `file` | `blob` | Yes | The document itself. |
| `obtainedVia` | `string` | No | How this copy was obtained. Defaults to public-url when sourceUrl is present. |
| `retrievedAt` | `string` (datetime) | Yes | When the document was retrieved and archived. |
| `sourceUrl` | `string` (uri) | No | Where the document was retrieved from (e.g. ICE's doclib URL). Absent for documents not published at a public URL. |
| `title` | `string` | No | Human-readable document title. |

### `com.tituslegaldesign.immigration.agreement`

**Type**: `record`

A single 287(g) agreement between ICE and a state or local law enforcement agency, as documented in the Titus Legal Design 287(g) Program Report. One record per agency + program-model combination. The record key (rkey) is a permanent human-readable slug assigned by the publisher (e.g. 'ga-tift-county-so-tfm') and never changes, even if ICE's published agency name is later corrected.

**Key**: `any`

| Property | Type | Required | Description |
|----------|------|----------|-------------|
| `addendumDocument` | `ref` → `#document` | No | An addendum to the MOA, where ICE has published one. |
| `agencyName` | `string` | Yes | Law enforcement agency name, as corrected/verified by the publisher (may differ from ICE's published spelling). |
| `canceledDate` | `string` (datetime) | No | Date the agreement was canceled, if status is 'canceled'. Same timezone caveat as signedDate. |
| `canceledDateText` | `string` | No | Canceled date as a plain calendar date, YYYY-MM-DD, with no timezone. |
| `county` | `string` | No | County the agency sits in (for municipal agencies, the county containing the municipality). |
| `createdAt` | `string` (datetime) | Yes | When this record was first published. |
| `jurisdictionType` | `string` | Yes | Level of government the agency belongs to. |
| `moaDocument` | `ref` → `#document` | No | The signed Memorandum of Agreement PDF, archived as a content-addressed blob. The blob CID cryptographically pins the exact document bytes as retrieved. |
| `model` | `string` | Yes | 287(g) program model: jem = Jail Enforcement Model, wso = Warrant Service Officer, tfm = Task Force Model. |
| `muniName` | `string` | No | Municipality name, for municipal agencies. |
| `notes` | `string` | No | Publisher's notes on this agreement. |
| `population` | `integer` | No | Estimated jurisdiction population (U.S. Census Bureau ACS 2024). |
| `signedDate` | `string` (datetime) | No | Date the agreement was signed, as midnight UTC. WARNING for consumers: rendering this in a US local timezone displays the PREVIOUS calendar day. Prefer signedDateText for display. |
| `signedDateText` | `string` | No | Signed date as a plain calendar date, YYYY-MM-DD, with no timezone. Authoritative for display where this and signedDate appear to disagree. |
| `sourceUrl` | `string` (uri) | No | URL of the publisher's report or dataset this record is derived from. |
| `state` | `string` | Yes | U.S. state or territory name, e.g. 'Georgia'. |
| `stateAbbr` | `string` | No | Two-letter USPS state abbreviation, e.g. 'GA'. |
| `status` | `string` | Yes | Current status of the agreement. |
| `tfmReimbursements` | `string` | No | Confirmed Task Force Model reimbursements and invoices, where documented. |
| `updatedAt` | `string` (datetime) | Yes | When this record was last updated. |

## Raw Schema

```json
{
  "$type": "com.atproto.lexicon.schema",
  "defs": {
    "document": {
      "description": "An archived source document. The blob's CID is a SHA-256 content hash of the exact bytes retrieved at retrievedAt, providing tamper-evident provenance even if the original is later altered or removed. sourceUrl is optional because documents obtained by FOIA production have no public URL; in that case obtainedVia should say so.",
      "properties": {
        "file": {
          "accept": [
            "application/pdf"
          ],
          "description": "The document itself.",
          "maxSize": 20000000,
          "type": "blob"
        },
        "obtainedVia": {
          "description": "How this copy was obtained. Defaults to public-url when sourceUrl is present.",
          "knownValues": [
            "public-url",
            "foia",
            "litigation",
            "publisher"
          ],
          "type": "string"
        },
        "retrievedAt": {
          "description": "When the document was retrieved and archived.",
          "format": "datetime",
          "type": "string"
        },
        "sourceUrl": {
          "description": "Where the document was retrieved from (e.g. ICE's doclib URL). Absent for documents not published at a public URL.",
          "format": "uri",
          "type": "string"
        },
        "title": {
          "description": "Human-readable document title.",
          "maxLength": 300,
          "type": "string"
        }
      },
      "required": [
        "file",
        "retrievedAt"
      ],
      "type": "object"
    },
    "main": {
      "description": "A single 287(g) agreement between ICE and a state or local law enforcement agency, as documented in the Titus Legal Design 287(g) Program Report. One record per agency + program-model combination. The record key (rkey) is a permanent human-readable slug assigned by the publisher (e.g. 'ga-tift-county-so-tfm') and never changes, even if ICE's published agency name is later corrected.",
      "key": "any",
      "record": {
        "properties": {
          "addendumDocument": {
            "description": "An addendum to the MOA, where ICE has published one.",
            "ref": "#document",
            "type": "ref"
          },
          "agencyName": {
            "description": "Law enforcement agency name, as corrected/verified by the publisher (may differ from ICE's published spelling).",
            "maxLength": 300,
            "type": "string"
          },
          "canceledDate": {
            "description": "Date the agreement was canceled, if status is 'canceled'. Same timezone caveat as signedDate.",
            "format": "datetime",
            "type": "string"
          },
          "canceledDateText": {
            "description": "Canceled date as a plain calendar date, YYYY-MM-DD, with no timezone.",
            "maxLength": 10,
            "type": "string"
          },
          "county": {
            "description": "County the agency sits in (for municipal agencies, the county containing the municipality).",
            "maxLength": 200,
            "type": "string"
          },
          "createdAt": {
            "description": "When this record was first published.",
            "format": "datetime",
            "type": "string"
          },
          "jurisdictionType": {
            "description": "Level of government the agency belongs to.",
            "knownValues": [
              "county",
              "municipality",
              "state"
            ],
            "type": "string"
          },
          "moaDocument": {
            "description": "The signed Memorandum of Agreement PDF, archived as a content-addressed blob. The blob CID cryptographically pins the exact document bytes as retrieved.",
            "ref": "#document",
            "type": "ref"
          },
          "model": {
            "description": "287(g) program model: jem = Jail Enforcement Model, wso = Warrant Service Officer, tfm = Task Force Model.",
            "knownValues": [
              "jem",
              "wso",
              "tfm"
            ],
            "type": "string"
          },
          "muniName": {
            "description": "Municipality name, for municipal agencies.",
            "maxLength": 200,
            "type": "string"
          },
          "notes": {
            "description": "Publisher's notes on this agreement.",
            "maxLength": 3000,
            "type": "string"
          },
          "population": {
            "description": "Estimated jurisdiction population (U.S. Census Bureau ACS 2024).",
            "minimum": 0,
            "type": "integer"
          },
          "signedDate": {
            "description": "Date the agreement was signed, as midnight UTC. WARNING for consumers: rendering this in a US local timezone displays the PREVIOUS calendar day. Prefer signedDateText for display.",
            "format": "datetime",
            "type": "string"
          },
          "signedDateText": {
            "description": "Signed date as a plain calendar date, YYYY-MM-DD, with no timezone. Authoritative for display where this and signedDate appear to disagree.",
            "maxLength": 10,
            "type": "string"
          },
          "sourceUrl": {
            "description": "URL of the publisher's report or dataset this record is derived from.",
            "format": "uri",
            "type": "string"
          },
          "state": {
            "description": "U.S. state or territory name, e.g. 'Georgia'.",
            "maxLength": 100,
            "type": "string"
          },
          "stateAbbr": {
            "description": "Two-letter USPS state abbreviation, e.g. 'GA'.",
            "maxLength": 2,
            "type": "string"
          },
          "status": {
            "description": "Current status of the agreement.",
            "knownValues": [
              "active",
              "pending",
              "canceled"
            ],
            "type": "string"
          },
          "tfmReimbursements": {
            "description": "Confirmed Task Force Model reimbursements and invoices, where documented.",
            "maxLength": 1000,
            "type": "string"
          },
          "updatedAt": {
            "description": "When this record was last updated.",
            "format": "datetime",
            "type": "string"
          }
        },
        "required": [
          "agencyName",
          "state",
          "jurisdictionType",
          "model",
          "status",
          "createdAt",
          "updatedAt"
        ],
        "type": "object"
      },
      "type": "record"
    }
  },
  "id": "com.tituslegaldesign.immigration.agreement",
  "lexicon": 1
}
```