# geni crm companies (/cli/crm/companies)



Companies in the workspace's lead database. With no verb, `geni crm companies` searches; the verb subcommands fetch one record and create, update, or delete. Creates and updates take a JSON array so you can batch many records in one call.

## search (default) [#search-default]

```sh
geni crm companies "fintech" --limit 50
```

Free-text search across name, domain, and industry. Omit the query to browse.

| Arg / Flag    | Notes                                            |
| ------------- | ------------------------------------------------ |
| `[query]`     | Free-text search. Omit to browse.                |
| `--list <id>` | Only companies in this list.                     |
| `--limit <n>` | Max results (1 to 100, default 25).              |
| `--json`      | Machine-readable output, including `nextCursor`. |

## get [#get]

```sh
geni crm companies get cmp_01HX --field company.name
```

Print one company's full record. `--field <path>` extracts a single dotted-path value instead of the whole object.

| Arg / Flag       | Notes                                              |
| ---------------- | -------------------------------------------------- |
| `<id>`           | Company id.                                        |
| `--field <path>` | Print one dotted-path value (e.g. `company.name`). |

## create [#create]

```sh
geni crm companies create --json '[{"name":"Acme","domain":"acme.com","industry":"Tech"}]'
```

Find-or-create companies, deduped by domain. `--json` is an array of company objects; each needs `name`, plus optional `domain` and firmographics.

| Flag             | Notes                                        |
| ---------------- | -------------------------------------------- |
| `--json <array>` | Required. JSON array of companies to create. |

## update [#update]

```sh
geni crm companies update --json '[{"id":"cmp_01HX","industry":"Fintech"}]'
```

Update companies by id. `--json` is an array of `{ id, ...fields }` objects.

| Flag             | Notes                                                |
| ---------------- | ---------------------------------------------------- |
| `--json <array>` | Required. JSON array of `{ id, ...fields }` updates. |

## delete [#delete]

```sh
geni crm companies delete cmp_01HX cmp_01HY
```

Delete one or more companies by id.

| Arg        | Notes                  |
| ---------- | ---------------------- |
| `<ids...>` | Company ids to delete. |