---
updatedAt: 2025-10-20T22:50:55.000Z
agentTools:
  projectIndex: https://api-documentation.versium.com/llms.txt
---

# Firmographic Append API

Get business information with the Firmographic Append API. With a business name, domain or email you can pull all available information from the Versium Data store, including:

* Basic business information
* Postal address
* Domain
* Industry, NAICS, SIC
* Number of employees
* Sales volume
* Year founded

## Format

Here's the format to call the Firmographic Append API:

<Image border={false} src="https://files.readme.io/ca62a09-API_Anatomy_Firmographic.JPG" title="API_Anatomy_Firmographic.JPG" />

## Data Tool

The Firmographic Append API accepts the following data tool:

<Table align={["left","left"]}>
  <thead>
    <tr>
      <th>
        Data Tool Value
      </th>

      <th>
        Description
      </th>
    </tr>
  </thead>

  <tbody>
    <tr>
      <td>
        firmographic
      </td>

      <td>
        Used to search an append firmographic data from the following business inputs:

        * biz email
        * biz domain
        * biz name
        * city and state
      </td>
    </tr>
  </tbody>
</Table>

Example:

```text firmographic
https://api.versium.com/v2/firmographic?domain=versium.com
```

## Inputs - what the API uses to search

Inputs are information that the Firmographic  Append API will use to search in the Versium REACH back end. The data tool of this API service accepts the following:

* **firmographic** data tool: business name, business email, domain, business phone, address, city and state.

The API will then match your inputs with consumers in the Versium Data store, and returns business information, as available.

Minimum required search parameters combinations:
**firmographic** data tool:

* email
* domain
* biz name + full address (address, city, state, zip)
* biz name + phone number

| Value    | Data Tool    | Description                            | Example              |
| :------- | :----------- | :------------------------------------- | :------------------- |
| email    | firmographic | A valid business email address         | <jsmith@versium.com> |
| domain   | firmographic | A business domain                      | versium.com          |
| business | firmographic | A business name                        | Versium              |
| address  | firmographic | An address                             | 7530 164th AVE NE    |
| city     | firmographic | A city name                            | Redmond              |
| state    | firmographic | A US state two letter abbreviation     | WA                   |
| zip      | firmographic | A 5 digit zip code                     | 98052                |
| phone    | firmographic | A valid 10 digit business phone number | 8003950164           |

## Optional Parameters

Optional Configuration Parameters are used to specify and configure how the Firmographic Append API will perform the search.

| Optional Config. Param         | Value                                                 | Description                                                                                                         |                                                                                 |
| :----------------------------- | :---------------------------------------------------- | :------------------------------------------------------------------------------------------------------------------ | :------------------------------------------------------------------------------ |
| rcfg\_max\_time                | A whole or decimal number                             | Maximum allowed API run time (in seconds).                                                                          |                                                                                 |
| rcfg\_require\_value\[*field*] | string representing the required field to be returned | Filters results by requiring specific field values. Each entry specifies a field and the exact value it must match. | rcfg\_require\_value\[Language]=Spanish rcfg\_require\_value\[First Name]=Brian |