v1

latestOpenAPI 3.0.02026-07-2482421001.1 KB

Business history

Business overview

This API retrieves the full metadata profile for a business entity, including industry classification, loan inquiry history, and addresses derived from bank account holder information.

get/v1/businesses/{business_id}

Path parameters

business_idstring uuid required

Example:3fa85f64-5717-4562-b3fc-2c963f66afa6

A universally unique identifier (UUID) of the business entity for which you want to retrieve overview information.

Response

Success

idstring

UUID of the business entity for which overview information is retrieved.

namestring

Display name of the business. The name is determined in the following order: user-defined display name, org-specific name, then global entity name.

state'ACTIVE' | 'INACTIVE' | 'CLOSED'

Current operational state of the business entity.

Example response

{
  "id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
  "name": "Acme Corp",
  "state": "ACTIVE",
  "industry": {
    "naics4_code": 7225,
    "naics_description": "Restaurants and Other Eating Places",
    "naics6_code": 7225,
    "naics6_description": "Snack and Nonalcoholic Beverage Bars",
    "naics_override": true,
    "mcc_code": 7225,
    "mcc_description_": "Snack and Nonalcoholic Beverage Bars",
    "sic_code": 172,
    "sic_description_": "GRAPES"
  },
  "loan_inquiries": {
    "total_applications": 5,
    "application_history": [
      "2025-01-15T12:00:00Z"
    ],
    "velocity": {
      "day_count_30": 1,
      "day_count_60": 1,
      "day_count_90": 2,
      "day_count_180": 3,
      "day_count_270": 4,
      "day_count_365": 5
    }
  },
  "addresses": [
    {
      "holder_address_1": "123 MAIN STREET",
      "holder_address_2": "SUITE 200",
      "holder_city": "NEW YORK",
      "holder_state": "NY",
      "holder_zip": "10001",
      "holder_country": "US",
      "frequency": 4
    }
  ]
}