YNynab
Transactions

Get plan month transactions

Changed on

Returns all transactions for a specified month, excluding any pending transactions

get/plans/{plan_id}/months/{month}/transactions

Request

  • Base URL
    https://api.ynab.com/v1
  • URL
    https://api.ynab.com/v1/plans/{plan_id}/months/{month}/transactions
  • Auth
    HTTP bearer

Path parameters

plan_idstring required

The id of the plan. "last-used" can be used to specify the last used plan and "default" can be used if default plan selection is enabled (see: https://api.ynab.com/#oauth-default-plan).

monthstring required

The plan month in ISO format (e.g. 2016-12-01) ("current" can also be used to specify the current calendar month (UTC))

Query parameters

since_datestring date

If specified, only transactions on or after this date will be included. The date should be ISO formatted (e.g. 2016-12-30).

until_datestring date

If specified, only transactions on or before this date will be included. The date should be ISO formatted (e.g. 2016-12-30).

type'uncategorized' | 'unapproved'

If specified, only transactions of the specified type will be included. "uncategorized" and "unapproved" are currently supported.

last_knowledge_of_serverinteger

The starting server knowledge. If provided, only entities that have changed since last_knowledge_of_server will be included.

Response

The list of requested transactions

Changes

  • 2220c3a168a3Revision changes
    • info

      added the new optional query request parameter until_date

  • 1e4aa027827cRevision changes
    • breaking

      the ////// response's property type changed from object to no type for status

    • breaking

      the ///// response's property type changed from object to no type for status

    • breaking

      removed the required property /////// from the response with the status

    • breaking

      removed the required property /////// from the response with the status

    • breaking

      removed the required property /////// from the response with the status

    • breaking

      removed the required property /////// from the response with the status

    • breaking

      removed the required property /////// from the response with the status

    • breaking

      removed the required property /////// from the response with the status

    • breaking

      removed the required property /////// from the response with the status

    • breaking

      removed the required property ////// from the response with the status

    • breaking

      removed the required property ////// from the response with the status

    • breaking

      removed the required property ////// from the response with the status

    • breaking

      removed the required property ////// from the response with the status

    • warning

      removed the optional property /////// from the response with the status

    • warning

      removed the optional property /////// from the response with the status

    • warning

      removed the optional property /////// from the response with the status

    • warning

      removed the optional property /////// from the response with the status

    • warning

      removed the optional property /////// from the response with the status

    • warning

      removed the optional property /////// from the response with the status

    • warning

      removed the optional property /////// from the response with the status

    • warning

      removed the optional property /////// from the response with the status

    • warning

      removed the optional property /////// from the response with the status

    • warning

      removed the optional property /////// from the response with the status

    • warning

      removed the optional property /////// from the response with the status

    • warning

      removed the optional property /////// from the response with the status

    • warning

      removed the optional property ////// from the response with the status

    • warning

      removed the optional property ////// from the response with the status

    • warning

      removed the optional property ////// from the response with the status

    • warning

      removed the optional property ////// from the response with the status

    • warning

      removed the optional property ////// from the response with the status

    • warning

      removed the optional property ////// from the response with the status

    • warning

      removed the optional property ////// from the response with the status

    • info

      added subschema #2 to the ///// response property allOf list for the response status

    • info

      added subschema #2 to the ////// response property allOf list for the response status