---
updatedAt: 2026-09-07T19:54:33.000Z
agentTools:
  projectIndex: https://docs.infiniaweb.com/llms.txt
---

# Trace a deposit by rail reference

Traces an incoming deposit to one of your virtual accounts by the reference on the payer's receipt, and tells you what happened to it: credited, still pending, rejected, expired, or settled on the payment rail but never credited.

The reference is the rail's own identifier for the transfer:

- **BRL** — the Pix end-to-end ID, a 32-character code starting with `E`.
- **ARS** — the Coelsa transfer ID.

Pix end-to-end IDs are often transcribed by hand, where the letter `O` and the digit `0` are easily confused, so for **BRL** those variations are tried as well. When the match came from a corrected reference, `typo_corrected` is `true` and `matched_reference` holds the reference that actually matched. Coelsa IDs are matched exactly, so for **ARS** `typo_corrected` is always `false`.

The lookup is read-only and scoped to the authenticated company and its sub-companies.

# OpenAPI definition

```json
{
  "openapi": "3.1.0",
  "info": {
    "title": "Troubleshooting",
    "description": "Read-only lookups that trace transfers by their payment-rail reference.",
    "version": "0.1.0"
  },
  "servers": [
    {
      "url": "https://app2test.infiniaweb.com/infinia_api/v1/troubleshooting",
      "description": "Sandbox"
    }
  ],
  "paths": {
    "/deposits/": {
      "get": {
        "tags": [
          "Troubleshooting"
        ],
        "summary": "Trace a deposit by rail reference",
        "description": "Traces an incoming deposit to one of your virtual accounts by the reference on the payer's receipt, and tells you what happened to it: credited, still pending, rejected, expired, or settled on the payment rail but never credited.\n\nThe reference is the rail's own identifier for the transfer:\n\n- **BRL** — the Pix end-to-end ID, a 32-character code starting with `E`.\n- **ARS** — the Coelsa transfer ID.\n\nPix end-to-end IDs are often transcribed by hand, where the letter `O` and the digit `0` are easily confused, so for **BRL** those variations are tried as well. When the match came from a corrected reference, `typo_corrected` is `true` and `matched_reference` holds the reference that actually matched. Coelsa IDs are matched exactly, so for **ARS** `typo_corrected` is always `false`.\n\nThe lookup is read-only and scoped to the authenticated company and its sub-companies.",
        "operationId": "v1_0_lookup_deposit_",
        "security": [
          {
            "HTTPBasic": []
          }
        ],
        "parameters": [
          {
            "name": "currency",
            "in": "query",
            "required": true,
            "schema": {
              "$ref": "#/components/schemas/DepositLookupCurrency",
              "description": "Rail of the deposit, which decides how `reference` is read.\n\n- `BRL` — Pix; the reference is the end-to-end ID.\n- `ARS` — Transferencias 3.0; the reference is the Coelsa transfer ID."
            },
            "description": "Rail of the deposit, which decides how `reference` is read.\n\n- `BRL` — Pix; the reference is the end-to-end ID.\n- `ARS` — Transferencias 3.0; the reference is the Coelsa transfer ID."
          },
          {
            "name": "reference",
            "in": "query",
            "required": true,
            "schema": {
              "type": "string",
              "minLength": 1,
              "maxLength": 64,
              "description": "The rail reference of the transfer, as shown on the payer's receipt.",
              "title": "Reference"
            },
            "description": "The rail reference of the transfer, as shown on the payer's receipt."
          },
          {
            "name": "x-company-id",
            "in": "header",
            "required": false,
            "schema": {
              "description": "ID of a child company for authentication. If not provided, the parent company will be authenticated.",
              "title": "X-Company-Id",
              "type": "integer"
            },
            "description": "ID of a child company for authentication. If not provided, the parent company will be authenticated."
          }
        ],
        "responses": {
          "200": {
            "description": "The lookup resolved; branch on `data.result`.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/DepositLookupResponse"
                }
              }
            }
          },
          "400": {
            "description": "The reference is not valid for the rail, or the currency is not enabled for the company.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            }
          },
          "401": {
            "description": "Invalid credentials.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            }
          },
          "404": {
            "description": "No record of the reference, on our side or on the rail.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            }
          },
          "422": {
            "description": "Validation Error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/HTTPValidationError"
                }
              }
            }
          }
        }
      }
    }
  },
  "components": {
    "schemas": {
      "DepositLookupCurrency": {
        "type": "string",
        "enum": [
          "BRL",
          "ARS"
        ],
        "title": "DepositLookupCurrency",
        "description": "Rails the lookup can trace. The reference is the rail's own id for the transfer."
      },
      "DepositLookupData": {
        "properties": {
          "currency": {
            "$ref": "#/components/schemas/DepositLookupCurrency"
          },
          "reference": {
            "type": "string",
            "title": "Reference",
            "description": "The reference exactly as it was sent"
          },
          "matched_reference": {
            "type": "string",
            "title": "Matched Reference",
            "description": "The reference that matched; differs from `reference` only when a typo was corrected"
          },
          "typo_corrected": {
            "type": "boolean",
            "title": "Typo Corrected",
            "description": "`true` when the reference you sent did not match but an `O`/`0` variation of it did, in which case `matched_reference` holds the one that matched.\n\nOnly Pix end-to-end IDs are matched that way; a Coelsa ID must be exact, so for `ARS` this is always `false`."
          },
          "result": {
            "$ref": "#/components/schemas/DepositLookupResult",
            "description": "What happened to the transfer:\n\n- `CREDITED` — credited to one of your accounts; see `movement`.\n- `PAYOUT` — the reference belongs to a transfer you sent, not one you received.\n- `OTHER_COMPANY` — credited to an account outside your company structure. No further details are disclosed.\n- `PENDING` — known to the rail, funds not settled yet.\n- `REJECTED` — declined by the rail; see `reason` and `description`.\n- `EXPIRED` — expired before the payer approved it.\n- `NOT_CREDITED` — settled on the rail but not credited to your account. Contact support.\n- `LOOKUP_FAILED` — the rail could not resolve the reference right now. Retry in a few minutes."
          },
          "reason": {
            "title": "Reason",
            "description": "The rail's own status or rejection code, as it reports it (for example `SENDER_NOT_ALLOWED`, `INICIADO`, `CP001`).\n\n`null` when the lookup did not need to ask the rail.",
            "type": "string"
          },
          "description": {
            "title": "Description",
            "description": "Human-readable explanation of the result",
            "type": "string"
          },
          "amount": {
            "title": "Amount",
            "description": "Amount of the transfer as reported by the rail",
            "type": "number"
          },
          "sender": {
            "$ref": "#/components/schemas/DepositLookupSender"
          },
          "rail_date": {
            "title": "Rail Date",
            "description": "When the rail registered the transfer (UTC)",
            "type": "string",
            "format": "date-time"
          },
          "expires_at": {
            "title": "Expires At",
            "description": "When a transfer awaiting approval expires (UTC)",
            "type": "string",
            "format": "date-time"
          },
          "movement": {
            "description": "The entry in your account for this transfer. Present only for `CREDITED` and `PAYOUT`; `null` for every other result.",
            "$ref": "#/components/schemas/DepositLookupMovement"
          }
        },
        "type": "object",
        "required": [
          "currency",
          "reference",
          "matched_reference",
          "typo_corrected",
          "result"
        ],
        "title": "DepositLookupData"
      },
      "DepositLookupMovement": {
        "properties": {
          "id": {
            "type": "string",
            "title": "Id"
          },
          "account_id": {
            "type": "string",
            "title": "Account Id"
          },
          "amount": {
            "type": "number",
            "title": "Amount",
            "description": "Positive for a credit, negative for a payout"
          },
          "currency": {
            "type": "string",
            "title": "Currency"
          },
          "created_at": {
            "title": "Created At",
            "type": "string",
            "format": "date-time"
          }
        },
        "type": "object",
        "required": [
          "id",
          "account_id",
          "amount",
          "currency"
        ],
        "title": "DepositLookupMovement",
        "description": "The credit (or, for PAYOUT, the debit) in the caller's account."
      },
      "DepositLookupResponse": {
        "properties": {
          "status": {
            "type": "string",
            "title": "Status",
            "default": "success",
            "enum": [
              "success"
            ]
          },
          "data": {
            "$ref": "#/components/schemas/DepositLookupData"
          }
        },
        "type": "object",
        "required": [
          "data"
        ],
        "title": "DepositLookupResponse"
      },
      "DepositLookupResult": {
        "type": "string",
        "enum": [
          "CREDITED",
          "PAYOUT",
          "OTHER_COMPANY",
          "PENDING",
          "REJECTED",
          "EXPIRED",
          "NOT_CREDITED",
          "LOOKUP_FAILED"
        ],
        "title": "DepositLookupResult"
      },
      "DepositLookupSender": {
        "properties": {
          "full_name": {
            "title": "Full Name",
            "type": "string"
          },
          "document_number": {
            "title": "Document Number",
            "type": "string"
          },
          "bank_code": {
            "title": "Bank Code",
            "type": "string"
          },
          "bank_name": {
            "title": "Bank Name",
            "type": "string"
          },
          "account_number": {
            "title": "Account Number",
            "type": "string"
          }
        },
        "type": "object",
        "title": "DepositLookupSender",
        "description": "Payer details as reported by the rail, using the same field names as a\nmovement's FIAT third party. Available when the rail was consulted; a\ncredited deposit is identified by its movement instead."
      },
      "ErrorResponse": {
        "properties": {
          "status": {
            "type": "string",
            "enum": [
              "error",
              "fail"
            ],
            "title": "Status",
            "default": "error"
          },
          "message": {
            "title": "Message",
            "type": "string"
          },
          "error_code": {
            "title": "Error Code",
            "type": "string"
          },
          "trace_id": {
            "title": "Trace Id",
            "type": "string"
          }
        },
        "type": "object",
        "required": [
          "message"
        ],
        "title": "Error Response"
      },
      "HTTPValidationError": {
        "properties": {
          "detail": {
            "items": {
              "$ref": "#/components/schemas/ValidationError"
            },
            "type": "array",
            "title": "Detail"
          }
        },
        "type": "object",
        "title": "HTTPValidationError"
      },
      "ValidationError": {
        "properties": {
          "loc": {
            "items": {
              "anyOf": [
                {
                  "type": "string"
                },
                {
                  "type": "integer"
                }
              ]
            },
            "type": "array",
            "title": "Location"
          },
          "msg": {
            "type": "string",
            "title": "Message"
          },
          "type": {
            "type": "string",
            "title": "Error Type"
          },
          "input": {
            "title": "Input"
          },
          "ctx": {
            "type": "object",
            "title": "Context"
          }
        },
        "type": "object",
        "required": [
          "loc",
          "msg",
          "type"
        ],
        "title": "ValidationError"
      }
    },
    "securitySchemes": {
      "HTTPBasic": {
        "type": "http",
        "scheme": "basic"
      }
    }
  }
}
```