Tablas

Listar, consultar y eliminar tablas.

Descripción general

Estas tres peticiones permiten a tus sistemas ver qué tiene un departamento. Consulta la lista de sus tablas para comprobar que una subida ha terminado, obtén una para ver sus columnas o borra una tabla que ya no necesites.

Para	Envía
Ver la lista de tablas de un departamento	`GET /v1.0/projects/{ProjectID}/cards`
Obtener una tabla	`GET /v1.0/projects/{ProjectID}/cards/{CardID}`
Borrar una tabla	`DELETE /v1.0/projects/{ProjectID}/cards/{CardID}`

Todas las direcciones empiezan por la URL base, https://searchmira.com/api. ProjectID es el id del departamento y CardID, el de la tabla. En Descripción general y autenticación se explica dónde encontrar los dos. Cada petición lleva tu cabecera X-API-Key.

Consultar la lista y obtener una tabla no consume créditos.

Ver la lista de tablas de un departamento

GET https://searchmira.com/api/v1.0/projects/{ProjectID}/cards

Recibes todas las tablas del departamento que puedes ver, con un breve resumen de cada una:

{
  "Msg": "OK",
  "ExecTime": 0.575,
  "Cards": [
    {
      "CardID": "CRD-c3b...",
      "CardName": "Leads",
      "Rows": 150,
      "Domain": "Sales",
      "Processed": true,
      "SuccessfulUpload": true,
      "ConnectorSource": "Hubspot",
      "ConnectorStatus": "active",
      "UploadCompletionTime": "2026-04-28T14:14:22",
      "LockedFromDelete": false
    }
  ]
}

Campo	Qué te dice
`CardID`	El id de la tabla.
`CardName`	El nombre de la tabla, tal como la ve la gente en Mira.
`Rows`	Cuántas filas tiene.
`Domain`	El área temática a la que pertenece la tabla.
`Processed`	`true` cuando Mira ha terminado de leer el archivo. Hasta entonces no se pueden hacer preguntas sobre la tabla.
`SuccessfulUpload`	Si el archivo se leyó sin problemas.
`ConnectorSource`	El sistema del que viene la tabla, si viene de un sistema conectado y no de una subida.
`ConnectorStatus`	En un sistema conectado: `active` o `paused`.
`UploadCompletionTime`	Cuándo terminó Mira de leer el último archivo.
`LockedFromDelete`	`true` si ahora mismo no se puede borrar la tabla. Más información abajo.

Para esperar a que termine una subida, consulta la lista de tablas cada cierto tiempo y busca tu CardID con Processed en true.

Ejemplo

curl https://searchmira.com/api/v1.0/projects/YOUR_PROJECT_ID/cards \
  -H "X-API-Key: YOUR_API_KEY"

Obtener una tabla

GET https://searchmira.com/api/v1.0/projects/{ProjectID}/cards/{CardID}

Recibes el mismo resumen que en la lista, más una descripción de la tabla y de sus columnas:

{
  "Msg": "OK",
  "ExecTime": 0.575,
  "CardID": "CRD-c3b...",
  "CardName": "Leads",
  "Rows": 150,
  "Domain": "Sales",
  "Processed": true,
  "SuccessfulUpload": true,
  "ConnectorSource": "Hubspot",
  "ConnectorStatus": "active",
  "UploadCompletionTime": "2026-04-28T14:14:22",
  "LockedFromDelete": false,
  "Description": "A collection of sales leads.",
  "Columns": [
    {
      "ColumnName": "id",
      "ColumnDescription": "A unique numeric identifier assigned to each lead.",
      "DataType": "long"
    },
    {
      "ColumnName": "company_name",
      "ColumnDescription": "The name of the company that the lead relates to.",
      "DataType": "string"
    }
  ]
}

Mira escribe las descripciones por su cuenta cuando lee el archivo.

Ejemplo

curl https://searchmira.com/api/v1.0/projects/YOUR_PROJECT_ID/cards/YOUR_CARD_ID \
  -H "X-API-Key: YOUR_API_KEY"

Borrar una tabla

DELETE https://searchmira.com/api/v1.0/projects/{ProjectID}/cards/{CardID}

Esto elimina de Mira la tabla y sus datos. No se puede deshacer. Un borrado correcto devuelve:

{
  "Msg": "OK",
  "ExecTime": 0.575,
  "Success": true
}

Necesitas tener permiso para gestionar los datos del departamento. Si no lo tienes, la petición se rechaza con un 403.

Cuándo se rechaza un borrado

Mira se niega a borrar una tabla, con un 409, en dos casos:

Todavía la está leyendo. Espera a que Processed sea true y vuelve a intentarlo.
Viene de un sistema conectado. Una tabla que alimenta una conexión activa no se puede eliminar con la API mientras esa conexión la siga alimentando.

El campo LockedFromDelete te lo dice por adelantado: cuando es true, el borrado se rechazará.

Ejemplo

curl -X DELETE https://searchmira.com/api/v1.0/projects/YOUR_PROJECT_ID/cards/YOUR_CARD_ID \
  -H "X-API-Key: YOUR_API_KEY"