Dashboard
GuidesAPI Reference

Movement Object

{
    "id": "mov_BO381oEATXonG6bj",
    "object": "movement",
    "amount": 59400,
    "post_date": "2020-04-17T00:00:00.000Z",
    "description": "Traspaso de:Fintoc SpA",
    "transaction_date": "2020-04-16T11:31:12.000Z",
    "currency": "CLP",
    "reference_id": "123740123",
    "type": "transfer",
    "pending": false,
    "recipient_account": null,
    "sender_account": {
        "holder_id": "771806538",
        "holder_name": "Comercial y Producción SpA",
        "number": "1530108000",
        "institution": {
          "id": "cl_banco_de_chile",
          "name": "Banco de Chile",
          "country": "cl"
        }
    },
    "comment": "Pago factura 198"
}
AttributeTypeDescription
idstringUnique identifier for the Movement
objectstringIdentifier for the type of object. Its value for Movements will always correspond to movement
amountintegerAmount of the movement, represented as an integer.
This number is positive when money enters the bank account and negative when money leaves the bank account. For example, buying something will be reflected as a movement with a negative amount attribute, while receiving a transfer will be reflected as a movement with a positive amount attribute
post_datestringMovement's accounting date, using ISO 8601
descriptionstringDescription for the movement, retrieved from the institution
transaction_datestringDate and time in which the Movement was made, using ISO 8601. It can be null
currencystringCurrency ISO code
reference_idstringMovement's identifier retrieved from the institution. It can be null.
If the Movement is a transfer, it represents the operation number or transaction id. If the Movement is a check, it represents the document number
typestringType of movement. Its values can be transfer, check or other
pendingbooleanIf the movement is a check, this field indicates whether confirmation by the bank is pending. If the movement isn't a check, this attribute is false
recipient_accountobjectIf the movement is a transfer, this attribute indicates the account to which the transfer was made. It can be null. Take a look at the Transfer Acccount object table below to learn more
sender_accountobjectIf the movement is a transfer, this attribute indicates the account that made the transfer. It can be null. Take a look at the Transfer Acccount object table below to learn more
commentstringIf the movement is a transfer, this attribute indicates the transfer comment. It can be null

📘

Post date and transaction date

As you probably noticed, each movement includes two different dates: a post_date and a transaction_date 🧐. This is because the bank uses accounting dates internally. Some bank even create movements in the future. For example, if you make a transaction on a Saturday, this transaction will appear to have Monday as its date. In this example, Saturday corresponds to the transaction_date, and Monday corresponds to the post_date.

📘

Pending checks

Checks take some time to be confirmed by the bank. This can take as long as 48 business hours. Pending checks can be reversed for several reasons (for example, lack of funds). Fintoc marks pending checks with the pending flag so you know that the movement isn't yet confirmed by the bank.

Transfer Account Object

AttributeTypeDescription
holder_idstringIdentifier of the owner of the account. In Chile, it corresponds to a RUT
holder_namestringName of the owner of the account
numberstringAccount number. Does not include hyphens nor prefixed zeros. It can be null
institutionobjectInstitution to which the account belongs. It can be null