Skip to content

Profile Capability — dev.ugp.giving.profile

The profile capability carries the descriptive, branding, and tax metadata for a nonprofit. Its config object is validated by source/schemas/giving/profile.json ($id: https://ugp.dev/schemas/giving/profile.json).

A nonprofit declares this capability in its /.well-known/ucp profile:

jsonc "capabilities": { "dev.ugp.giving.profile": [ { "version": "2026-06-25", "spec": "https://ugp.dev/specification/profile", "schema": "https://ugp.dev/schemas/giving/profile.json", "config": { /* profile.json object */ } } ] }

The same object is also returned by the GET /profile REST endpoint.

Field reference

Field Type Required Notes
name string yes Display name (e.g. "Eastside Shelter").
legal_name string no Registered legal name on tax filings.
eins array of string yes At least one EIN; each matches ^\d{2}-\d{7}$. First entry is primary.
tax_deductible_status enum no One of 501c3, 501c4, fiscally_sponsored, non_us, other, none.
mission string yes Mission statement.
ntee_code string no NTEE classification code.
category string no Human-readable cause category.
website string (uri) no Public website.
logo media no Organization logo.
brand_colors object no primary / secondary / accent, each a 6-digit hex (^#[0-9a-fA-F]{6}$).
address postal_address no Mailing/registered address.
contact object no email (format email) and phone_number.
social_links array of link no Social and external presences.
designations array of object no Funds/programs a gift can target: { id (required), name (required), default (bool) }.

additionalProperties is true — providers may carry extra organization metadata without breaking validation.

Designations

designations enumerate the funds, programs, or campaigns a donor may direct a gift toward. Each donation's designation field (see Donations) MUST reference one of these id values. Mark one designation default: true to indicate where undirected gifts go.