v1

latestOpenAPI 3.1.02026-07-241695611.0 MB
Business

Get Business

Retrieve a business by its UUID.

get/businesses/{id}

Path parameters

idstring uuid required

The unique identifier of the business to retrieve.

Example:412a49b5-7466-426b-bf1e-081b00b54576

The unique identifier of the business to retrieve.

Response

Response

idstring uuid required

Unique identifier for the business.

namestring required

The name of the business, determined by the name found on the domestic registration.

structure'SOLE_PROPRIETORSHIP' | 'GENERAL_PARTNERSHIP' | 'LLC' | 'LLP' | 'LLLP' | 'LP' | 'C_CORPORATION' | 'S_CORPORATION' | 'B_CORPORATION' | 'NONPROFIT' | 'COOPERATIVE' | 'TRUST' | 'PROFESSIONAL_ASSOCIATION' | 'PROFESSIONAL_CORPORATION' | 'TRADE_NAME' | 'BANK' | 'CREDIT_UNION' | 'INSURANCE' | 'OTHER'
phone_numbersstring[]

All phone numbers found associated with this business entity.

emailstring nullable

The main email found associated with this business entity.

websitestring nullable

The website found associated with this business entity.

einstring nullable

The EIN/TIN found associated with this business entity.

incorporation_state'AL' | 'AK' | 'AZ' | 'AR' | 'CA' | 'CO' | 'CT' | 'DE' | 'DC' | 'FL' | 'GA' | 'HI' | 'ID' | 'IL' | 'IN' | 'IA' | 'KS' | 'KY' | 'LA' | 'ME' | 'MD' | 'MA' | 'MI' | 'MN' | 'MS' | 'MO' | 'MT' | 'NE' | 'NV' | 'NH' | 'NJ' | 'NM' | 'NY' | 'NC' | 'ND' | 'OH' | 'OK' | 'OR' | 'PA' | 'RI' | 'SC' | 'SD' | 'TN' | 'TX' | 'UT' | 'VT' | 'VA' | 'WA' | 'WV' | 'WI' | 'WY' | 'PR' | 'VI' | 'AE' | 'AA' | 'AP' | 'GU' | 'AS'
incorporation_datestring date nullable

The date when the business first incorporated.

months_in_businessinteger nullable

The number of months elapsed since the incorporation date.

alternative_namesstring[]

A list of alternative names (e.g. DBAs) found associated with the business entity.

urlstring uri required

The URL to the business details.

console_urlstring uri required

The URL to the business details in the console.

{"stackTrail":"components:schemas:v1.BusinessResponse:properties:revenue","oasType":"schema","type":"unknown","title":"No revenue data","description":"Indicates that there is no recent revenue data available for the business."}
phone_numberstring nullable

The primary phone number found associated with the business.

addressstring nullable required

The primary address associated with the business entity.

Example response

{
  "name": "Levine-Santos",
  "addresses": [
    {
      "street": "913 Hendrix Gardens Suite 492",
      "city": "Jasonfurt",
      "zip": "19773",
      "latitude": 38.03012,
      "longitude": 78.47665,
      "sources": [
        "Online",
        "SOS"
      ]
    }
  ],
  "phone_numbers": [
    "251-829-8026"
  ],
  "email": "kathleenholmes@example.com",
  "website": "http://www.cruz-adkins.net/",
  "social_profiles": [
    {
      "site": "instagram",
      "username": "certifiedpowerinc",
      "metadata": {
        "is_business_account": true,
        "has_business_address": true,
        "bio": "Professional roofing services since 2010 🏠",
        "followers_count": 1250,
        "phone_number": "+12125551234",
        "email": "contact@business.com",
        "address": "123 Main St, Anytown, USA",
        "business_website": "https://www.business.com"
      },
      "found_on": [
        "FOUND_WEBSITE"
      ],
      "url": "https://www.instagram.com/certifiedpowerinc"
    }
  ],
  "reviews": [
    {
      "url": "https://www.yelp.com/biz/certified-power-inc-mundelein",
      "rating": 4.5,
      "volume": 23,
      "summary": "5 reviews mention that the service was great and the owner was very helpful.",
      "phone_number": "+12125551234",
      "address": "123 Main St, Anytown, USA",
      "business_website": "https://www.example.com",
      "reviews": [
        {
          "username": "John Doe",
          "text": "This is a great review!",
          "date": "2024-01-01",
          "rating": 5
        }
      ],
      "metadata": {
        "open_state": "Open",
        "types": [
          "Restaurant",
          "Italian restaurant"
        ]
      }
    }
  ],
  "directory_listings": [
    {
      "source": "bbb.org",
      "url": "https://www.bbb.org/us/ca/modesto/profile/plumber/joes-plumbing-1234",
      "category": "Plumbing Contractor",
      "business_name": "Joe's Plumbing & Heating"
    }
  ],
  "ein": "871888915",
  "incorporation_date": "2011-11-27",
  "months_in_business": 256,
  "primary_address": {
    "street": "913 Hendrix Gardens Suite 492",
    "city": "Jasonfurt",
    "zip": "19773",
    "latitude": 38.03012,
    "longitude": 78.47665
  },
  "alternative_names": [
    "Ramos, Garcia and Good"
  ],
  "registrations": [
    {
      "name": "Garcia, Hernandez and Woods",
      "issue_date": "2024-01-01",
      "inactive_date": "2024-06-01",
      "dissolution_date": "2024-06-01",
      "file_number": "867124",
      "address": {
        "street": "913 Hendrix Gardens Suite 492",
        "city": "Jasonfurt",
        "zip": "19773",
        "latitude": 38.03012,
        "longitude": 78.47665
      },
      "standing": "In Good Standing",
      "registered_agent": {
        "name": "Jeremy Crawford",
        "address": {
          "street": "913 Hendrix Gardens Suite 492",
          "city": "Jasonfurt",
          "zip": "19773",
          "latitude": 38.03012,
          "longitude": 78.47665
        }
      },
      "officers": [
        {
          "name": "Tyler Johnson",
          "titles": [
            "CEO",
            "Founder"
          ]
        }
      ]
    }
  ],
  "business_officers": [
    {
      "name": "Philip Mcguire",
      "titles": [
        "CEO",
        "Founder"
      ],
      "states": [
        "CA",
        "NY"
      ],
      "sources": [
        "Online",
        "SOS"
      ]
    }
  ],
  "predicted_naics": [
    {
      "code": "336111",
      "title": "Automobile Manufacturing",
      "accuracy": 1,
      "keywords": [
        "Automobiles",
        "Manufacturing",
        "Cars",
        "Trucks"
      ],
      "reasoning": "Based on homepage content mentioning automobile manufacturing and assembly processes."
    }
  ],
  "watchlist_hits": [
    {
      "code": "DMF",
      "count": 1,
      "details": [
        {
          "address": "123 Main St",
          "date_of_birth": "1980-01-01",
          "name": "John Doe"
        }
      ]
    }
  ],
  "sec_registrations": [
    {
      "cik": "320193",
      "tickers": [
        "NTDOY"
      ],
      "exchanges": [
        "OTC"
      ]
    }
  ],
  "url": "https://api.baselayer.com/businesses/9083e7e2-1f6b-11ef-8f0f-1edb1b067314",
  "console_url": "https://console.baselayer.com/business/9083e7e2-1f6b-11ef-8f0f-1edb1b067314",
  "phone_number": "955-714-3269",
  "address": "63788 Paige Lane Cooperfurt, MI 10037"
}