> ## Documentation Index
> Fetch the complete documentation index at: https://docs.leadx.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Fetch Better Business Bureau details

> Fetch Better Business Bureau (BBB) ratings and accreditation status for businesses.

You can search by any combination of the following fields, but at least one field is required:
- `url` 
- `company_name` 
- `address`
- `phone` 
- `bbb_url`
- `category`
- `accredited`
- `bbb_rating`
- `bbb_rating_numerical`

Pagination uses `page` and `per_page` (1-250). Responses include `page_number`, `per_page`, `total_pages`, and `total_records`.

The response includes a `records` array of matching details. The `total_records` field specifies the number of matches returned. Results include business details, BBB rating and accreditation status, customer reviews, and complaints (if any). See the **Field References** section of the documentation for a breakdown of each field returned in the response.



## OpenAPI

````yaml post /v1/bbb
openapi: 3.1.0
info:
  title: LeadX API
  version: 0.1.0
servers: []
security: []
tags:
  - name: All Attributes
    description: Aggregate and correlate data about companies and their associated records.
  - name: Better Business Bureau
    description: >-
      Retrieve Better Business Bureau (BBB) ratings and accreditation status for
      businesses.
  - name: Companies
    description: Enrich company data by URL, name, address, or phone.
  - name: Contacts
    description: Enrich data about contacts.
  - name: email
    description: Validate company email addresses.
  - name: Google Reviews
    description: Retrieve Google Reviews and ratings for businesses.
  - name: Mobile Number
    description: Enrich mobile phone numbers.
  - name: UCC
    description: Search across to the U.S. Uniform Commercial Code (UCC) lien filings.
