Currencies




Important note about API versions

If you are using Dovico Timesheet version 13 or below, you should use API version 5. If using version 14, use API version 6.




Versions 1 through 6
This call has been updated to reflect the 6th version of the API.

The API calls listed below enable a person to view enabled Currencies.

Examples are provided using cURL.cURL is a 3rd party tool used for transferring data with URL syntax.



Get all Currencies


GET Currencies/

Returns a list of all enabled Currencies using pagination.

Security Check:The user must have Software Access set to 'All' or 'Time and Expense Entry only'.
Example XML request:
 
        URI: https://api.dovico.com/Currencies/?version=6
        Method: GET
 
        Sample request syntax using Win32 cURL:
        curl -k "https://api.dovico.com/Currencies/?version=6" -H "Authorization: WRAP access_token=""client=36bb7f2f29474d88bf35c4a89cdcfb34.593&user_token=e7d1e55015ee4ecebe5298cb439344fd.593"""
 
 
Example JSON request:
 
        URI: https://api.dovico.com/Currencies/?version=6
        Method: GET
        Accept: application/json
 
        Sample request syntax using Win32 cURL:
        curl -k "https://api.dovico.com/Currencies/?version=6" -H "Accept: application/json" -H "Authorization: WRAP access_token=""client=36bb7f2f29474d88bf35c4a89cdcfb34.593&user_token=e7d1e55015ee4ecebe5298cb439344fd.593"""
 
 
Example XML response:
 
        <Result xmlns:i="http://www.w3.org/2001/XMLSchema-instance">
            <CurrenciesEnabled>T</CurrenciesEnabled>
            <SystemDefaultCurrencyID>280</SystemDefaultCurrencyID>
            <Currencies>
                <Currency>
                    <ID>159</ID>
                    <Code>EUR</Code>
                    <Symbol>EUR €</Symbol>
                    <Description>Euro</Description>
                </Currency>
                <Currency>
                ...
                </Currency>
            </Currencies>
            <PrevPageURI>https://api.dovico.com/Currencies/?prev=159&version=6</PrevPageURI>
            <NextPageURI>https://api.dovico.com/Currencies/?next=280&version=6</NextPageURI>
        </Result>
Fields for Result
CurrenciesEnabled (string - 'T' or 'F' indicating if multicurrency is enabled or not)
SystemDefaultCurrencyID (long)
Currencies (will return zero or more Currency nodes. One Currency node for each currency that is enabled)
PrevPageURI (string. Will be 'N/A' if there is no previous page of data)
NextPageURI (string. Will be 'N/A' if there is no next page of data)


Fields for Currency
ID (long)
Code (string)
Symbol (string)
Description (string)

Example JSON response:
 
        {
        "CurrenciesEnabled":"T",
        "SystemDefaultCurrencyID":"280",
        "Currencies":
            [
                {
                    "ID":"159",
                    "Code":"EUR",
                    "Symbol":"EUR €",
                    "Description":"Euro"
                },
                {
                    ...
                }
            ],
        "PrevPageURI":"https:\/\/api.dovico.com\/Currencies\/?prev=159&version=6",
        "NextPageURI":"https:\/\/api.dovico.com\/Currencies\/?next=280&version=6"
        }
 
Fields
CurrenciesEnabled (string - 'T' or 'F' indicating if multicurrency is enabled or not)
SystemDefaultCurrencyID (long)
Currencies (will return zero or more Currency object. One Currency object for each currency that is enabled)
PrevPageURI (string. Will be 'N/A' if there is no previous page of data)
NextPageURI (string. Will be 'N/A' if there is no next page of data)



Fields for Currency
ID (long)
Code (string)
Symbol (string)
Description (string)



Get a Currency


GET Currencies/{sCurrencyID}/

Returns the Currency requested.

Security Check:The user must have Software Access set to 'All' or 'Time and Expense Entry only'.
Example XML request:
 
        URI: https://api.dovico.com/Currencies/{CurrencyID}/?version=6
        Method: GET
 
        Sample request syntax using Win32 cURL:
        curl -k "https://api.dovico.com/Currencies/159/?version=6" -H "Authorization: WRAP access_token=""client=36bb7f2f29474d88bf35c4a89cdcfb34.593&user_token=e7d1e55015ee4ecebe5298cb439344fd.593"""
 
 
Example JSON request:
 
        URI: https://api.dovico.com/Currencies/{CurrencyID}/?version=6
        Method: GET
        Accept: application/json
 
        Sample request syntax using Win32 cURL:
        curl -k "https://api.dovico.com/Currencies/159/?version=6" -H "Accept: application/json" -H "Authorization: WRAP access_token=""client=36bb7f2f29474d88bf35c4a89cdcfb34.593&user_token=e7d1e55015ee4ecebe5298cb439344fd.593"""
 
 
Example XML response:
 
        <Result xmlns:i="http://www.w3.org/2001/XMLSchema-instance">
            <Currencies>
                <Currency>
                    <ID>159</ID>
                    <Code>EUR</Code>
                    <Symbol>EUR €</Symbol>
                    <Description>Euro</Description>
                </Currency>
            </Currencies>
        </Result>
Fields for Result
Currencies (will return zero nodes if the requested currency does not exist or is not enabled. will return one Currency node if the requested currency exists and is enabled.)


Fields for Currency
ID (long)
Code (string)
Symbol (string)
Description (string)

Example JSON response:
 
        {
        "Currencies":
            [
                {
                    "ID":"159",
                    "Code":"EUR",
                    "Symbol":"EUR €",
                    "Description":"Euro"
                }
            ]
        }
 

Fields
Currencies (will return zero objects if the requested currency does not exist or is not enabled. will return one Currency object if the requested currency exists and is enabled.)


Fields for Currency
ID (long)
Code (string)
Symbol (string)
Description (string)