Retrieve recurring transaction streams
POST https://{{env_url}}/transactions/recurring/get
The /transactions/get
endpoint allows developers to receive user-authorized transaction data for credit and depository-type Accounts. Transaction data is standardized across financial institutions, and in many cases transactions are linked to a clean name, entity type, location, and category. Similarly, account data is standardized and returned with a clean name, number, balance, and other meta information where available.
You must wait to retrieve transactions after creating an Item
as it takes a couple seconds for Plaid to grab transaction
data initially. If you don't, you will receive a PRODUCT_NOT_READY
error. A good practice is to retrieve the data when you are notified that it's ready via webhook.
Request Body
{"client_id"=>"{{client_id}}", "secret"=>"{{secret_key}}", "access_token"=>"{{access_token}}", "account_ids"=>["ACCOUNT_ID_GOES_HERE"], "options"=>{"include_personal_finance_category"=>true}}
HEADERS
Key | Datatype | Required | Description |
---|---|---|---|
Content-Type | string |
RESPONSES
status: OK
"\n\"inflow_streams\": [],\n \"outflow_streams\": [\n {\n \"account_id\": \"GDMxwRRoeoUxaBE1ndRlu5pdwLnDGxfGxA1AM\",\n \"average_amount\": {\n \"amount\": 89.40000000000003\n },\n \"category\": [\n \"Food and Drink\",\n \"Restaurants\"\n ],\n \"category_id\": \"13005000\",\n \"personal_finance_category\": {\n \"detailed\": \"FOOD_AND_DRINK_RESTAURANT\",\n \"primary\": \"FOOD_AND_DRINK\"\n },\n \"description\": \"SparkFun\",\n \"first_date\": \"2021-08-04\",\n \"frequency\": \"MONTHLY\",\n \"is_active\": true,\n \"last_amount\": {\n \"amount\": 89.4\n },\n \"last_date\": \"2023-06-25\",\n \"merchant_name\": \"\",\n \"status\": \"MATURE\",\n \"stream_id\": \"nnrQ4bbwZwS6Wmq9LvrnIP36pJ3VNmC615Zwy\",\n \"transaction_ids\": [\n \"nnrQ4bbwZwS6Wmq9Lvr4fKnKDdoBM4f3jkn3z\",\n \"gWgapNNk4kfkGxKMjVDAC4X4byBEdDFLxDwEk\",\n \"ZW4ybppevefNE7walVxvHrjrAVZX8QtJ6LNeb\",\n \"NDEjqMMgogUanjZL9b8xcElExoG6PWcX4ZgyL\",\n \"BbjKwvv949hqAeB69DrMcDpDrAjwVQfzbyQ4W\",\n \"kWlQwppk7kfAGZgkVvlxuyZyxdabjMiJlEXLl\",\n \"XWdVoQQByBfdVWxJaGEZCkokprXNy5t1mg3bL\",\n \"mnKXJaabQbSDV9lx1vKaCMPMVa15B4s4DjWg6\",\n \"wmPX3xxJWJUgxXAMnvD1cqNqXmJ6BLIEb95r4\",\n \"vnNWB33AEASXABbJGvRecnLnelNDqJfvMxEWg\",\n \"GDMxwRRoeoUxaBE1ndRlu5p5qKwVZxfG59Q11\",\n \"onzmbWW9M9SwLXKPp8AmCkQkrLyJpatpd9zRD\",\n \"QDqGz77mEmUDgM8EBXPvCvevnBybZLCG5oJp8\",\n \"45Rk6ppG9GhQGzj61XyZtBPB3k4ndoFlQ5Zdp\",\n \"zXewJAA9k9SdzrqJBQmVCa1aNzmoWDt35azo1\",\n \"JDpNkQQ9M9Ux84qN7ygruMyMx8JBgasQDj9bz\",\n \"6EqbXLLdRdcPXqD9MaZ6Fv4vZERA63C1BJyrk\",\n \"bWMzpwwgBgf3WvgkdV7AuNwNV14DgyFoXLdGo\",\n \"8Erj6vvqlqceZ3Ak7Ny9cqoqejylGQIZbaGxR\",\n \"MD8NlRRopoUBkln4Vwg3CKWKR9EDgBf4JxEDK\",\n \"PDlZrjjo8oUwekvd6yLaCR3RwbxV7MfXPd9w6\",\n \"3ARXPLLdydUrGMBa536XCz8zKAadmRumDJBwn\",\n \"lnkQ7JJdedSmxpBbM8kdfEoEpadrZ7caVWkLb\",\n \"jnWmpkkPjPSmdlBxQvRefZKrPE73Q1c6jlva3\"\n ]\n }\n ],\n \"request_id\": \"50WB2pF8mKFP5rJ\",\n \"updated_datetime\": \"1970-01-01T00:00:00Z\"\n}"