# app.certified.actor.organization

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

✓ This is the authoritative definition for this NSID.

## Links

- [View on Lexicon Garden](https://lexicon.garden/lexicon/did:plc:apun3uo5jqm34pxzqq6on754/app.certified.actor.organization)
- [Documentation](https://lexicon.garden/lexicon/did:plc:apun3uo5jqm34pxzqq6on754/app.certified.actor.organization/docs)
- [Examples](https://lexicon.garden/lexicon/did:plc:apun3uo5jqm34pxzqq6on754/app.certified.actor.organization/examples)

## Definitions

### `app.certified.actor.organization`

**Type**: `record`

Extended metadata for an organization actor. Complements the base actor profile with organization-specific fields like legal structure and reference links.

**Key**: `literal:self`

| Property | Type | Required | Description |
|----------|------|----------|-------------|
| `urls` | `array` | No | Additional reference URLs (social media profiles, contact pages, donation links, etc.) with a display label for each URL. |
| `location` | `ref` → `com.atproto.repo.strongRef` | No | A strong reference to the location where the organization is based. The record referenced must conform with the lexicon app.certified.location. |
| `createdAt` | `string` (datetime) | Yes | Client-declared timestamp when this record was originally created. |
| `foundedDate` | `string` (datetime) | No | When the organization was established. Stored as datetime per ATProto conventions (no date-only format exists). Clients should use midnight UTC (e.g., '2005-01-01T00:00:00.000Z'); consumers should treat only the date portion as canonical. |
| `organizationType` | `array` | No | Legal or operational structures of the organization (e.g. 'nonprofit', 'ngo', 'government', 'social-enterprise', 'cooperative'). |

### `app.certified.actor.organization#urlItem`

**Type**: `object`

A labeled URL reference.

| Property | Type | Required | Description |
|----------|------|----------|-------------|
| `url` | `string` (uri) | Yes | The URL. |
| `label` | `string` | No | Optional human-readable label for this URL (e.g. 'Support page', 'Donation page'). |

## Raw Schema

```json
{
  "id": "app.certified.actor.organization",
  "defs": {
    "main": {
      "key": "literal:self",
      "type": "record",
      "record": {
        "type": "object",
        "required": [
          "createdAt"
        ],
        "properties": {
          "urls": {
            "type": "array",
            "items": {
              "ref": "#urlItem",
              "type": "ref"
            },
            "description": "Additional reference URLs (social media profiles, contact pages, donation links, etc.) with a display label for each URL."
          },
          "location": {
            "ref": "com.atproto.repo.strongRef",
            "type": "ref",
            "description": "A strong reference to the location where the organization is based. The record referenced must conform with the lexicon app.certified.location."
          },
          "createdAt": {
            "type": "string",
            "format": "datetime",
            "description": "Client-declared timestamp when this record was originally created."
          },
          "foundedDate": {
            "type": "string",
            "format": "datetime",
            "description": "When the organization was established. Stored as datetime per ATProto conventions (no date-only format exists). Clients should use midnight UTC (e.g., '2005-01-01T00:00:00.000Z'); consumers should treat only the date portion as canonical."
          },
          "organizationType": {
            "type": "array",
            "items": {
              "type": "string",
              "maxLength": 128,
              "maxGraphemes": 100
            },
            "maxLength": 10,
            "description": "Legal or operational structures of the organization (e.g. 'nonprofit', 'ngo', 'government', 'social-enterprise', 'cooperative')."
          }
        }
      },
      "description": "Extended metadata for an organization actor. Complements the base actor profile with organization-specific fields like legal structure and reference links."
    },
    "urlItem": {
      "type": "object",
      "required": [
        "url"
      ],
      "properties": {
        "url": {
          "type": "string",
          "format": "uri",
          "maxLength": 10000,
          "description": "The URL.",
          "maxGraphemes": 2048
        },
        "label": {
          "type": "string",
          "maxLength": 640,
          "description": "Optional human-readable label for this URL (e.g. 'Support page', 'Donation page').",
          "maxGraphemes": 64
        }
      },
      "description": "A labeled URL reference."
    }
  },
  "$type": "com.atproto.lexicon.schema",
  "lexicon": 1
}
```