---
updatedAt: 2026-10-20T23:12:00.000Z
agentTools:
  projectIndex: https://docs.aiprise.com/llms.txt
---

# Business Search (Prefill)

Use this API in your SDK to auto-fill business information when a customer onboards, speeding up the onboarding process. Search businesses by name. Returns matches with standard business_info (name, business_entity_id, state_code, etc.).Returns registry data only — no verification is performed.Requires X-API-KEY header.Mandatory: name, country_code. Optional: state_code.

# OpenAPI definition

```json
{
  "openapi": "3.0.0",
  "info": {
    "title": "AiPrise APIs",
    "description": "AiPrise API documentation",
    "version": "1.0"
  },
  "servers": [
    {
      "url": "https://api-sandbox.aiprise.com/api/v1/",
      "description": "Sandbox server"
    },
    {
      "url": "https://api.aiprise.com/api/v1/",
      "description": "Production server"
    }
  ],
  "paths": {
    "/data/business/search": {
      "post": {
        "tags": [
          "Data (Business)"
        ],
        "summary": "Business Search (Prefill)",
        "description": "Use this API in your SDK to auto-fill business information when a customer onboards, speeding up the onboarding process. Search businesses by name. Returns matches with standard business_info (name, business_entity_id, state_code, etc.).Returns registry data only — no verification is performed.Requires X-API-KEY header.Mandatory: name, country_code. Optional: state_code.",
        "requestBody": {
          "description": "Search by business name",
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/VerifyBusinessSearchRequestSchema"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Wrapped list; results array and total_count. Each item has business_info (name, business_entity_id, entity_type, country_code, state_code, addresses).",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/DataBusinessSearchResultSchema"
                }
              }
            }
          },
          "400": {
            "description": "Bad Request"
          }
        }
      }
    }
  },
  "components": {
    "schemas": {
      "ExtractedAddress": {
        "type": "object",
        "properties": {
          "full_address": {
            "type": "string",
            "example": "222 Palm Street, Santa Monica, CA - 93251, US"
          },
          "parsed_address": {
            "type": "object",
            "properties": {
              "address_street_1": {
                "type": "string",
                "example": "222 Palm Street",
                "description": "Address street 1"
              },
              "address_street_2": {
                "type": "string",
                "example": null,
                "description": "Address street 2"
              },
              "address_city": {
                "type": "string",
                "example": "Santa Monica",
                "description": "Address city"
              },
              "address_state": {
                "type": "string",
                "example": "CA",
                "description": "Address state or region"
              },
              "address_zip_code": {
                "type": "string",
                "example": "93251",
                "description": "Address zip code"
              },
              "address_country": {
                "type": "string",
                "example": "US",
                "description": "2-letter address country code"
              },
              "address_type": {
                "type": "string",
                "example": "home",
                "description": "Address type"
              }
            }
          },
          "source": {
            "type": "array",
            "items": {
              "type": "object",
              "properties": {
                "type": {
                  "type": "string"
                },
                "state": {
                  "type": "string"
                },
                "status": {
                  "type": "string"
                },
                "file_number": {
                  "type": "string"
                },
                "labels": {
                  "type": "array",
                  "items": {
                    "type": "string"
                  }
                }
              }
            },
            "description": "Source information for the address",
            "properties": {
              "type": {
                "type": "string"
              },
              "state": {
                "type": "string"
              },
              "status": {
                "type": "string"
              },
              "file_number": {
                "type": "string"
              },
              "labels": {
                "type": "array",
                "items": {
                  "type": "string"
                }
              }
            }
          },
          "additional_info": {
            "type": "object",
            "description": "Additional information about the address (risk indicators, deliverability, etc.)",
            "additionalProperties": {}
          }
        }
      },
      "VerifyBusinessSearchRequestSchema": {
        "type": "object",
        "properties": {
          "name": {
            "type": "string",
            "description": "Business name to search."
          },
          "country_code": {
            "type": "string",
            "description": "ISO country code (e.g. US, GB)."
          },
          "state_code": {
            "type": "string",
            "nullable": true,
            "description": "Optional state/region code (e.g. for US)."
          }
        },
        "required": [
          "name",
          "country_code"
        ]
      },
      "DataBusinessSearchResultItemSchema": {
        "type": "object",
        "description": "Single search hit; business_info only (no jurisdiction_code).",
        "properties": {
          "business_info": {
            "type": "object",
            "properties": {
              "name": {
                "type": "string",
                "nullable": true
              },
              "business_entity_id": {
                "type": "string",
                "nullable": true
              },
              "country_code": {
                "type": "string",
                "nullable": true
              },
              "state_code": {
                "type": "string",
                "nullable": true
              },
              "company_id": {
                "type": "string",
                "nullable": true,
                "description": "Company identifier returned in search results. Use this for subsequent lookup calls when present."
              },
              "addresses": {
                "type": "array",
                "items": {
                  "$ref": "#/components/schemas/ExtractedAddress"
                },
                "nullable": true
              }
            }
          }
        }
      },
      "DataBusinessSearchResultSchema": {
        "type": "object",
        "description": "Wrapped search response; results and total_count.",
        "properties": {
          "results": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/DataBusinessSearchResultItemSchema"
            }
          },
          "total_count": {
            "type": "integer",
            "description": "Number of items in results."
          }
        }
      }
    },
    "securitySchemes": {
      "apiKey": {
        "type": "apiKey",
        "in": "header",
        "name": "X-API-KEY",
        "description": "All requests must include the `X-API-KEY` header containing your API Key."
      }
    }
  },
  "security": [
    {
      "apiKey": []
    }
  ]
}
```