> ## 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

> Search Mexico's SIEM business directory by commercial name or razón social, filter by state and activity, and pull each establishment's declared 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. Default `0`. |
| `activity_code` | integer | SCIAN activity code (exact match). Omit or `0` to search all activities. Default `0`. |
| `page` | integer | 1-based page number. 10 per page. Default `1`. |

```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, all response fields, and an interactive playground.
</Card>


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.