{
  "openapi": "3.1.0",
  "info": {
    "title": "AdvisorCensus",
    "version": "1.0.0",
    "summary": "Investment advisory firms in the United States, from their Form ADV filings.",
    "description": "Public, read-only JSON for every page of AdvisorCensus: a record for each SEC- and state-registered investment adviser and exempt reporting adviser, and lists by state, metro area, city, fee model, client type, and client niche, rebuilt monthly from Form ADV. No authentication. Every firm and list address also has a Markdown version (.md), and a request for a page with Accept: text/markdown gets it at the page's own address. Lists show filed facts only: no ratings, rankings, or paid placement. Unless sorted, a list opens with the firms that report individual clients on Form ADV Item 5.D, then all other firms, by name within each group. Credit AdvisorCensus with a link to the page the data came from (CC BY 4.0).",
    "license": {
      "name": "CC BY 4.0",
      "url": "https://creativecommons.org/licenses/by/4.0/"
    },
    "contact": {
      "name": "AdvisorCensus",
      "email": "support@advisorseomax.com",
      "url": "https://advisorcensus.com/data"
    }
  },
  "servers": [
    {
      "url": "https://advisorcensus.com"
    }
  ],
  "externalDocs": {
    "description": "Data and downloads",
    "url": "https://advisorcensus.com/data"
  },
  "tags": [
    {
      "name": "Firms"
    },
    {
      "name": "Lists"
    },
    {
      "name": "Search"
    }
  ],
  "paths": {
    "/firm/{slug}.json": {
      "get": {
        "operationId": "getFirm",
        "summary": "A firm's record",
        "tags": [
          "Firms"
        ],
        "description": "The same page as Markdown: /firm/{slug}.md.",
        "parameters": [
          {
            "$ref": "#/components/parameters/slug"
          }
        ],
        "responses": {
          "200": {
            "description": "The firm's filed facts.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Firm"
                }
              }
            }
          },
          "301": {
            "description": "The firm's current address: after a rename, or for an address that ends in the right CRD number."
          },
          "404": {
            "description": "No firm with that CRD number is listed.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "410": {
            "description": "The listing was removed (for example a withdrawn registration, or at the firm's request); iapd_url still has the record.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          }
        }
      }
    },
    "/advisors.json": {
      "get": {
        "operationId": "listNational",
        "summary": "Every state, D.C., and territory with its firm count",
        "tags": [
          "Lists"
        ],
        "parameters": [],
        "description": "The same list as Markdown: .md in place of .json.",
        "responses": {
          "200": {
            "description": "One page of the list.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ListPage"
                }
              }
            }
          },
          "301": {
            "description": "The list's canonical address (for example /page/1 to the address without it)."
          },
          "404": {
            "description": "No such list.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          }
        }
      }
    },
    "/advisors/{state}.json": {
      "get": {
        "operationId": "listState",
        "summary": "Firms with a principal office in a state",
        "tags": [
          "Lists"
        ],
        "parameters": [
          {
            "$ref": "#/components/parameters/state"
          },
          {
            "$ref": "#/components/parameters/filter_clients"
          },
          {
            "$ref": "#/components/parameters/filter_fee"
          },
          {
            "$ref": "#/components/parameters/filter_type"
          },
          {
            "$ref": "#/components/parameters/filter_raum"
          },
          {
            "$ref": "#/components/parameters/filter_years"
          },
          {
            "$ref": "#/components/parameters/filter_custodian"
          },
          {
            "$ref": "#/components/parameters/sort"
          }
        ],
        "description": "The same list as Markdown: .md in place of .json.",
        "responses": {
          "200": {
            "description": "One page of the list.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ListPage"
                }
              }
            }
          },
          "301": {
            "description": "The list's canonical address (for example /page/1 to the address without it)."
          },
          "404": {
            "description": "No such list.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          }
        }
      }
    },
    "/advisors/{state}/page/{page}.json": {
      "get": {
        "operationId": "listStatePage",
        "summary": "A later page of a state's firms",
        "tags": [
          "Lists"
        ],
        "parameters": [
          {
            "$ref": "#/components/parameters/state"
          },
          {
            "$ref": "#/components/parameters/page"
          },
          {
            "$ref": "#/components/parameters/filter_clients"
          },
          {
            "$ref": "#/components/parameters/filter_fee"
          },
          {
            "$ref": "#/components/parameters/filter_type"
          },
          {
            "$ref": "#/components/parameters/filter_raum"
          },
          {
            "$ref": "#/components/parameters/filter_years"
          },
          {
            "$ref": "#/components/parameters/filter_custodian"
          },
          {
            "$ref": "#/components/parameters/sort"
          }
        ],
        "description": "The same list as Markdown: .md in place of .json.",
        "responses": {
          "200": {
            "description": "One page of the list.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ListPage"
                }
              }
            }
          },
          "301": {
            "description": "The list's canonical address (for example /page/1 to the address without it)."
          },
          "404": {
            "description": "No such list.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          }
        }
      }
    },
    "/advisors/{state}/{scope}.json": {
      "get": {
        "operationId": "listMetroOrStateFee",
        "summary": "A metro area's firms, or a fee model's firms in a state",
        "tags": [
          "Lists"
        ],
        "parameters": [
          {
            "$ref": "#/components/parameters/state"
          },
          {
            "$ref": "#/components/parameters/scope"
          },
          {
            "$ref": "#/components/parameters/filter_clients"
          },
          {
            "$ref": "#/components/parameters/filter_fee"
          },
          {
            "$ref": "#/components/parameters/filter_type"
          },
          {
            "$ref": "#/components/parameters/filter_raum"
          },
          {
            "$ref": "#/components/parameters/filter_years"
          },
          {
            "$ref": "#/components/parameters/filter_custodian"
          },
          {
            "$ref": "#/components/parameters/sort"
          }
        ],
        "description": "The same list as Markdown: .md in place of .json.",
        "responses": {
          "200": {
            "description": "One page of the list.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ListPage"
                }
              }
            }
          },
          "301": {
            "description": "The list's canonical address (for example /page/1 to the address without it)."
          },
          "404": {
            "description": "No such list.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          }
        }
      }
    },
    "/advisors/{state}/{scope}/page/{page}.json": {
      "get": {
        "operationId": "listMetroOrStateFeePage",
        "summary": "A later page of a metro area or state fee-model list",
        "tags": [
          "Lists"
        ],
        "parameters": [
          {
            "$ref": "#/components/parameters/state"
          },
          {
            "$ref": "#/components/parameters/scope"
          },
          {
            "$ref": "#/components/parameters/page"
          },
          {
            "$ref": "#/components/parameters/filter_clients"
          },
          {
            "$ref": "#/components/parameters/filter_fee"
          },
          {
            "$ref": "#/components/parameters/filter_type"
          },
          {
            "$ref": "#/components/parameters/filter_raum"
          },
          {
            "$ref": "#/components/parameters/filter_years"
          },
          {
            "$ref": "#/components/parameters/filter_custodian"
          },
          {
            "$ref": "#/components/parameters/sort"
          }
        ],
        "description": "The same list as Markdown: .md in place of .json.",
        "responses": {
          "200": {
            "description": "One page of the list.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ListPage"
                }
              }
            }
          },
          "301": {
            "description": "The list's canonical address (for example /page/1 to the address without it)."
          },
          "404": {
            "description": "No such list.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          }
        }
      }
    },
    "/advisors/{state}/{metro}/{subpage}.json": {
      "get": {
        "operationId": "listWithinMetro",
        "summary": "A city, fee model, client niche, or client type in a metro area",
        "tags": [
          "Lists"
        ],
        "parameters": [
          {
            "$ref": "#/components/parameters/state"
          },
          {
            "$ref": "#/components/parameters/metro"
          },
          {
            "$ref": "#/components/parameters/subpage"
          },
          {
            "$ref": "#/components/parameters/filter_clients"
          },
          {
            "$ref": "#/components/parameters/filter_fee"
          },
          {
            "$ref": "#/components/parameters/filter_type"
          },
          {
            "$ref": "#/components/parameters/filter_raum"
          },
          {
            "$ref": "#/components/parameters/filter_years"
          },
          {
            "$ref": "#/components/parameters/filter_custodian"
          },
          {
            "$ref": "#/components/parameters/sort"
          }
        ],
        "description": "The same list as Markdown: .md in place of .json.",
        "responses": {
          "200": {
            "description": "One page of the list.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ListPage"
                }
              }
            }
          },
          "301": {
            "description": "The list's canonical address (for example /page/1 to the address without it)."
          },
          "404": {
            "description": "No such list.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          }
        }
      }
    },
    "/advisors/{state}/{metro}/{subpage}/page/{page}.json": {
      "get": {
        "operationId": "listWithinMetroPage",
        "summary": "A later page of a list within a metro area",
        "tags": [
          "Lists"
        ],
        "parameters": [
          {
            "$ref": "#/components/parameters/state"
          },
          {
            "$ref": "#/components/parameters/metro"
          },
          {
            "$ref": "#/components/parameters/subpage"
          },
          {
            "$ref": "#/components/parameters/page"
          },
          {
            "$ref": "#/components/parameters/filter_clients"
          },
          {
            "$ref": "#/components/parameters/filter_fee"
          },
          {
            "$ref": "#/components/parameters/filter_type"
          },
          {
            "$ref": "#/components/parameters/filter_raum"
          },
          {
            "$ref": "#/components/parameters/filter_years"
          },
          {
            "$ref": "#/components/parameters/filter_custodian"
          },
          {
            "$ref": "#/components/parameters/sort"
          }
        ],
        "description": "The same list as Markdown: .md in place of .json.",
        "responses": {
          "200": {
            "description": "One page of the list.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ListPage"
                }
              }
            }
          },
          "301": {
            "description": "The list's canonical address (for example /page/1 to the address without it)."
          },
          "404": {
            "description": "No such list.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          }
        }
      }
    },
    "/advisors/{state}.csv": {
      "get": {
        "operationId": "downloadState",
        "summary": "Every firm in a state as CSV",
        "tags": [
          "Lists"
        ],
        "parameters": [
          {
            "$ref": "#/components/parameters/state"
          }
        ],
        "responses": {
          "200": {
            "description": "Every firm in the list: name, city, state, CRD, registration type, years registered, assets band, compensation types, and the IAPD link. The first lines name the period and the page.",
            "content": {
              "text/csv": {
                "schema": {
                  "type": "string"
                }
              }
            }
          },
          "404": {
            "description": "No such state or metro list."
          }
        }
      }
    },
    "/advisors/{state}/{metro}.csv": {
      "get": {
        "operationId": "downloadMetro",
        "summary": "Every firm in a metro area as CSV",
        "tags": [
          "Lists"
        ],
        "parameters": [
          {
            "$ref": "#/components/parameters/state"
          },
          {
            "$ref": "#/components/parameters/metro"
          }
        ],
        "responses": {
          "200": {
            "description": "Every firm in the list: name, city, state, CRD, registration type, years registered, assets band, compensation types, and the IAPD link. The first lines name the period and the page.",
            "content": {
              "text/csv": {
                "schema": {
                  "type": "string"
                }
              }
            }
          },
          "404": {
            "description": "No such state or metro list."
          }
        }
      }
    },
    "/search.json": {
      "get": {
        "operationId": "suggest",
        "summary": "Places and firms matching a query",
        "tags": [
          "Search"
        ],
        "description": "A few places and firms for a firm name, city, state, or ZIP code (the search box's suggestions). 120 requests a minute from one connection.",
        "parameters": [
          {
            "name": "q",
            "in": "query",
            "required": true,
            "description": "A firm name, city, state, or ZIP code.",
            "schema": {
              "type": "string",
              "maxLength": 80
            }
          }
        ],
        "responses": {
          "200": {
            "description": "The suggestions.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Suggestions"
                }
              }
            }
          },
          "429": {
            "description": "Too many requests; wait for Retry-After seconds.",
            "headers": {
              "Retry-After": {
                "schema": {
                  "type": "integer"
                }
              }
            }
          }
        }
      }
    }
  },
  "components": {
    "parameters": {
      "slug": {
        "name": "slug",
        "in": "path",
        "required": true,
        "description": "The firm's slug, as in the url of a list page's firms or a search suggestion's path. It ends in the firm's CRD number, and any address ending in the right CRD (or the bare CRD, /firm/300147.json) redirects to the current one.",
        "schema": {
          "type": "string",
          "pattern": "^[a-z0-9][a-z0-9-]*$"
        }
      },
      "state": {
        "name": "state",
        "in": "path",
        "required": true,
        "description": "A state, D.C., or U.S. territory, as its lowercase two-letter code.",
        "schema": {
          "type": "string",
          "enum": [
            "ak",
            "al",
            "ar",
            "as",
            "az",
            "ca",
            "co",
            "ct",
            "dc",
            "de",
            "fl",
            "ga",
            "gu",
            "hi",
            "ia",
            "id",
            "il",
            "in",
            "ks",
            "ky",
            "la",
            "ma",
            "md",
            "me",
            "mi",
            "mn",
            "mo",
            "mp",
            "ms",
            "mt",
            "nc",
            "nd",
            "ne",
            "nh",
            "nj",
            "nm",
            "nv",
            "ny",
            "oh",
            "ok",
            "or",
            "pa",
            "pr",
            "ri",
            "sc",
            "sd",
            "tn",
            "tx",
            "ut",
            "va",
            "vi",
            "vt",
            "wa",
            "wi",
            "wv",
            "wy"
          ]
        }
      },
      "scope": {
        "name": "scope",
        "in": "path",
        "required": true,
        "description": "A metro area's slug (for example nashville), or a fee model across the state: fee-only, flat-fee, or hourly.",
        "schema": {
          "type": "string",
          "pattern": "^[a-z0-9][a-z0-9-]*$"
        }
      },
      "metro": {
        "name": "metro",
        "in": "path",
        "required": true,
        "description": "A metro area's slug, for example nashville.",
        "schema": {
          "type": "string",
          "pattern": "^[a-z0-9][a-z0-9-]*$"
        }
      },
      "subpage": {
        "name": "subpage",
        "in": "path",
        "required": true,
        "description": "Within a metro area: a city's slug (franklin), a fee model (fee-only, flat-fee, hourly), a client niche (for example physicians), or a client-type page (for-high-net-worth-individuals, for-retirement-plans, for-businesses, for-charities, no-account-minimum).",
        "schema": {
          "type": "string",
          "pattern": "^[a-z0-9][a-z0-9-]*$"
        }
      },
      "page": {
        "name": "page",
        "in": "path",
        "required": true,
        "description": "Page number. Each page holds 50 firms; page 1 is the address without /page/1.",
        "schema": {
          "type": "integer",
          "minimum": 2
        }
      },
      "sort": {
        "name": "sort",
        "in": "query",
        "required": false,
        "description": "Order of the firms: individuals (the default) lists firms that report individual or high-net-worth individual clients on Form ADV Item 5.D first, then all other firms, by name within each group; name is alphabetical; years is by years registered (longest first); raum is by assets band (largest first).",
        "schema": {
          "type": "string",
          "enum": [
            "individuals",
            "name",
            "years",
            "raum"
          ],
          "default": "individuals"
        }
      },
      "filter_clients": {
        "name": "clients",
        "in": "query",
        "required": false,
        "description": "Only firms matching a client type the firm reports on Form ADV Item 5.D: individuals (Individuals); high_net_worth_individuals (High-net-worth individuals); pension_profit_sharing (Retirement plans); charitable (Charities); corporations_other_businesses (Businesses); pooled_investment_vehicles (Private funds). A filtered list is not indexed.",
        "schema": {
          "type": "string",
          "enum": [
            "individuals",
            "high_net_worth_individuals",
            "pension_profit_sharing",
            "charitable",
            "corporations_other_businesses",
            "pooled_investment_vehicles"
          ]
        }
      },
      "filter_fee": {
        "name": "fee",
        "in": "query",
        "required": false,
        "description": "Only firms matching how the firm is paid: fee-only is AdvisorCensus's fee-only test, the others are Form ADV Item 5.E answers: fee-only (Fee-only); percentage-of-assets (Percentage of assets); hourly (Hourly charges); subscription (Subscription fees (newsletter or periodical)); flat-fee (Fixed fees); commissions (Commissions (Item 5.E)); performance-based (Performance-based fees); other (Other). A filtered list is not indexed.",
        "schema": {
          "type": "string",
          "enum": [
            "fee-only",
            "percentage-of-assets",
            "hourly",
            "subscription",
            "flat-fee",
            "commissions",
            "performance-based",
            "other"
          ]
        }
      },
      "filter_type": {
        "name": "type",
        "in": "query",
        "required": false,
        "description": "Only firms matching registration: SEC-registered, state-registered, or exempt reporting adviser: sec (SEC-registered); state (State-registered); exempt (Exempt reporting adviser). A filtered list is not indexed.",
        "schema": {
          "type": "string",
          "enum": [
            "sec",
            "state",
            "exempt"
          ]
        }
      },
      "filter_raum": {
        "name": "raum",
        "in": "query",
        "required": false,
        "description": "Only firms matching regulatory assets under management band, Form ADV Item 5.F: under_25m (Under $25 million); 25m_100m ($25 million to $100 million); 100m_500m ($100 million to $500 million); 500m_1b ($500 million to $1 billion); 1b_5b ($1 billion to $5 billion); over_5b (Over $5 billion); not_reported (Assets not reported). A filtered list is not indexed.",
        "schema": {
          "type": "string",
          "enum": [
            "under_25m",
            "25m_100m",
            "100m_500m",
            "500m_1b",
            "1b_5b",
            "over_5b",
            "not_reported"
          ]
        }
      },
      "filter_years": {
        "name": "years",
        "in": "query",
        "required": false,
        "description": "Only firms matching years registered: under_5 (Under 5 years); 5_to_9 (5 to 9 years); 10_to_19 (10 to 19 years); 20_plus (20 years or more). A filtered list is not indexed.",
        "schema": {
          "type": "string",
          "enum": [
            "under_5",
            "5_to_9",
            "10_to_19",
            "20_plus"
          ]
        }
      },
      "filter_custodian": {
        "name": "custodian",
        "in": "query",
        "required": false,
        "description": "Only firms matching a custodian holding 10% or more of the firm's separately managed account assets, Form ADV Schedule D, Section 5.K(3): as filed, from the SEC's data, for an SEC-registered firm, and as a state-registered firm reports it on its AdvisorCensus profile: a custodian page's slug, as in /custodians/charles-schwab. A filtered list is not indexed.",
        "schema": {
          "type": "string",
          "pattern": "^[a-z0-9][a-z0-9-]*$"
        }
      }
    },
    "schemas": {
      "Firm": {
        "type": "object",
        "description": "One firm's filed facts from Form ADV, with the page's display fields.",
        "properties": {
          "crd_number": {
            "type": "integer",
            "description": "The firm's CRD number, its identifier at the SEC and FINRA."
          },
          "slug": {
            "type": "string",
            "description": "The firm's slug; ends in the CRD number."
          },
          "url": {
            "type": "string",
            "description": "The firm's page on AdvisorCensus.",
            "format": "uri"
          },
          "markdown_url": {
            "type": "string",
            "description": "The firm's page as Markdown.",
            "format": "uri"
          },
          "display_name": {
            "type": "string",
            "description": "The name the page shows."
          },
          "primary_business_name": {
            "type": [
              "string",
              "null"
            ],
            "description": "Primary business name (Form ADV Item 1.B)."
          },
          "legal_name": {
            "type": [
              "string",
              "null"
            ],
            "description": "Legal name (Item 1.A)."
          },
          "dbas": {
            "type": "array",
            "items": {
              "type": "string"
            },
            "description": "Other names the firm does business under."
          },
          "city": {
            "type": [
              "string",
              "null"
            ],
            "description": "City of the principal office."
          },
          "city_as_filed": {
            "type": [
              "string",
              "null"
            ],
            "description": "The city as spelled on the filing (in capitals)."
          },
          "state": {
            "type": [
              "string",
              "null"
            ],
            "description": "State of the principal office."
          },
          "listing_state": {
            "type": "string",
            "description": "The state the firm is listed under, present only when the filing has no principal-office state."
          },
          "country": {
            "type": [
              "string",
              "null"
            ],
            "description": "Country of the principal office."
          },
          "cbsa_code": {
            "type": [
              "string",
              "null"
            ],
            "description": "The metro area (core-based statistical area) the principal office is in."
          },
          "metro": {
            "type": [
              "object",
              "null"
            ],
            "description": "The metro area's names and page.",
            "properties": {
              "cbsa_code": {
                "type": "string"
              },
              "common_name": {
                "type": "string"
              },
              "msa_name": {
                "type": "string"
              },
              "path": {
                "type": "string"
              }
            }
          },
          "registration_type": {
            "type": [
              "string",
              "null"
            ],
            "description": "sec (SEC-registered), state (state-registered), or exempt (exempt reporting adviser)."
          },
          "registration_type_label": {
            "type": "string",
            "description": "The registration type in words."
          },
          "registration_status": {
            "type": [
              "string",
              "null"
            ],
            "description": "Registration status as filed."
          },
          "registration_date": {
            "type": [
              "string",
              "null"
            ],
            "description": "Date registered.",
            "format": "date"
          },
          "years_registered": {
            "type": [
              "integer",
              "null"
            ],
            "description": "Whole years since registration, at the filing period."
          },
          "period": {
            "type": "string",
            "description": "The filing period the record reflects.",
            "format": "date"
          },
          "filing_date": {
            "type": [
              "string",
              "null"
            ],
            "description": "Date of the Form ADV filing the figures come from."
          },
          "carried_forward": {
            "type": "boolean",
            "description": "The figures come from an earlier filing, carried forward."
          },
          "total_employees": {
            "type": [
              "integer",
              "null"
            ],
            "description": "Total employees (Item 5.A)."
          },
          "advisory_employees": {
            "type": [
              "integer",
              "null"
            ],
            "description": "Employees who perform investment advisory functions (Item 5.B(1))."
          },
          "client_count_bucket": {
            "type": [
              "string",
              "null"
            ],
            "description": "Number of clients (Item 5.C), as filed."
          },
          "clients": {
            "type": "array",
            "description": "Client types the firm serves (Item 5.D), each with its share of the firm's clients, worked out from the filed counts.",
            "items": {
              "type": "object",
              "properties": {
                "type": {
                  "type": "string"
                },
                "label": {
                  "type": "string"
                },
                "share": {
                  "type": [
                    "string",
                    "null"
                  ],
                  "description": "The type's exact share of the firm's clients, rounded half up to the nearest percent (\"65%\", \"under 1%\"); null when a \"fewer than 5 clients\" box without a number leaves the firm's total unknown."
                },
                "fewer_than_5": {
                  "type": [
                    "boolean",
                    "null"
                  ],
                  "description": "The firm checked \"fewer than 5 clients\" for the type instead of a number."
                }
              }
            }
          },
          "clients_note": {
            "type": [
              "string",
              "null"
            ],
            "description": "How the shares are worked out."
          },
          "compensation_types": {
            "type": "array",
            "items": {
              "type": "string"
            },
            "description": "Compensation arrangements (Item 5.E) as codes."
          },
          "compensation_labels": {
            "type": "array",
            "items": {
              "type": "string"
            },
            "description": "Compensation arrangements in the form's words."
          },
          "advisory_activities": {
            "type": "array",
            "items": {
              "type": "string"
            },
            "description": "Advisory activities (Item 5.G) as codes."
          },
          "advisory_activity_labels": {
            "type": "array",
            "items": {
              "type": "string"
            },
            "description": "Advisory activities in words."
          },
          "wrap_fee_participant": {
            "type": [
              "boolean",
              "null"
            ],
            "description": "The firm participates in a wrap fee program."
          },
          "disclosure_yes_count": {
            "type": [
              "integer",
              "null"
            ],
            "description": "How many Item 11 disclosure questions the firm answered yes."
          },
          "disclosure_items": {
            "type": [
              "array",
              "null"
            ],
            "description": "Each Item 11 question answered yes; null when unanswered.",
            "items": {
              "type": "object",
              "properties": {
                "item": {
                  "type": "string"
                },
                "question": {
                  "type": "string"
                }
              }
            }
          },
          "disclosure_line": {
            "type": "string",
            "description": "The disclosures in one sentence."
          },
          "states_registered": {
            "type": "array",
            "items": {
              "type": "string"
            },
            "description": "States where the firm is registered or notice-filed."
          },
          "websites": {
            "type": "array",
            "items": {
              "type": "string"
            },
            "description": "Websites listed on Form ADV."
          },
          "iapd_url": {
            "type": "string",
            "description": "The firm's record on the SEC's Investment Adviser Public Disclosure site.",
            "format": "uri"
          },
          "summary": {
            "type": "string",
            "description": "One sentence on the firm, from the filing."
          },
          "citation": {
            "type": "string",
            "description": "How to cite the page."
          },
          "quick_answers": {
            "type": "array",
            "items": {
              "type": "object",
              "properties": {
                "q": {
                  "type": "string"
                },
                "a": {
                  "type": "string"
                }
              }
            },
            "description": "Questions about the firm answered from its filings and brochure."
          },
          "metro_comparison": {
            "type": [
              "object",
              "null"
            ],
            "description": "The firm's Form ADV answers beside its metro area's firms, with the filing period: its years registered and the metro's median, and each compensation arrangement (Item 5.E) and client type (Item 5.D) it reports with the share of the metro's firms answering the item that report it too. Null for a firm outside a metro area or in one with fewer than five firms (see state_comparison), and when the page doesn't carry the section."
          },
          "state_comparison": {
            "type": [
              "object",
              "null"
            ],
            "description": "The same figures beside the firms AdvisorCensus lists in the firm's state, for a firm outside any metro area or in a metro area with fewer than five firms. Null when metro_comparison is given, and for a firm placed in no state."
          },
          "filing_history": {
            "type": "array",
            "description": "Staff in each year's data.",
            "items": {
              "type": "object",
              "properties": {
                "period": {
                  "type": "string"
                },
                "total_employees": {
                  "type": [
                    "integer",
                    "null"
                  ]
                },
                "filing_date": {
                  "type": [
                    "string",
                    "null"
                  ]
                }
              }
            }
          },
          "recent_changes": {
            "type": "array",
            "description": "Changes in the filing over the last 12 filing periods, by month.",
            "items": {
              "type": "object"
            }
          },
          "fees_from_brochure": {
            "type": [
              "object",
              "null"
            ],
            "description": "What the firm's Part 2A brochure states about fees and minimums when its figures passed every check; null otherwise."
          },
          "custodians": {
            "type": "array",
            "items": {
              "type": "object",
              "properties": {
                "name": {
                  "type": "string"
                },
                "name_as_filed": {
                  "type": [
                    "string",
                    "null"
                  ]
                },
                "affiliated": {
                  "type": [
                    "boolean",
                    "null"
                  ]
                },
                "reported_by_firm": {
                  "type": "boolean",
                  "description": "A state-registered firm's custodian as it reports it on its profile; the SEC's Form ADV data carries Schedule D for SEC-registered firms only."
                }
              }
            }
          },
          "custodians_note": {
            "type": [
              "string",
              "null"
            ],
            "description": "How the custodians are reported."
          },
          "provided_by_the_firm": {
            "type": [
              "object",
              "null"
            ],
            "description": "What the firm added to its page (description, services, credentials, links), labeled as provided by the firm. It never changes a filed fact."
          },
          "claimed": {
            "type": "boolean",
            "description": "A person at the firm has claimed the page."
          },
          "enhanced": {
            "type": "boolean",
            "description": "The page shows what the firm provided."
          },
          "indexable": {
            "type": "boolean",
            "description": "Search engines are asked to index the page."
          },
          "suppressed": {
            "type": "boolean",
            "description": "The listing is removed."
          },
          "source": {
            "type": "object",
            "description": "Where the record comes from and how to credit it.",
            "properties": {
              "name": {
                "type": "string"
              },
              "as_of": {
                "type": "string",
                "description": "The filing period."
              },
              "iapd_url": {
                "type": "string",
                "format": "uri"
              },
              "operator": {
                "type": "string"
              },
              "license": {
                "type": "string",
                "format": "uri"
              },
              "credit": {
                "type": "string"
              }
            }
          }
        }
      },
      "ListPage": {
        "type": "object",
        "description": "One page of a list: national, state, metro, city, fee model, client niche, or client type.",
        "properties": {
          "path": {
            "type": "string",
            "description": "The list's address."
          },
          "url": {
            "type": "string",
            "description": "The list's page.",
            "format": "uri"
          },
          "page_type": {
            "type": "string",
            "description": "national, state, metro, state_fee, metro_fee, metro_city, metro_niche, or metro_answer."
          },
          "title": {
            "type": "string",
            "description": "The page's heading."
          },
          "filters": {
            "type": "object",
            "description": "The filters applied."
          },
          "scope_total": {
            "type": [
              "integer",
              "null"
            ],
            "description": "Firms in the list before filters."
          },
          "total_firms": {
            "type": "integer",
            "description": "Firms in the list after filters."
          },
          "page": {
            "type": "integer",
            "description": "This page's number."
          },
          "total_pages": {
            "type": "integer",
            "description": "Pages in the list."
          },
          "sort": {
            "type": "string",
            "description": "The order of the firms."
          },
          "period": {
            "type": "string",
            "description": "The filing period."
          },
          "answer_paragraph": {
            "type": "string",
            "description": "The list in one paragraph."
          },
          "about_market": {
            "type": [
              "string",
              "null"
            ],
            "description": "The place's market, from the Census Bureau."
          },
          "citation": {
            "type": "string",
            "description": "How to cite the page."
          },
          "faq": {
            "type": "array",
            "items": {
              "type": "object",
              "properties": {
                "q": {
                  "type": "string"
                },
                "a": {
                  "type": "string"
                }
              }
            }
          },
          "registration_types": {
            "type": "object",
            "additionalProperties": {
              "type": "integer"
            },
            "description": "Firms by registration type."
          },
          "fee_model_mix": {
            "type": "array",
            "items": {
              "type": "object",
              "properties": {
                "code": {
                  "type": "string"
                },
                "count": {
                  "type": "integer"
                }
              }
            }
          },
          "years_registered_distribution": {
            "type": "array",
            "items": {
              "type": "object",
              "properties": {
                "code": {
                  "type": "string"
                },
                "count": {
                  "type": "integer"
                }
              }
            }
          },
          "raum_band_distribution": {
            "type": "array",
            "items": {
              "type": "object",
              "properties": {
                "code": {
                  "type": "string"
                },
                "count": {
                  "type": "integer"
                }
              }
            }
          },
          "client_types": {
            "type": [
              "object",
              "null"
            ],
            "description": "Item 5.D: answered (firms that answer it; exempt reporting advisers don't), individual (firms reporting individuals or high-net-worth individuals), and the number of firms reporting each client type.",
            "additionalProperties": {
              "type": "integer"
            }
          },
          "advisory_activities": {
            "type": [
              "object",
              "null"
            ],
            "description": "Item 5.G: answered, and financial_planning (firms reporting it).",
            "additionalProperties": {
              "type": "integer"
            }
          },
          "raum_median": {
            "type": [
              "number",
              "null"
            ],
            "description": "Median regulatory assets under management in US dollars, among the firms that report a figure."
          },
          "raum_reported": {
            "type": [
              "integer",
              "null"
            ],
            "description": "Firms that report regulatory assets under management."
          },
          "fee_figures": {
            "type": [
              "object",
              "null"
            ],
            "description": "What SEC-registered firms' Part 2A brochures state about fees for the place (scope: metro, else state), each figure only where 30 or more firms support it (median_first_rate in percent a year, share_no_minimum, median_minimum in dollars, with the firm counts behind each); null while fee figures aren't published."
          },
          "firms": {
            "type": "array",
            "description": "The firms on this page.",
            "items": {
              "$ref": "#/components/schemas/ListedFirm"
            }
          },
          "states": {
            "type": "array",
            "description": "On the national index: each state with its count.",
            "items": {
              "type": "object"
            }
          },
          "metros": {
            "type": "array",
            "description": "On the national index: the metro areas with their counts.",
            "items": {
              "type": "object"
            }
          },
          "siblings": {
            "type": "object",
            "description": "Related lists: the state, the metro area, fee-model, city, niche, and client-type pages."
          },
          "csv": {
            "type": [
              "string",
              "null"
            ],
            "description": "Every firm in the list as CSV (state and metro lists).",
            "format": "uri"
          },
          "sec_registrations_12_months": {
            "type": "object",
            "description": "New SEC registrations over 12 months, where the page has them."
          },
          "source": {
            "type": "object",
            "description": "Where the record comes from and how to credit it.",
            "properties": {
              "name": {
                "type": "string"
              },
              "as_of": {
                "type": "string",
                "description": "The filing period."
              },
              "iapd_url": {
                "type": "string",
                "format": "uri"
              },
              "operator": {
                "type": "string"
              },
              "license": {
                "type": "string",
                "format": "uri"
              },
              "credit": {
                "type": "string"
              }
            }
          }
        }
      },
      "ListedFirm": {
        "type": "object",
        "properties": {
          "crd_number": {
            "type": "integer"
          },
          "name": {
            "type": "string"
          },
          "name_as_filed": {
            "type": [
              "string",
              "null"
            ]
          },
          "url": {
            "type": "string",
            "format": "uri",
            "description": "The firm's page; add .json for its record."
          },
          "city": {
            "type": [
              "string",
              "null"
            ]
          },
          "state": {
            "type": [
              "string",
              "null"
            ]
          },
          "years_registered": {
            "type": [
              "integer",
              "null"
            ]
          },
          "raum_band": {
            "type": [
              "string",
              "null"
            ]
          },
          "compensation_types": {
            "type": "array",
            "items": {
              "type": "string"
            }
          },
          "enhanced": {
            "type": "boolean"
          },
          "brochure_fee": {
            "type": [
              "string",
              "null"
            ],
            "description": "The firm's asset-based fee as its Form ADV Part 2A brochure states it (the first band of a schedule, one rate, a range, or a maximum), where AdvisorCensus has matched the figure to the brochure's words; null when it has no matched figure. The firm's record has the whole schedule and the quotes."
          },
          "account_minimum": {
            "type": [
              "string",
              "null"
            ],
            "description": "The account minimum the brochure states (\"None\" when it says there is none), matched the same way; null when there is no matched figure."
          },
          "niche_basis": {
            "type": "object",
            "description": "On a niche list: where the firm states the focus."
          }
        }
      },
      "Suggestions": {
        "type": "object",
        "properties": {
          "query": {
            "type": "string"
          },
          "items": {
            "type": "array",
            "items": {
              "type": "object",
              "properties": {
                "kind": {
                  "type": "string",
                  "description": "firm, or a kind of place (state, metro, city)."
                },
                "label": {
                  "type": "string"
                },
                "detail": {
                  "type": "string"
                },
                "path": {
                  "type": "string",
                  "description": "The page; for a firm, add .json for its record."
                }
              }
            }
          },
          "limited": {
            "type": "boolean",
            "description": "Present when the rate limit was reached."
          }
        }
      },
      "Error": {
        "type": "object",
        "properties": {
          "status": {
            "type": "integer"
          },
          "error": {
            "type": "string",
            "description": "not_found or gone."
          },
          "message": {
            "type": "string"
          },
          "crd_number": {
            "type": "integer"
          },
          "iapd_url": {
            "type": "string",
            "format": "uri"
          }
        }
      }
    }
  }
}
