# Lexicons matching `app.certified`

**7** lexicon(s) found.

## app.certified.actor.organization

- **Lexicon Version:** 1

### main (record)

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

**Record Key:** `literal:self`

**Properties:**

- `urls`: array
  Additional reference URLs (social media profiles, contact pages, donation links, etc.) with a display label for each URL.
  Array of:
    - `item`: ref → #urlItem
- `location`: ref → com.atproto.repo.strongRef
  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)
  Client-declared timestamp when this record was originally created.
- `foundedDate`: string (datetime)
  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
  Legal or operational structures of the organization (e.g. 'nonprofit', 'ngo', 'government', 'social-enterprise', 'cooperative').
  Constraints: maxLength: 10
  Array of:
    - `item`: string
      Constraints: maxLength: 128, maxGraphemes: 100

**Required:** createdAt

### urlItem (object)

A labeled URL reference.

**Properties:**

- `url`: string (uri)
  The URL.
  Constraints: maxLength: 10000, maxGraphemes: 2048
- `label`: string
  Optional human-readable label for this URL (e.g. 'Support page', 'Donation page').
  Constraints: maxLength: 640, maxGraphemes: 64

**Required:** url


---

## app.certified.actor.profile

- **Lexicon Version:** 1

### main (record)

A declaration of a Certified account profile.

**Record Key:** `literal:self`

**Properties:**

- `avatar`: union → union[org.hypercerts.defs#uri, org.hypercerts.defs#smallImage]
  Small image to be displayed next to posts from account. AKA, 'profile picture'
- `banner`: union → union[org.hypercerts.defs#uri, org.hypercerts.defs#largeImage]
  Larger horizontal image to display behind profile view.
- `website`: string (uri)
  Account website URL
- `pronouns`: string
  Free-form pronouns text.
  Constraints: maxLength: 200, maxGraphemes: 20
- `createdAt`: string (datetime)
  Client-declared timestamp when this record was originally created
- `description`: string
  Free-form profile description text.
  Constraints: maxLength: 2560, maxGraphemes: 256
- `displayName`: string
  Display name for the account
  Constraints: maxLength: 640, maxGraphemes: 64

**Required:** createdAt


---

## app.certified.badge.award

- **Lexicon Version:** 1

### main (record)

Records a badge award to a user, project, or activity claim.

**Record Key:** `tid`

**Properties:**

- `url`: string (uri)
  Optional URL the badge award links to.
  Constraints: maxLength: 2048
- `note`: string
  Optional statement explaining the reason for this badge award.
  Constraints: maxLength: 500
- `badge`: ref → com.atproto.repo.strongRef
  Strong reference to the badge definition at the time of award. The record referenced must conform with the lexicon app.certified.badge.definition.
- `subject`: union → union[app.certified.defs#did, com.atproto.repo.strongRef]
  Entity the badge award is for (either an account DID or any specific AT Protocol record), e.g. a user, a project, or a specific activity claim.
- `createdAt`: string (datetime)
  Client-declared timestamp when this record was originally created

**Required:** badge, subject, createdAt


---

## app.certified.badge.definition

- **Lexicon Version:** 1

### main (record)

Defines a badge that can be awarded via badge award records to users, projects, or activity claims.

**Record Key:** `tid`

**Properties:**

- `icon`: blob
  Icon representing the badge, stored as a blob for compact visual display.
- `title`: string
  Human-readable title of the badge.
  Constraints: maxLength: 256
- `badgeType`: string
  Category of the badge. Values beyond the known set are permitted.
  Constraints: maxLength: 100
- `createdAt`: string (datetime)
  Client-declared timestamp when this record was originally created
- `description`: string
  Optional short statement describing what the badge represents.
  Constraints: maxLength: 5000, maxGraphemes: 500
- `allowedIssuers`: array
  Optional allowlist of DIDs allowed to issue this badge. If omitted, anyone may issue it.
  Constraints: maxLength: 100
  Array of:
    - `item`: ref → app.certified.defs#did

**Required:** title, badgeType, createdAt


---

## app.certified.badge.response

- **Lexicon Version:** 1

### main (record)

Recipient response to a badge award.

**Record Key:** `tid`

**Properties:**

- `weight`: string
  Optional relative weight for accepted badges, assigned by the recipient.
  Constraints: maxLength: 50
- `response`: string
  The recipient’s response for the badge (accepted or rejected).
- `createdAt`: string (datetime)
  Client-declared timestamp when this record was originally created
- `badgeAward`: ref → com.atproto.repo.strongRef
  Strong reference to the badge award being responded to. The record referenced must conform with the lexicon app.certified.badge.award.

**Required:** badgeAward, response, createdAt


---

## app.certified.defs

Common type definitions used across certified protocols.

- **Lexicon Version:** 1

### did (object)

A Decentralized Identifier (DID) string.

**Properties:**

- `did`: string (did)
  The DID string value.
  Constraints: maxLength: 256

**Required:** did


---

## app.certified.location

- **Lexicon Version:** 1

### main (record)

A location reference

**Record Key:** `tid`

**Properties:**

- `srs`: string (uri)
  The Spatial Reference System URI (e.g., http://www.opengis.net/def/crs/OGC/1.3/CRS84) that defines the coordinate system.
  Constraints: maxLength: 100
- `name`: string
  Human-readable name for this location (e.g. 'Golden Gate Park', 'San Francisco Bay Area')
  Constraints: maxLength: 1000, maxGraphemes: 100
- `location`: union → union[org.hypercerts.defs#uri, org.hypercerts.defs#smallBlob, #string]
  The location of where the work was performed as a URI, blob, or inline string.
- `createdAt`: string (datetime)
  Client-declared timestamp when this record was originally created
- `lpVersion`: string
  The version of the Location Protocol
  Constraints: maxLength: 10
- `description`: string
  Additional context about this location, such as its significance to the work or specific boundaries
  Constraints: maxLength: 2000, maxGraphemes: 500
- `locationType`: string
  An identifier for the format of the location data (e.g., coordinate-decimal, geojson-point). See the Location Protocol spec for the full registry: https://spec.decentralizedgeo.org/specification/location-types/#location-type-registry
  Constraints: maxLength: 20

**Required:** lpVersion, srs, locationType, location, createdAt

### string (object)

A location represented as a string, e.g. coordinates or a small GeoJSON string.

**Properties:**

- `string`: string
  The location string value
  Constraints: maxLength: 10000, maxGraphemes: 1000

**Required:** string


---