paths:
  /v1/bbb:
    post:
      tags:
        - Better Business Bureau
      summary: Fetch Better Business Bureau details
      description: >-
        Fetch Better Business Bureau (BBB) ratings and accreditation status for
        businesses.


        You can search by any combination of the following fields, but at least
        one field is required:

        - `url` 

        - `company_name` 

        - `address`

        - `phone` 

        - `bbb_url`

        - `category`

        - `accredited`

        - `bbb_rating`

        - `bbb_rating_numerical`


        Pagination uses `page` and `per_page` (1-250). Responses include
        `page_number`, `per_page`, `total_pages`, and `total_records`.


        The response includes a `records` array of matching details. The
        `total_records` field specifies the number of matches returned. Results
        include business details, BBB rating and accreditation status, customer
        reviews, and complaints (if any). See the **Field References** section
        of the documentation for a breakdown of each field returned in the
        response.
      operationId: fetch_bbb_v1_bbb_post
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/bbbRequest'
        required: true
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema: {}
              example:
                success: true
                records:
                  - accredited_business: Not Accredited
                    address: 22 North Euclid Avenue
                    address_full: >-
                      22 North Euclid Avenue, Saint Louis, MO, 63108, United
                      States
                    alternative_company_names:
                      - Premier Dental
                    bbb_rating: F
                    bbb_rating_description: Failing
                    bbb_url: >-
                      bbb.org/us/mo/saint-louis/profile/dentist/premier-dental-partners-0734-110200481
                    business_categories:
                      - Dentist
                      - Dental Implants
                      - Cosmetic Dentistry
                      - Periodontist
                      - Endodontics
                    business_management:
                      - Jay Hauser DDS, Owner
                      - Dr. Thomas M Touhey DDS, Partner
                      - Dr. Dhaniele R Miller DDS, Partner
                      - Debbie Trent, Director of Operations
                    business_management_jsonb:
                      - first_name: Jay
                        full_name: Jay Hauser
                        last_name: Hauser
                        suffix: DDS
                        title: Owner
                      - first_name: Thomas
                        full_name: Thomas Touhey
                        honorifics: Dr
                        last_name: Touhey
                        middle_initial: M
                        suffix: DDS
                        title: Partner
                      - first_name: Dhaniele
                        full_name: Dhaniele Miller
                        honorifics: Dr
                        last_name: Miller
                        middle_initial: R
                        suffix: DDS
                        title: Partner
                      - first_name: Debbie
                        full_name: Debbie Trent
                        last_name: Trent
                        title: Director of Operations
                    business_started: '1993-10-15T00:00:00.000000'
                    business_started_unix: 750643200000
                    category: Dentist
                    city: Saint Louis
                    company_name: Premier Dental Partners
                    complaints:
                      - bbb_url: >-
                          bbb.org/us/mo/saint-louis/profile/dentist/premier-dental-partners-0734-110200481
                        complaint_date: '2025-07-22'
                        complaint_date_unix: 1753142400000
                        complaint_id: JPL9nR53YSyVYujREEhTAJ
                        complaint_status: Unanswered
                        complaint_text: >-
                          Premier continued to send me a bill with no details. I
                          hav e called several times for an explanation but they
                          have provided none. Furthermore, the insurance
                          covering the visit is my ex-wifes insurance. Finally -
                          they asked me to leave the practice while this
                          outstanding bill apparently existed but are no made no
                          mention of it. Then took several months to forward my
                          medical records.
                        modified_date: '2025-10-07 14:39:55.985847'
                        modified_date_unix: 1759847995.985847
                        record_id: 3Q9PjKheofUvNTYbiipyAf
                      - bbb_url: >-
                          bbb.org/us/mo/saint-louis/profile/dentist/premier-dental-partners-0734-110200481
                        complaint_date: '2024-10-02'
                        complaint_date_unix: 1727827200000
                        complaint_id: VaSRnt6DofhDtXPx4zr5t8
                        complaint_status: Resolved
                        complaint_text: >-
                          I visited this business for dental services on July
                          24, 2024 at the time of service I was informed that an
                          out of pocket expense of $99.20 would apply. However
                          the business did not check my insurance coverage to
                          insure whether are not I would need to pay the out of
                          pocket expense.I paid the $99.20 on Jul 24, 2024 when
                          I went home I contacted CIGNA Dental to inquire about
                          my coverage they indicated I should not have been
                          charged and that I was covered for the service. I had
                          them contact the Premier Dental to inform them of that
                          as well.I have contacted Premier Dental on Aug 13th,
                          14th & 29th of 2024 and on Sept 25 2024 about
                          refunding me my money back they continue to give me
                          the round around and has not refunded me my money,
                          during the phone calls I spoke with *****, and ****
                          who assured me the refund will be made, it has
                          not.This payment was made via my Mastercard Debit
                          card.
                        modified_date: '2025-10-07 14:39:55.985847'
                        modified_date_unix: 1759847995.985847
                        record_id: QKBtcBbVd7u6pQHAdfYi8v
                      - bbb_url: >-
                          bbb.org/us/mo/saint-louis/profile/dentist/premier-dental-partners-0734-110200481
                        business_response: Please see attachment for business response.
                        complaint_date: '2024-05-24'
                        complaint_date_unix: 1716508800000
                        complaint_id: Xn3pCn8nSEtcSiNhmssofM
                        complaint_status: Resolved
                        complaint_text: >-
                          This complaint is with the ****** ************ I
                          called that office on Feb. 12, 2024, to make an
                          appointment as a new patient. I was given the date of
                          Feb. 20, 2024, at 9:00 a.m., and was asked for my
                          health insurance information which I fully provided at
                          that time. I arrived for my appointment at 8:45 a.m.,
                          and a copy of my driver's license, and health
                          insurance card was copied at the front desk. I was
                          given new patient forms to complete via a tablet, then
                          I was called into the examination room. After x-rays,
                          another employee came into the room and introduced
                          herself as the person that took my call when I made my
                          appointment. She then stated that she had just
                          contacted my insurance company to verify coverage and
                          found that they were not within my network. I asked
                          what needs to be done now, and she stated we will file
                          the claim to see what happens, just let them handle
                          it. On April 25, 2024, I was called by an employee of
                          Premier Dental Partners and informed that the claim
                          had been denied due to their out of network standing.
                          She said that I was now responsible for the entire
                          amount of $211.00. I stated that the error was
                          completely theirs, but I would be willing to pay the
                          normal amount of my copay as determined by my
                          insurance company had it been accepted by them. She
                          stated, "Are you saying that Premier Dental should pay
                          your bill?" I stated that Premier Dental should admit
                          the mistake was totally theirs and be willing to
                          accept the partial lost. She said goodbye and hung up.
                          On May 5, 2024, I received a bill in the mail from
                          Premier Dental Partners showing a balance due in the
                          amount of $211.00 payable in full within thirty days.
                          I am willing to only pay the copay amount of $70.00,
                          since my insurance company has informed me that
                          Premier Dental Partners has not be in their network
                          since 2016. I am not at fault for any of this, but I
                          am willing to pay my part only.
                        modified_date: '2025-10-07 14:39:55.985847'
                        modified_date_unix: 1759847995.985847
                        record_id: 73ia47UpW957TsawwDtmvR
                      - bbb_url: >-
                          bbb.org/us/mo/saint-louis/profile/dentist/premier-dental-partners-0734-110200481
                        complaint_date: '2023-11-09'
                        complaint_date_unix: 1699488000000
                        complaint_id: 5RjYXwBc3cd4hc88XeitkB
                        complaint_status: Unanswered
                        complaint_text: >-
                          I had been going to a dentist in my insurance, but
                          wasnt that happy-all costs were covered.The next year
                          I went to this dentist who is listed on my insurance
                          for the first time to get my teeth cleaned. They took
                          **rays and looked at my teeth. They handed me an
                          estimate for teeth cleaning of about $1,200.00! Crazy!
                          I went to a dentist I had gone to sometime in the past
                          that doesnt take my insurance who cleaned my teeth at
                          a cost of $178.00.My complaint is that I received a
                          bill of $174.00 for **rays that they said was above
                          what insurance covered. No one told me there would be
                          out of pocket cost for **rays- I wouldnt have gone
                          there at all. I think this place is just a rip off. No
                          other dentist has ever over charged me like this. I
                          dont believe I should have to pay for the **ray costs.
                        modified_date: '2025-10-07 14:39:55.985847'
                        modified_date_unix: 1759847995.985847
                        record_id: dgoGdQA2rDFe43YKDd8Wbq
                      - bbb_url: >-
                          bbb.org/us/mo/saint-louis/profile/dentist/premier-dental-partners-0734-110200481
                        complaint_date: '2023-02-10'
                        complaint_date_unix: 1675987200000
                        complaint_id: 2JNvnMgsDANFsgB7byXxyj
                        complaint_status: Unanswered
                        complaint_text: >-
                          My husband and I visited the dentist on the same day
                          (4/26/2022) and received the same services. When I
                          returned to the dentist 6 months later they told me I
                          had an outstanding balance of $162.00 so I paid the
                          bill. When I got home I looked up the claim and the
                          balance was not for my service but my husbands and the
                          dental office had put the incorrect provider in the
                          claim which caused the insurance company to charge for
                          out of network. When I spoke with the office manager
                          they indicated that the provider was in network and
                          they would correct the error. I called my insurance
                          provider yesterday and after a very lengthy
                          conversation we determined that: Premier dental had
                          not in fact resubmitted our claim and that the doctor
                          they assigned to my husband was not at that time in
                          network due to a paperwork problem on Premiers end. I
                          called Premier today and was told that the office
                          manager was on vacation and they had no idea when she
                          may be back. This has happened at least on two
                          previous occasions of calling their office to get
                          answers. When I did speak with the office manager she
                          seemingly lied to me about how they were proceeding
                          and when I called back shes unavailable for the
                          foreseeable future. Very shady practices at the least.
                        modified_date: '2025-10-07 14:39:55.985847'
                        modified_date_unix: 1759847995.985847
                        record_id: ibBuJrUnx6AQ3WwZFHsFqA
                      - bbb_url: >-
                          bbb.org/us/mo/saint-louis/profile/dentist/premier-dental-partners-0734-110200481
                        business_response: >-
                          The compliant is for the wrong location, the correct
                          location is for a **************,
                          *********************************************** sutie
                          130

                          *********** , **. 63141.  Telephone number is 
                          ************
                        complaint_date: '2022-11-08'
                        complaint_date_unix: 1667865600000
                        complaint_id: beRVKWZbZg7wHby8vKzT8M
                        complaint_status: Unanswered
                        complaint_text: >-
                          This company gave me a quote for surgery and the
                          charge would be $2500 depending on my insurance. They
                          gave me an invoice stating it would costs $2133 after
                          insurance. I went to another location for the surgery.
                          I paid the $2133. Then they called me two months later
                          and told me I owed an additional $930. I paid it. My
                          insurance paid $1400. Between myself and my insurance,
                          we've paid $4600 and this was only supposed to costs
                          $3400 total. Every time I speak to them, they claim
                          they can't see the surgeon's system. I have zero
                          issues with the dentist so I sent him a letter. He
                          tried to call me, but he never left me a number. Now
                          there's a bill for $1274.  I don't want to cause any
                          problems and I don't want my money back. 
                        modified_date: '2025-10-07 14:39:55.985847'
                        modified_date_unix: 1759847995.985847
                        record_id: fA3y8dQyyeoS5x9ycCr2eL
                    country: United States
                    county: St. Louis City
                    entity: Sole Proprietorship
                    facebook: facebook.com/premierdentalpartners
                    file_opened: '1998-02-23T00:00:00.000000'
                    file_opened_unix: 888192000000
                    id: G48vNfptv3b3rVBxnf7ged
                    is_active: true
                    local_bbb: BBB Serving Greater Missouri & Southern Illinois
                    phone: '3143677702'
                    phones_additional:
                      - '3148383737'
                      - '6363910122'
                    record_id: G48vNfptv3b3rVBxnf7ged
                    reviews:
                      - bbb_url: >-
                          bbb.org/us/mo/saint-louis/profile/dentist/premier-dental-partners-0734-110200481
                        modified_date: '2025-10-07 14:39:50.244805'
                        modified_date_unix: 1759847990.244805
                        record_id: oRvb7yf4fnSRto3zRFNadf
                        review_date: '2024-09-24'
                        review_date_unix: 1727136000000
                        review_id: XZL2jDjR7vNogg8aZ8xGUh
                        review_stars: 1
                        review_text: >-
                          Terrible Business Practice, charged me for a service
                          that my dental plan covered no out of pocket expense,
                          the service was provided on July 24th 2024 they would
                          not refund me my money. Had dental insurance company
                          call them to explain there phone system does not
                          recognize 1 800 nbrs it hangs up.Called on Aug 13th &
                          14th & 29th 2024 spoke with **** told me I had to wait
                          until the insurance agency sent payment to there
                          **************** then would have to wait until they
                          sent them money to there ******** Dental ***********
                          has been 2months now, How would they feel if I paid
                          them the same way.They are a JOKE
                        reviewer: Keith G
                      - bbb_url: >-
                          bbb.org/us/mo/saint-louis/profile/dentist/premier-dental-partners-0734-110200481
                        modified_date: '2025-10-07 14:39:50.244805'
                        modified_date_unix: 1759847990.244805
                        record_id: gUdkQeRH7AKgHcQjAsdD8L
                        review_date: '2024-08-27'
                        review_date_unix: 1724716800000
                        review_id: fYSbYTDbX3hM35nxWhSXvb
                        review_stars: 1
                        review_text: >-
                          This company is very unorganized and unprofessional. I
                          scheduled an appointment with them and called the day
                          of to follow up and they argued me down about not
                          being on the schedule. Funny enough, I have the
                          confirmation text AND the reminder text message as
                          well. They had no sense of urgency nor did they offer
                          an apology.Also said they did not have a hygienist.On
                          the day of appointment, the hygienist said she was
                          going to do full panel of X-rays and I said that I
                          could ask my previous dentist to send it over and she
                          said if my insurance does not cover it, they would
                          write it off.Then I got a bill for comprehensive oral
                          exam that my insurance rejected. And an X-*** ****
                          that the hygienists said they were not billing
                          for.They did not do my cleaning and said that I needed
                          a deep cleaning and come back for 2 appointments. That
                          was going to cost $160. I asked why she could do my
                          regular cleaning and she did not give me any
                          explanation.I got a second opinion and found out that
                          the deep cleaning was a way to bill me a more money.
                          Dont go there.
                        reviewer: Fernanda A
                      - bbb_url: >-
                          bbb.org/us/mo/saint-louis/profile/dentist/premier-dental-partners-0734-110200481
                        modified_date: '2025-10-07 14:39:50.244805'
                        modified_date_unix: 1759847990.244805
                        record_id: h7XMT5ksnvbHFNpgeCFCwR
                        review_date: '2024-08-01'
                        review_date_unix: 1722470400000
                        review_id: akXLgQAtULBzXQ2HmxzSHv
                        review_stars: 1
                        review_text: >-
                          This company is very unorganized and unprofessional.
                          There have been too many run ins with this company as
                          a whole from the regular dentist office down to the
                          orthodontist. I scheduled an appointment with them and
                          called the day of to follow up and they argued me down
                          about not being on the schedule. Funny enough, I have
                          the confirmation text AND the reminder text message as
                          well. They had no sense of urgency nor did they offer
                          an apology.
                        reviewer: Kelcie H
                    state: MO
                    website: premierdentalpartners.com
                    zip: '63108'
                    zip_lat: 38.644803
                    zip_long: -90.253417
                total_records: 1
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
      security:
        - APIKeyHeader: []
        - HTTPBearer: []
