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

# API comercio exterior Mexico | Camtom API

> API REST para clasificacion arancelaria y extraccion de documentos aduaneros. Integra IA de comercio exterior en tu sistema.

La API de Camtom te permite integrar clasificacion arancelaria y extraccion de documentos directamente en tu sistema. Dos endpoints principales, una sola autenticacion, resultados en segundos.

## Base URL

Todas las peticiones van a:

```
https://api.camtomx.com
```

## Endpoints disponibles

<CardGroup cols={2}>
  <Card title="TariffPro Mini" icon="magnifying-glass" href="/api/tariffpro-mini">
    Clasificacion arancelaria interactiva. Envia una descripcion, imagenes o documentos y recibe codigos HS sugeridos con nivel de confianza.
  </Card>

  <Card title="CamtomDocs Extract" icon="file-lines" href="/api/camtomdocs-general">
    Extraccion de datos de documentos aduaneros. Envia un PDF o imagen con un JSON Schema y recibe datos estructurados.
  </Card>
</CardGroup>

## Quick start

Clasifica un producto con `multipart/form-data`:

<CodeGroup>
  ```python Python theme={null}
  import requests

  response = requests.post(
      "https://api.camtomx.com/api/v3/tariffpro/tariffpro-mini",
      headers={"Authorization": "Bearer sk_tu_api_key"},
      params={"country_code": "MEX", "model": "pro"},
      data={"product_description": "Camiseta de algodon para hombre, tejida, talla M"}
  )
  print(response.json())
  ```

  ```javascript JavaScript theme={null}
  const formData = new FormData();
  formData.append("product_description", "Camiseta de algodon para hombre, tejida, talla M");

  const response = await fetch(
    "https://api.camtomx.com/api/v3/tariffpro/tariffpro-mini?country_code=MEX&model=pro",
    {
      method: "POST",
      headers: {
        "Authorization": "Bearer sk_tu_api_key"
      },
      body: formData
    }
  );
  const data = await response.json();
  console.log(data);
  ```

  ```bash cURL theme={null}
  curl -X POST "https://api.camtomx.com/api/v3/tariffpro/tariffpro-mini?country_code=MEX&model=pro" \
    -H "Authorization: Bearer sk_tu_api_key" \
    -F "product_description=Camiseta de algodon para hombre, tejida, talla M"
  ```
</CodeGroup>

Respuesta:

```json theme={null}
{
  "hscodes_array": [
    {
      "hscode_2digits": { "name": "Prendas y complementos de vestir, de punto", "code": "61" },
      "hscode_4digits": { "name": "Camisetas de punto", "code": "6109" },
      "hscode_6digits": { "name": "De algodon", "code": "6109.10" },
      "hscode_8digits": { "name": "Camisetas de algodon", "code": "6109.10.01" },
      "overall_confidence": 0.92,
      "justification": "Producto textil de punto de algodon para hombre...",
      "recommendations": "...",
      "tariff_info": {}
    }
  ],
  "summary_classification": "Camiseta de punto de algodon para hombre",
  "required_questions": [],
  "classification_record_id": "abc123"
}
```

## Sistema de creditos

Cada llamada a la API consume creditos de tu organizacion:

| Endpoint           | Costo                                                         |
| ------------------ | ------------------------------------------------------------- |
| TariffPro Mini     | 1 credito por clasificacion                                   |
| CamtomDocs Extract | Segun paginas procesadas (ver `billed_pages` en la respuesta) |

Los creditos disponibles se consultan desde `organization.subscription.limits`. Puedes ver tu saldo desde [app.camtomx.com](https://app.camtomx.com).

## Siguientes pasos

<CardGroup cols={2}>
  <Card title="Autenticacion" icon="key" href="/api/authentication">
    Obtener tu API key y configurar la autenticacion.
  </Card>

  <Card title="TariffPro Mini" icon="magnifying-glass" href="/api/tariffpro-mini">
    Documentacion completa del endpoint de clasificacion arancelaria.
  </Card>

  <Card title="CamtomDocs Extract" icon="file-lines" href="/api/camtomdocs-general">
    Documentacion completa del endpoint de extraccion de documentos.
  </Card>

  <Card title="Codigos de error" icon="triangle-exclamation" href="/api/errors">
    Referencia de errores y como resolverlos.
  </Card>
</CardGroup>