Listar Operaciones por Cuenta

curl --request GET \
  --url https://transaction.sandbox.lerian.net/v1/organizations/{organization_id}/ledgers/{ledger_id}/accounts/{account_id}/operations \
  --header 'Content-Type: <content-type>'

{
  "items": [
    {
      "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
      "transactionId": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
      "organizationId": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
      "ledgerId": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
      "accountId": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
      "accountAlias": "<string>",
      "balanceId": "<string>",
      "balanceKey": "<string>",
      "description": "<string>",
      "type": "CREDIT",
      "assetCode": "<string>",
      "chartOfAccounts": "<string>",
      "route": "<string>",
      "amount": {
        "value": "<string>"
      },
      "balance": {
        "available": "<string>",
        "onHold": "<string>"
      },
      "balanceAfter": {
        "available": "<string>",
        "onHold": "<string>"
      },
      "status": {
        "code": "<string>",
        "description": "<string>"
      },
      "balanceAffected": true,
      "createdAt": "2023-11-07T05:31:56Z",
      "updatedAt": "2023-11-07T05:31:56Z",
      "deletedAt": "2023-11-07T05:31:56Z",
      "metadata": {}
    }
  ],
  "next_cursor": "<string>",
  "limit": 123
}

GET

organizations

{organization_id}

ledgers

{ledger_id}

accounts

{account_id}

operations

Listar Operaciones por Cuenta

curl --request GET \
  --url https://transaction.sandbox.lerian.net/v1/organizations/{organization_id}/ledgers/{ledger_id}/accounts/{account_id}/operations \
  --header 'Content-Type: <content-type>'

{
  "items": [
    {
      "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
      "transactionId": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
      "organizationId": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
      "ledgerId": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
      "accountId": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
      "accountAlias": "<string>",
      "balanceId": "<string>",
      "balanceKey": "<string>",
      "description": "<string>",
      "type": "CREDIT",
      "assetCode": "<string>",
      "chartOfAccounts": "<string>",
      "route": "<string>",
      "amount": {
        "value": "<string>"
      },
      "balance": {
        "available": "<string>",
        "onHold": "<string>"
      },
      "balanceAfter": {
        "available": "<string>",
        "onHold": "<string>"
      },
      "status": {
        "code": "<string>",
        "description": "<string>"
      },
      "balanceAffected": true,
      "createdAt": "2023-11-07T05:31:56Z",
      "updatedAt": "2023-11-07T05:31:56Z",
      "deletedAt": "2023-11-07T05:31:56Z",
      "metadata": {}
    }
  ],
  "next_cursor": "<string>",
  "limit": 123
}

Headers

Authorization

string

Token de autorización. Este encabezado es obligatorio si tu entorno tiene habilitado el Access Manager.

Content-Type

string

required

Tipo de medio del recurso. Debe ser application/json.

X-Request-Id

string

Identificador único usado para rastrear cada solicitud.

Path Parameters

organization_id

string

required

Identificador único de la organización asociada al ledger.

ledger_id

string

required

Identificador único del ledger asociado.

account_id

string

required

Identificador único de la cuenta de la que deseas obtener los saldos.

Query Parameters

limit

string

required

Número máximo de elementos que se incluirán en la respuesta.

start_date

string

Inicio del período que deseas recuperar. Debes incluir también el parámetro end_date.

end_date

string

Fin del período que deseas recuperar. Debes incluir también el parámetro start_date.

sort_order

enum<enum>

Orden utilizado para clasificar los resultados.

Opciones disponibles:

asc,

desc

cursor

string

Posición dentro del conjunto de datos donde debe comenzar la siguiente página de resultados.

type

enum<enum>

Tipo de operación.

Opciones disponibles:

CREDIT,

DEBIT,

ON_HOLD,

RELEASE

Response

Indica que la solicitud se realizó correctamente y la respuesta contiene los datos esperados.

items

object[]

Mostrar atributos secundarios

items.id

string<uuid>

Identificador único de la operación.

items.transactionId

string<uuid>

Identificador único de la transacción.

items.organizationId

string<uuid>

Identificador único de la organización.

items.ledgerId

string<uuid>

Identificador único del ledger.

items.accountId

string<uuid>

Identificador único de la cuenta.

items.accountAlias

string

Alias de la cuenta usado en la operación.

items.balanceId

string

Identificador único del saldo.

items.balanceKey

string

Clave única que identifica el saldo.

items.description

string

Descripción de la transacción.

items.type

enum<string>

Tipo de la operación.

Opciones disponibles:

CREDIT,

DEBIT,

ON_HOLD,

RELEASE

items.assetCode

string

Nombre del activo utilizado en la operación.

items.chartOfAccounts

string

Nombre del plan de cuentas al que pertenece la operación.

items.route

string

ID único de la ruta de operación para esta pierna de la transacción. Debe coincidir con la configuración de origen y destino para definir cómo se mueve el valor entre las cuentas.

items.amount

object

Objeto que contiene información sobre el monto utilizado en la operación.

Mostrar atributos secundarios

items.amount.value

string

Monto que se enviará.

items.balance

object

Objeto que contiene información sobre el saldo antes de la operación.

Mostrar atributos secundarios

items.balance.available

string

Saldo disponible previo.

items.balance.onHold

string

Monto retenido/reservado.

items.balanceAfter

object

Objeto que contiene información sobre el saldo después de la operación.

Mostrar atributos secundarios

items.balanceAfter.available

string

Current available balance.

items.balanceAfter.onHold

string

Monto retenido/reservado.

items.status

object

Estado de la transacción (pendiente, completada, revertida).

Mostrar atributos secundarios

items.status.code

string

Código del estado de la transacción.

items.status.description

string | null

Descripción del estado de la transacción.

items.balanceAffected

boolean

Si es verdadero, indica que la operación afectó el saldo de la cuenta.

items.createdAt

string<date-time>

Marca de tiempo de creación (UTC).

items.updatedAt

string<date-time>

Marca de tiempo de la última actualización (UTC).

items.deletedAt

string<date-time> | null

Marca de tiempo de la eliminación lógica, si aplica (UTC).

items.metadata

object

Objeto que contiene pares clave-valor para agregar como metadatos, donde el campo name es la clave y el campo value es el valor. Por ejemplo, para agregar un centro de costos, usa 'costCenter': 'BR_11101997'.

Mostrar atributos secundarios

items.metadata.{key}

string

next_cursor

string

Posición dentro del conjunto de datos de la siguiente página de resultados.

limit

integer

Número máximo de elementos incluidos en la respuesta.

Crear una Anotación de Transacción

Obtener una Operación

⌘I

Organizations API

Ledgers API

Assets API

Account Types API

Accounts API

Portfolios API

Segments API

Balances API

Transactions API

Operations API

Operation Routes API

Transaction Routes API

Manejo de errores

Listar Operaciones por Cuenta

Headers

Path Parameters

Query Parameters

Response