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.