---
title: "Consult Operation"
method: GET
path: "/api/v1/cash/consult"
---

# Consult Operation

`GET /api/v1/cash/consult`

Retrieves the current status and details of a cash operation using its reference number.
Use this endpoint to check the status of cash-in or cash-out operations.

## Query parameters

- `reference` string, required

## Headers

- `X-Client-Id` string, required
- `X-Signature` string, required
- `X-Timestamp` string, required

## Response `200`

Operation found successfully

- ConsultOperationResponse
  - `response_code` string — Response code ("0" for success)
  - `response_text` string — Response message
  - `result` object
    - `operation_id` integer — Unique identifier for the operation
    - `kind` 'cash_in' | 'cash_out' — Operation type
    - `reference` string — 20-digit operation reference number
    - `status` 'close' | 'paid' | 'expired' | 'reversed' — Current operation status
    - `amount` integer — Transaction amount in MXN
    - `created_at` string, date-time — ISO 8601 timestamp of operation creation
    - `expire_at` string, date-time — ISO 8601 timestamp when operation expires

## Other responses

- `400` — Bad Request - Invalid operation parameters
- `401` — Unauthorized - Invalid or missing authentication
- `404` — Operation not found

---

[API](https://skmtc.net/monato/apis/cash-api.md) · [All operations](https://skmtc.net/monato/apis/cash-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/monato/cash-api/revisions/eb100e723d5e/schema)
