---
title: "SIEM Establishment"
method: POST
path: "/mx/siem/establishment/v1"
tags: ["Mexico", "SIEM"]
---

# SIEM Establishment

`POST /mx/siem/establishment/v1`

## Request

- Base URL: `https://api.croma.run`
- URL: `https://api.croma.run/mx/siem/establishment/v1`
- Auth: HTTP bearer

Retrieve one SIEM establishment's declared profile: RFC, legal or personal name, commercial name, activity, address and contact, headcount, import/export flags, declared products and services, and registration status. Returns `found: false` when the id is unknown.

Supports async delivery: set `Prefer: wait=N` for an inline result, pass `callback_url` to receive a POST when ready, or poll `GET /jobs/{id}`.

## Headers

- `Idempotency-Key` string
- `Prefer` string

## Request body

- object
  - `establishment_id` string, required: Establishment id returned by the search (`establishment_id`).
  - `callback_url` string, uri: POST the job result here when it finishes.

## Response `200`

Successful response

- SiemEstablishmentResponse
  - `data` SiemEstablishmentData, required
    - `found` boolean, required: Whether the id is known. When false, `establishment` is null.
    - `establishment_id` string, required: The queried id, echoed back.
    - `establishment` object, nullable, required
      - `rfc` string, nullable, required
      - `legal_name` string, nullable, required: Razón social (personas morales); null for personas físicas.
      - `person_name` string, nullable, required: Full name (personas físicas); null for personas morales.
      - `commercial_name` string, nullable, required
      - `main_activity` string, nullable, required
      - `activity_code` number, nullable, required: SCIAN activity code.
      - `state` string, nullable, required
      - `state_code` number, nullable, required
      - `municipality_code` number, nullable, required
      - `status` string, nullable, required: Registration status, e.g. "Actualizado".
      - `public_listing` boolean, required: Whether the establishment opted into the public listing.
      - `registration_date` string, nullable, required
      - `updated_date` string, nullable, required
      - `expiration_date` string, nullable, required
      - `location` object, nullable, required
        - `street` string, nullable, required
        - `exterior_number` string, nullable, required
        - `interior_number` string, nullable, required
        - `neighborhood` string, nullable, required
        - `postal_code` string, nullable, required
        - `municipality` string, nullable, required
        - `between_streets` string, nullable, required: Cross streets ("entre calles"), joined when both are declared.
        - `phone` string, nullable, required
        - `email` string, nullable, required
        - `website` string, nullable, required
      - `profile` object, nullable, required
        - `start_date` string, nullable, required: Declared start of operations (yyyy-mm-dd).
        - `employees` number, nullable, required
        - `women_employees` number, nullable, required
        - `exports` boolean, required
        - `imports` boolean, required
        - `government_supplier` boolean, required
        - `activities` string[], required: Declared secondary activities.
        - `chamber` string, nullable, required
        - `business_group` string, nullable, required
      - `products` string[], required: Declared goods.
      - `services` string[], required: Declared services.
      - `export_countries` string[], required
      - `import_countries` string[], required

## Other responses

- `202`: Accepted — the result is being computed asynchronously. Poll `job.status_url` (GET /jobs/{id}) or supply `callback_url` to have the result POSTed to you. Returned when `Prefer: wait` elapses before completion, or immediately when `callback_url` is set.
- `400`: Invalid request body
- `401`: Missing or invalid API key
- `429`: Rate limit exceeded
- `500`: Internal error
- `502`: Upstream source returned an error

---

[API](https://skmtc.dev/usecroma/apis/croma-marketplace-api.md) · [All operations](https://skmtc.dev/usecroma/apis/croma-marketplace-api/llms.txt) · [OpenAPI document](https://skmtc.dev/usecroma/apis/croma-marketplace-api/revisions/df016cdb29d7?raw)