Get Organizations Fields
affinity_get_organizations_fieldsRetrieve all global field definitions for organizations in your CRM. Use this to discover schema, generate dynamic forms, or validate field inputs.
Instructions
Retrieve all global (account-wide) field definitions for organizations/companies.
This is a V1 API endpoint - organizations fields GET is NOT available in V2.
Returns complete schema information for organization fields including:
Field names and IDs
Field types (text, number, dropdown, etc.)
Dropdown options (available choices)
Multiple value support
Enrichment sources (external data providers like Crunchbase, Dealroom)
Use Cases:
Schema discovery: "What company fields exist in our CRM?"
Form generation: Build dynamic forms based on available fields
Field validation: Check if input values are valid for dropdown fields
Field resolution: Map field IDs to human-readable names
Data source tracking: Identify which fields come from enrichment providers
Integration planning: Understand what data is available for export/sync
No Parameters Required: This is a simple GET request with no parameters. Returns all global organization fields.
Returns (JSON): { "fields": [ { "id": number, // Field identifier "name": string, // Field display name "value_type": number, // 0-9 enum (see types below) "value_type_name": string, // Human-readable type "allows_multiple": boolean, // Can have multiple values "dropdown_options": [...], // Available choices (if dropdown) "enrichment_source": string // e.g., "crunchbase", "dealroom" } ], "count": number, "by_type": { // Distribution by field type "Dropdown": number, "Text": number, "Number": number, ... }, "by_source": { // Distribution by data source "crunchbase": number, "dealroom": number, "affinity-data": number, "none": number }, "custom_fields": number, // Count of non-enriched fields "enriched_fields": number, // Count of enriched fields "summary": string }
Field Value Types:
0 = Person: References a person
1 = Organization: References another organization
2 = Dropdown: Single/multi-select from predefined options
3 = Number: Numeric value (funding, employees, revenue, etc.)
4 = Date: Date/timestamp (founding date, last contact, etc.)
5 = Location: Geographic location (HQ, offices)
6 = Text: Free-form text (description, notes)
7 = Ranked Dropdown: Ordered dropdown (stages, priorities)
8 = Formula: Computed/calculated value
9 = Interaction: Email/meeting reference
Enrichment Sources:
"crunchbase": Company data from Crunchbase (funding, employees, investors)
"dealroom": European startup data from Dealroom
"affinity-data": Affinity's proprietary enrichment data
"none" or null: Custom fields created by your team
Example Use Cases:
Discover all organization fields: No parameters needed Returns: Complete list of organization field schemas
Find enriched fields: Filter response by enrichment_source to see external data
Identify custom fields: Filter by enrichment_source = "none" to see team-created fields
Get dropdown options: Filter by fields with dropdown_options to see valid choices
Plan data exports: Understand complete schema before building integrations
Response Format: Use responseFormat parameter to get either:
"json": Structured data with statistics (default)
"markdown": Human-readable formatted output
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| responseFormat | No | Output format: "json" for structured data or "markdown" for human-readable. Default: "json" |