---
updatedAt: 2026-05-27T08:29:42.000Z
agentTools:
  projectIndex: https://docs.bridgeapi.io/llms.txt
---

# List transactions

Return a list of the user's transactions

# OpenAPI definition

```json
{
  "openapi": "3.1.0",
  "info": {
    "title": "Bridge API",
    "version": "2025-01-15",
    "description": "Bridge provides an Open Banking API to initiate payments and aggregate financial data.  \nOur API uses standards such as HTTP verbs, RESTful routing and JSON for payloads.",
    "license": {
      "name": "Proprietary",
      "url": "https://docs.bridgeapi.io"
    },
    "contact": {
      "name": "BridgeAPI",
      "url": "https://bridgeapi.io",
      "email": "support@bridgeapi.io"
    }
  },
  "servers": [
    {
      "description": "Production",
      "url": "https://api.bridgeapi.io"
    }
  ],
  "tags": [
    {
      "name": "Transactions",
      "description": "Transaction resource represents an operation on an account\nIts amount can be either negative or positive. The sign depends on the nature of the transaction (debit - credit)"
    }
  ],
  "paths": {
    "/v3/aggregation/transactions": {
      "summary": "Transactions",
      "description": "Operations on transactions.",
      "parameters": [
        {
          "$ref": "#/components/parameters/version"
        }
      ],
      "get": {
        "tags": [
          "Transactions"
        ],
        "operationId": "GetTransactions",
        "summary": "List transactions",
        "description": "Return a list of the user's transactions",
        "security": [
          {
            "userTokenBearerAuth": [],
            "clientIdAuth": [],
            "clientSecretAuth": []
          }
        ],
        "parameters": [
          {
            "name": "limit",
            "description": "Number of records to return",
            "in": "query",
            "schema": {
              "type": "number",
              "default": 50,
              "minimum": 1,
              "maximum": 500
            }
          },
          {
            "name": "account_id",
            "description": "Filter transactions by account",
            "in": "query",
            "schema": {
              "type": "number",
              "example": 456423147
            }
          },
          {
            "name": "since",
            "description": "Limit transactions to those with an `updated_at` value after the specified timestamp",
            "in": "query",
            "schema": {
              "type": "string",
              "format": "date-time",
              "example": "2025-07-13T00:00:00.000Z"
            }
          },
          {
            "name": "min_date",
            "description": "Limit transactions to those with a `date` value after the specified date",
            "in": "query",
            "schema": {
              "type": "string",
              "format": "date",
              "example": "2025-07-13"
            }
          },
          {
            "name": "max_date",
            "description": "Limit transactions to those with a `date` value before the specified date",
            "in": "query",
            "schema": {
              "type": "string",
              "format": "date",
              "example": "2025-07-31"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "List transactions",
            "content": {
              "application/json": {
                "schema": {
                  "allOf": [
                    {
                      "type": "object",
                      "properties": {
                        "resources": {
                          "type": "array",
                          "items": {
                            "$ref": "#/components/schemas/transaction"
                          }
                        }
                      }
                    },
                    {
                      "$ref": "#/components/schemas/paginated-result"
                    }
                  ]
                },
                "example": {
                  "resources": [
                    {
                      "id": 33000191035700,
                      "provider_external_id": "2026080312345678971e96405379f41bcb5eb8c0f2f3c5244",
                      "clean_description": "CB Mad Cours Marjane M.m G",
                      "provider_description": "PAIEMENT PAR CARTE 09/11/2024 73.6 MAD COURS 0.09402 MARJANE M.M G",
                      "amount": -6.92,
                      "date": "2024-11-09",
                      "booking_date": "2024-11-09",
                      "transaction_date": "2024-11-09",
                      "value_date": "2024-11-09",
                      "updated_at": "2024-11-09T18:10:10.143Z",
                      "currency_code": "EUR",
                      "deleted": false,
                      "category_id": 249,
                      "operation_type": "card",
                      "account_id": 48178050,
                      "future": false
                    },
                    {
                      "id": 33000191035701,
                      "clean_description": "CB Idfs G",
                      "provider_description": "PAIEMENT PAR CARTE 25/11/2024 IDFS T2 G",
                      "amount": -194,
                      "date": "2024-11-25",
                      "booking_date": "2024-11-25",
                      "transaction_date": "2024-11-25",
                      "value_date": "2024-11-25",
                      "updated_at": "2024-11-25T16:10:10.144Z",
                      "currency_code": "EUR",
                      "deleted": false,
                      "category_id": 247,
                      "operation_type": "card",
                      "account_id": 48178050,
                      "future": false
                    }
                  ],
                  "generated_at": "2024-11-25T16:41:18.533Z",
                  "pagination": {
                    "next_uri": "/v3/aggregation/transactions?after=MTczMjExOTAxMDE0MjozMzAwMDE5MTAzNTY5OQ&limit=50"
                  }
                }
              }
            }
          },
          "401": {
            "description": "Error 401",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/error-401"
                }
              }
            }
          }
        }
      }
    }
  },
  "components": {
    "schemas": {
      "error-401": {
        "title": "Error 401",
        "type": "object",
        "example": {
          "errors": [
            {
              "code": "invalid_client_credentials",
              "message": "client_id and client_secret are invalid"
            }
          ]
        },
        "properties": {
          "errors": {
            "type": "array",
            "items": {
              "type": "object",
              "properties": {
                "code": {
                  "description": "Error code",
                  "type": "string"
                },
                "property": {
                  "description": "Property or parameter that is invalid",
                  "type": [
                    "null",
                    "string"
                  ]
                },
                "message": {
                  "description": "Human-readable error description",
                  "type": [
                    "null",
                    "string"
                  ]
                }
              }
            }
          }
        }
      },
      "paginated-result": {
        "title": "Pagination response",
        "description": "Represent paginated collection of resources.",
        "type": "object",
        "properties": {
          "resources": {
            "type": "array",
            "items": {}
          },
          "pagination": {
            "type": "object",
            "properties": {
              "next_uri": {
                "type": [
                  "null",
                  "string"
                ],
                "example": null
              }
            }
          }
        }
      },
      "transaction": {
        "title": "Transaction resource",
        "description": "Transaction resource represents an operation on an account. Its amount can be either negative or positive. The sign depends on the nature of the transaction (debit - credit).",
        "type": "object",
        "required": [
          "id",
          "clean_description",
          "provider_description",
          "amount",
          "date",
          "updated_at",
          "currency_code",
          "account_id",
          "deleted",
          "future"
        ],
        "properties": {
          "id": {
            "description": "Transaction's unique identifier",
            "type": "number",
            "example": 1000013102238
          },
          "provider_external_id": {
            "description": "The id in the underlying provider. Format varies from one provider to another",
            "type": "string",
            "example": "2026080312345678971e96405379f41bcb5eb8c0f2f3c5244"
          },
          "clean_description": {
            "description": "Transaction's description cleaned and processed by the API",
            "type": "string",
            "example": "CB Mad Cours Marjane M.m G"
          },
          "provider_description": {
            "description": "Transaction's raw description taken from the provider",
            "type": "string",
            "example": "PAIEMENT PAR CARTE 09/11/2024 73.6 MAD COURS 0.09402 MARJANE M.M G"
          },
          "amount": {
            "description": "Transaction's amount\nA positive value indicates a credit and a negative value indicates a debit",
            "type": "number",
            "example": -6.92
          },
          "date": {
            "description": "Transaction date",
            "type": "string",
            "format": "date",
            "example": "2024-11-09"
          },
          "booking_date": {
            "description": "Actual date when the transaction is posted to the account",
            "type": "string",
            "format": "date",
            "example": "2024-11-09"
          },
          "transaction_date": {
            "description": "Date on which the banking transaction is carried out but the the balance is not affected",
            "type": "string",
            "format": "date",
            "example": "2024-11-09"
          },
          "value_date": {
            "description": "Value date of the transaction on the account",
            "type": "string",
            "format": "date",
            "example": "2024-11-09"
          },
          "updated_at": {
            "description": "Timestamp recording when the transaction was last updated",
            "type": "string",
            "format": "date-time",
            "example": "2024-11-09T16:10:10.143Z"
          },
          "currency_code": {
            "description": "3 letters ISO 4217 currency code",
            "type": "string",
            "example": "EUR"
          },
          "deleted": {
            "description": "Flag to indicate that the transaction was deleted",
            "type": "boolean",
            "example": "false"
          },
          "category_id": {
            "description": "Transaction's category unique identifier",
            "type": "number",
            "example": 249
          },
          "operation_type": {
            "description": "Type the transactions as standard banking operation",
            "type": "string",
            "enum": [
              "card",
              "check",
              "transfer",
              "direct_debit",
              "deposit",
              "withdrawal",
              "deferred_debit_card",
              "open_banking",
              "unknown"
            ],
            "example": "card"
          },
          "attachments": {
            "description": "List of the transaction's attachments",
            "type": "array",
            "items": {
              "type": "object",
              "properties": {
                "id": {
                  "type": "string",
                  "example": "attachment-id"
                },
                "file_name": {
                  "type": "string",
                  "example": "attachment.pdf"
                }
              }
            }
          },
          "account_id": {
            "description": "Transaction's account unique identifier",
            "type": "number",
            "example": 2341339
          },
          "future": {
            "description": "Flag to indicate that the transaction will be debited in the future and doesn’t affect the account’s balance",
            "type": "boolean",
            "example": "false"
          },
          "bridge_payment_information": {
            "type": "object",
            "description": "The information of bridge payment entities after successful reconciliation",
            "properties": {
              "payment_request_id": {
                "description": "The id of the payment request the transaction was reconciled with",
                "type": "string",
                "example": "773a347c-a7ae-4bda-8ab5-d768631088ee"
              },
              "payment_link_id": {
                "description": "The id of the payment link the transaction was reconciled with",
                "type": "string",
                "example": "2e33f3f9-1b9f-4ba6-8a4b-ddabbc71cb11"
              },
              "payment_transaction_id": {
                "description": "The id of the payment transaction the transaction was reconciled with",
                "type": "string",
                "example": "bf8f3e2a-6b04-412a-b2a3-be7fef470b4a"
              }
            }
          }
        }
      }
    },
    "parameters": {
      "version": {
        "in": "header",
        "name": "Bridge-Version",
        "schema": {
          "type": "string",
          "enum": [
            "2025-01-15"
          ],
          "default": "2025-01-15"
        },
        "required": true,
        "description": "The Bridge API version"
      }
    },
    "securitySchemes": {
      "userTokenBearerAuth": {
        "type": "http",
        "scheme": "bearer",
        "description": "Aggregation user access token"
      },
      "clientIdAuth": {
        "type": "apiKey",
        "in": "header",
        "name": "Client-Id"
      },
      "clientSecretAuth": {
        "type": "apiKey",
        "in": "header",
        "name": "Client-Secret"
      }
    }
  },
  "security": [
    {
      "clientIdAuth": [],
      "clientSecretAuth": []
    }
  ],
  "x-readme": {
    "explorer-enabled": false,
    "proxy-enabled": false
  }
}
```