components:
  schemas:
    bbbRequest:
      properties:
        url:
          anyOf:
            - type: string
            - type: 'null'
          title: Url
          description: Company URL (may include or omit the http/https prefix)
          example: https://www.example.com
        phone:
          anyOf:
            - type: string
            - type: 'null'
          title: Phone
          description: Company phone (may include or omit the dashes)
          example: 123-456-7890
        company_name:
          anyOf:
            - type: string
            - type: 'null'
          title: Company Name
          description: Company name
          example: Acme Inc
        address:
          anyOf:
            - type: string
            - type: 'null'
          title: Address
          description: Company address
          example: 123 Main St, Springfield, IL 62701
        bbb_url:
          anyOf:
            - type: string
            - type: 'null'
          title: Bbb Url
          description: Direct URL to the company's BBB profile
          example: >-
            https://www.bbb.org/us/il/springfield/profile/restaurant/acme-inc-1234
        category:
          anyOf:
            - type: string
            - type: 'null'
          title: Category
          description: Filter results to this primary business category
          example: Restaurants
        accredited:
          anyOf:
            - type: boolean
            - type: 'null'
          title: Accredited
          description: If true, only return BBB-accredited businesses
          example: true
        bbb_rating:
          anyOf:
            - items: {}
              type: array
            - type: 'null'
          title: Bbb Rating
          description: >-
            If provided, only return businesses with this list of BBB ratings
            (e.g., ['A+', 'A', 'B'])
          example:
            - A+
            - A
            - B
        bbb_rating_numerical:
          anyOf:
            - type: number
            - type: 'null'
          title: Bbb Rating Numerical
          description: >-
            If provided, only return businesses with BBB numerical rating
            greater than or less than the provided values. Must provide greater
            than or less than sign (> or <) prior to numerical value. Equal sign
            is optional (>= or <=). Must be in range of 0 to 1.0. A+ = 1.0, A =
            0.96, B+ = 0.89, B = 0.86, B- = 0.82, C+ = 0.79, C = 0.76, C- =
            0.72, D+ = 0.69, D = 0.66, D- = 0.62, F = 0.59
          example: '>0.85'
        page:
          type: integer
          minimum: 1
          title: Page
          description: >-
            Page number of results to return. Must be greater than or equal to
            1.
          default: 1
          example: 1
        per_page:
          type: integer
          maximum: 250
          minimum: 1
          title: Per Page
          description: Number of results per page. Maximum is 250.
          default: 250
          example: 250
      type: object
      title: bbbRequest
    HTTPValidationError:
      properties:
        detail:
          items:
            $ref: '#/components/schemas/ValidationError'
          type: array
          title: Detail
      type: object
      title: HTTPValidationError
    ValidationError:
      properties:
        loc:
          items:
            anyOf:
              - type: string
              - type: integer
          type: array
          title: Location
        msg:
          type: string
          title: Message
        type:
          type: string
          title: Error Type
        input:
          title: Input
        ctx:
          type: object
          title: Context
      type: object
      required:
        - loc
        - msg
        - type
      title: ValidationError
  securitySchemes:
    APIKeyHeader:
      type: apiKey
      in: header
      name: X-API-Key
    HTTPBearer:
      type: http
      scheme: bearer

````