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

# SIEM

> Mexico's business establishment directory: search by name and pull each establishment's declared commercial profile.

The Sistema de Información Empresarial Mexicano: Mexico's national business
directory, operated through the business chambers. Search establishments by
commercial name or razón social, narrow by state and SCIAN activity, then pull
the declared profile: RFC, activity, address and contact, headcount, foreign
trade, and declared products and services.

## Search establishments

`POST /mx/siem/establishments/v1`

| Field           | Type    | Notes                                                                                        |
| --------------- | ------- | -------------------------------------------------------------------------------------------- |
| `name`          | string  | **Required.** Commercial name or razón social, 2-200 characters. Case-insensitive substring. |
| `state_code`    | integer | INEGI state code (1-32). Omit or `0` to search all states.                                   |
| `activity_code` | integer | SCIAN activity code (exact match). Omit or `0` to search all activities.                     |
| `page`          | integer | 1-based page number. 10 per page.                                                            |

```bash theme={"dark"}
curl https://api.croma.run/mx/siem/establishments/v1 \
  -H "Authorization: Bearer $CROMA_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "name": "OXXO", "state_code": 21 }'
```

Returns `query` (the upper-cased name that was searched), `establishments`,
and `pagination` (`total`, `page`, `page_size`, `total_pages`).

| Field                 | Notes                                                  |
| --------------------- | ------------------------------------------------------ |
| `establishment_id`    | Opaque id; pass it to the detail endpoint below.       |
| `commercial_name`     | Declared commercial name.                              |
| `chamber`             | Business chamber the establishment registered through. |
| `state`, `state_code` | State name and INEGI code (1-32).                      |

## Establishment detail

`POST /mx/siem/establishment/v1`

| Field              | Type   | Notes                                                       |
| ------------------ | ------ | ----------------------------------------------------------- |
| `establishment_id` | string | **Required.** The `establishment_id` from the search above. |

```bash theme={"dark"}
curl https://api.croma.run/mx/siem/establishment/v1 \
  -H "Authorization: Bearer $CROMA_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "establishment_id": "3417757" }'
```

Returns `found`, `establishment_id`, and `establishment` (null when the id is
unknown).

| Field                                                  | Notes                                                                                                                        |
| ------------------------------------------------------ | ---------------------------------------------------------------------------------------------------------------------------- |
| `rfc`                                                  | Tax id, when declared.                                                                                                       |
| `legal_name`, `person_name`                            | Razón social (personas morales) or full name (personas físicas).                                                             |
| `commercial_name`                                      | Declared commercial name.                                                                                                    |
| `main_activity`, `activity_code`                       | Free-text primary activity and SCIAN code.                                                                                   |
| `state`, `state_code`, `municipality_code`             | State name plus INEGI state and municipality codes.                                                                          |
| `status`                                               | Registration status (e.g. `Actualizado`, `Vencido`).                                                                         |
| `public_listing`                                       | Whether the establishment opted into public listing.                                                                         |
| `registration_date`, `updated_date`, `expiration_date` | Registration dates (`yyyy-mm-dd`).                                                                                           |
| `location`                                             | Street address, neighborhood, postal code, municipality, cross streets, phone, email, website.                               |
| `profile`                                              | Start date, headcount (total and women), export/import flags, government-supplier flag, activities, chamber, business group. |
| `products`, `services`                                 | Declared products and services.                                                                                              |
| `export_countries`, `import_countries`                 | Declared export destinations and import origins.                                                                             |

<Note>
  SIEM is a self-declared, voluntary directory: each establishment decides
  whether to register and which fields to publish. Treat results as a declared
  commercial profile, not proof of existence or legitimacy, and treat absence
  as no signal at all.
</Note>

<Note>
  These lookups can take longer than a typical request. They are
  [async jobs](/async-jobs). By default the request waits inline and returns
  `{ data }`, or you can poll / use a `callback_url`.
</Note>

<Card title="Full reference" icon="code" href="/api-reference/overview">
  Schemas, response fields, and an interactive playground.
</Card>