> For the complete documentation index, see [llms.txt](https://docs.facephi.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.facephi.com/productos/landing/resultados-y-callbacks/consulta-de-operaciones.md).

# Consulta de operaciones

Mediante peticiones get es posible consultar el listado de operaciones y el estado de una operación asociada a un `operationId`.

## Autenticación

Para la solicitud de información de estados de operación son necesarias las siguientes credenciales.

* `x-api-key`: API key de la landing.
* `x-client-id`: Client ID asociado a la API key.

Estos datos serán ofrecidos por el equipo de Facephi.

***

## Servicios

Es posible solicitar el listado de operaciones realizadas o el estado de una operación concreta mediante una petición **GET**.

### Listado de operaciones

Para obtener el listado de operaciones podremos utilizar una petición GET al endpoint `https://api.landing.identity-platform.io/callback`:

```bash
curl -X 'GET' \
  'https://api.landing.identity-platform.io/callback' \
  -H 'accept: application/json' \
  -H 'x-api-key: PRIVATE_API_KEY' \
  -H 'x-client-id: PRIVATE_CLIENT_ID'
```

Esto dará una respuesta con el listado de operaciones, con el *operationId* y el *timestamp* de cada una:

```json
{
  "operations": [
    {
      "operationId": "UNIQUE_OPERATION_ID_1",
      "timestamp": "2025-12-22T07:59:53.517Z"
    },
    {
      "operationId": "UNIQUE_OPERATION_ID_2",
      "timestamp": "2025-12-22T07:58:44.071Z"
    },
    ...
  ]
}
```

#### Filtrar operaciones por tiempo:

Es posible filtrar los resultados por fecha/hora con el uso de los siguientes parámetros:

* `startDate`: Tiempo inicial. (Formato: ISO 8601, Ej: 2024-01-01T00:00:00Z)
* `endDate`: Tiempo final. (Formato: ISO 8601, Ej: 2024-12-31T23:59:59Z)

```bash
curl -X 'GET' \
  'https://api.landing.identity-platform.io/callback?startDate=2025-12-22T07%3A52%3A57.231Z&endDate=2025-12-22T07%3A58%3A45.000Z' \
  -H 'accept: application/json' \
  -H 'x-api-key: PRIVATE_API_KEY' \
  -H 'x-client-id: PRIVATE_CLIENT_ID'
```

Este tipo de peticiones devolverá los resultados filtrados con las operaciones realizadas en ese intervalo de tiempo.

### Estado de operación

Para obtener el estado de una operación podremos utilizar una petición GET al endpoint `https://api.landing.identity-platform.io/callback/OPERATION_ID`, utilizando el `OPERATION_ID` de la operación deseada

```bash
curl -X 'GET' \
  'https://api.landing.identity-platform.io/callback/b682caa8-f0da-4fc5-a373-24a3b81a889b' \
  -H 'accept: application/json' \
  -H 'x-api-key: PRIVATE_API_KEY' \
  -H 'x-client-id: PRIVATE_CLIENT_ID'
```

#### Respuestas de peticiones de estado

Estas peticiones pueden resolverse con los siguientes códigos:

El usuario ha terminado la operación:

* `SUCCESS`: La petición se ha realizado correctamente.
* `DENIED`: La petición no se ha podido realizar por falta de credenciales.
* `ERROR`: La petición no ha podido realizar por algún tipo de error.

El flujo aún no ha sido finalizado por el usuario:

* `NOT_FINISHED`: La operación no ha finalizado. Dentro de este estado se encontrará mas información:
  * `reason`: Motivo del estado.
  * `step_result`: Estado del flujo.

**Ejemplo de respuesta satisfactoria**:

```json
{
  "operationId": "OPERAtION_ID",
  "operation_result": "SUCCEEDED",
  "callback_result": {
    "id": "a85b2714-1968-4306-adda-cc1b20ec04a9",
    "auth": {},
    "callback": {
      "request": {
        "url": "https://webhook.site/e8865aec-75e7-4474-87ef-69280bdde8b5",
        "method": "post",
        "header": {
          "Accept": "application/json, text/plain, */*",
          "Content-Type": "application/json",
          "User-Agent": "axios/1.5.1",
          "Content-Length": "CONTENT_LENGHT",
          "Accept-Encoding": "gzip, compress, deflate, br"
        },
        "body": "RECIEVED_DATA"
      },
      "response": {
        "status": 200,
        "body": "This URL has no default content configured. <a href=\"https://webhook.site/#!/edit/e8865aec-75e7-4474-87ef-69280bdde8b5\">Change response in Webhook.site</a>."
      }
    },
    "operationId": "OPERAtION_ID",
    "landingId": "LANDING_ID",
    "timestamp": "2025-12-15T14:00:10.755Z"
  }
}
```