Query Basics

For clarity, we will give example queries using the common Linux curl command, which is available on virtually any Linux or Unix system. Versions of curl are also available on the web for other operating systems.
The structure of a query is as follows: https:/www10.versaccounts.com/v1/resource[/resource_id[/nested_resource[/nested_resource_id]]]
Square brackets indicate optional parts of the query.

• A GET request to a resource, with no other options, will return all available records of that resource in XML format.
• A POST request to a resource creates a new record of that resource type.
• A PUT request updates a resource record.
• A DELETE request deletes a resource record.

Each request must have a valid VERSACCOUNTS_AUTHORIZATION parameter in its header. (See Getting Started)

Examples

Create a new draft transaction:

$ curl -i -X POST -H "Content-Type: application/xml" --header "VERSACCOUNTS_AUTHORIZATION:409696900e0b3f5a4297e3cd5823f734f0095e66" \ -d @new_draft_transaction.xml https://www10.versaccounts.com/v1/draft_transaction.xml

This request posts the XML file new_draft_transaction.xml, which contains:

<?xml version="1.0" encoding="UTF-8"?>
 <draft_transaction>
   <transaction_date>2011-04-15 13:35:54 UTC</transaction_date>
   <description>My Experimental Transaction</description>
 </draft_transaction>

​Add a draft_transaction_detail to draft_transaction 2205:

$ curl -i -X POST -H "Content-Type: application/json" --header "VERSACCOUNTS_AUTHORIZATION:409696900e0b3f5a4297e3cd5823f734f0095e66" \ -d @new_draft_transaction_detail_line_1.json https://www10.versaccounts.com/v1/draft_transaction/2205/draft_transaction_detail.json

This request posts the XML file new_draft_transaction_detail_line_1.json, which contains:  {"draft_transaction_detail":{"amount":100.0,"debit_credit_flag":false,"multiplier":1.0,"organization_gl_account_id":37162,"currency_id":"1"}} Retrieve all Organization GL Accounts in JSON format:

$ curl -i --header "VERSACCOUNTS_AUTHORIZATION:409696900e0b3f5a4297e3cd5823f734f0095e66" https://www10.versaccounts.com/v1/organization_gl_account.json

Retrieve Organization GL Account 50333 in XML format:

$ curl -i --header "VERSACCOUNTS_AUTHORIZATION:409696900e0b3f5a4297e3cd5823f734f0095e66" https://www10.versaccounts.com/v1/organization_gl_account/50333.xml

Delete draft_transaction 405:

$ curl -i -X DELETE --header "VERSACCOUNTS_AUTHORIZATION:409696900e0b3f5a4297e3cd5823f734f0095e66" https://www10.versaccounts.com/v1/draft_transaction/405

Delete draft_transaction_detail 3306, which is a line in draft_transaction 405:

$ curl -i -X DELETE --header "VERSACCOUNTS_AUTHORIZATION:409696900e0b3f5a4297e3cd5823f734f0095e66" https://www10.versaccounts.com/v1/draft_transaction/405/draft_transaction_detail/3306