List/Search: Get a list of transactions

Get: Get a single transaction detail

Post: Create a transaction

Put: Update a transaction

Delete: Delete a transaction

List/Search

Example JSON:

{
  "version": "v2_0_0",
  "status": 200,
  "meta": {
    "resource_count": 1,
    "available_filters": {
      "f_accountnumber": "Account number of any line in the transaction",
      "f_amount": "Total amount of the transaction (always a positive number)",
      "f_contact": "Contact ID",
      "f_contactname": "Any part of any contact name (first, last, and/or company), case insensitive",
      "f_fund": "Fund ID",
      "f_lastupdated": "Last updated (created or modified). Format: yyyy-MM-ddTHH:mm:ss.SSSZ",
      "f_note": "Any part of the note, case insensitive",
      "f_rangeend": "Maximum date range (inclusive). Format: yyyy-MM-dd",
      "f_rangestart": "Minimum date range (inclusive) Format: yyyy-MM-dd",
      "f_reconciled": "Whether the transaction is reconciled: y, n",
      "f_tagname": "Any part of the tag name, case insensitive",
      "f_taxtagname": "Any part of the tax tag name, case insensitive"
    }
  },
  "links": {
    "next": "/api/v1/transactions?page_size=1&page_num=2",
    "self": "/api/v1/transactions?page_size=1&page_num=1"
  },
  "data": {
    "transactions": [
      {
        "id": 1,
        "memo": "A memo too",
        "note": "My first transaction",
        "date": "2014-12-31",
        "amount": 123.45,
        "contact": {
          "id": 1,
          "companyname": "Aplos",
          "type": "company"
        }
        "created": "2014-12-31T01:23:45.678-0700",
        "modified": "2014-12-31T12:34:56.789-0700"
      }
    ]
  }
}

Get

Example JSON:

{
  "version": "v2_0_0",
  "status": 200,
  "meta": {
    "resource_count": 1
  },
  "links": {
    "self": "/api/v1/transactions/1"
  },
  "data": {
    "transaction": {
      "id": 1,
      "memo": "A memo too",
      "note": "My first transaction",
      "date": "2014-12-31",
      "amount": 123.45,
      "contact": {
         "id": 1,
         "companyname": "Aplos",
         "type": "company"
      },
      "created": "2014-12-31T01:23:45.678-0700",
      "modified": "2014-12-31T12:34:56.789-0700",
      "lines": [
        {
          "id": 1,
          "amount": 123.45,
          "account": {
            "account_number": 1000,
            "name": "Cash"
          },
          "fund": {
            "id": 1,
            "name": "General Fund"
          }
        },
        {
          "id": 2,
          "amount": -123.45,
          "account": {
            "account_number": 4000,
            "name": "Donation Income"
          },
          "fund": {
            "id": 1,
            "name": "General Fund"
          }
        }
      ]
    }
  }
}

Post

Example JSON Body:

{
  "note": "My first transaction",
  "date": "2015-06-01",
  "contact": {
     "companyname": "Aplos",
     "type": "company"
  },
  "lines": [
    {
      "amount": 123.45,
      "account": {
        "account_number": 1000
      },
      "fund": {
        "id": 1
      }
    },
    {
      "amount": -123.45,
      "account": {
        "account_number": 4000
      },
      "fund": {
        "id": 1
      }
    }
  ]
}

Example JSON Response:

{
  "version": "v2_0_0",
  "message": "posted: 2",
  "status": 200,
  "meta": {
    "resource_count": 1
  },
  "links": {
    "self": "/api/v1/transactions/2"
  },
  "data": {
    "transaction": {
      "id": 2,
      "note": "My first transaction",
      "date": "2015-06-01",
      "amount": 123.45,
      "contact": {
         "id": 1,
         "companyname": "Aplos",
         "type": "company"
      },
      "created": "2014-12-31T01:23:45.678-0700",
      "lines": [
        {
          "id": 3,
          "amount": 123.45,
          "account": {
            "account_number": 1000,
            "name": "Cash"
          },
          "fund": {
            "id": 1,
            "name": "General Fund"
          }
        },
        {
          "id": 4,
          "amount": -123.45,
          "account": {
            "account_number": 4000,
            "name": "Donations Income"
          },
          "fund": {
            "id": 1,
            "name": "General Fund"
          }
        }
      ]
    }
  }
}

Put

Example JSON Body:

{
  "note": "My first transaction (updated amounts)",
  "date": "2015-06-01",
  "contact": {
     "companyname": "Aplos",
     "type": "company"
  },
  "lines": [
    {
      "amount": 12300.45,
      "account": {
        "account_number": 1000
      },
      "fund": {
        "id": 1
      }
    },
    {
      "amount": -12300.45,
      "account": {
        "account_number": 4000
      },
      "fund": {
        "id": 1
      }
    }
  ]
}

Example JSON Response:

{
  "version": "v2_0_0",
  "message": "put: 2",
  "status": 200,
  "meta": {
    "resource_count": 1
  },
  "links": {
    "self": "/api/v1/transactions/2"
  },
  "data": {
    "transaction": {
      "id": 2,
      "note": "My first transaction (updated amounts)",
      "date": "2015-06-01",
      "amount": 12300.45,
      "contact": {
         "id": 1,
         "companyname": "Aplos",
         "type": "company"
      },
      "created": "2014-12-31T01:23:45.678-0700",
      "modified": "2014-12-31T12:34:56.789-0700",
      "lines": [
        {
          "id": 3,
          "amount": 12300.45,
          "account": {
            "account_number": 1000,
            "name": "Cash"
          },
          "fund": {
            "id": 1,
            "name": "General Fund"
          }
        },
        {
          "id": 4,
          "amount": -12300.45,
          "account": {
            "account_number": 4000,
            "name": "Donations Income"
          },
          "fund": {
            "id": 1,
            "name": "General Fund"
          }
        }
      ]
    }
  }
}

Delete

Example JSON Response:

{
  "version": "v2_0_0",
  "message": "deleted: 2",
  "status": 200
}