The Certify API

The Certify API is a RESTful API that allows you to build applications and integrations that pull data directly from Certify. Make calls directly to our API endpoints without having to login and access the data manually.

All production API requests are made to:

https://api.certify.com/v1/

REST

The Certify API uses standard RESTful API calls via HTTP web requests with methods like GET, POST, and DELETE. All calls must be made using HTTPS.

JSON and XML

The Certify API accepts requests and returns responses in either JSON or XML. Please set the Content-Type header to either “application/json” or “application/xml” in the requests to define which format you would like. The default format is JSON.

Authentication

All API calls to the Certify API must include authentication information to verify the identity of the caller. Authentication is comprised of two tokens called the API Key and the API Secret. The API Key is a hashed code for your company; it tells us who you are. The API Secret is a generated token that grants you access to your Certify data. Both tokens can be found in the Configuration section of your company’s administrator users inside Certify. These tokens should NOT be freely given out, they should only be given to parties trusted with access to your company’s data.

To properly provide authentication, each API call must have the following headers:

Header Name Header Value
x-api-key API Key
x-api-secret API Secret

Responses

Successful responses returned from the Certify API will be formatted according to the specific API method called. Any errors returned will be in the following format:

JSON
{
  errorCode: {code}
  errorValue: {value}
}    

XML
<Error>
    <ErrorCode>{code}</ErrorCode>
    <ErrorMessage>{message}</ErrorMessage>
</Error>

Refer to the list of general error codes or the documentation for the specific API method called for more information.

Code Description
400 Bad Request. Method request is incorrectly formatted.
401 Unauthorized. Authentication failed.
404 Method Not Allowed. Request contains an HTTP method type that is not supported for that API function.

API Methods Expand All   |  Collapse All

GET
/expensereports
Description

This method returns a list of one or more processed expense reports.

Parameters
Name Located in Description Required Schema
x-api-key header API Key (see Authentication) Yes string
x-api-secret header API Secret (see Authentication) Yes string
approvalcode query Approval code of single expense report. No string
startdate query Starting point for the processed date range. No string (YYYY-MM-DD)
enddate query Ending point for the processed date range. No string (YYYY-MM-DD)
Responses
Code Description
200 Success
400 One or more parameters is badly formatted. See specific error message for details.
401 Invalid API credentials or credentials were not supplied.
Example Response
{
        "ExpenseReports": [
        {
              "ID": "fdf32884-af87-4991-a7q4-3e574ea6be88",
              "EmployeeDepartment": "General",
              "FirstName": "Jack",
              "LastName": "Certi",
              "EmployeeID": "jcerti001",
              "NonReimAmount": 0.0000,
              "ReimAmount": 292.0400,
              "TotalAmount": 292.0400,
              "Currency": "USD",
              "ProcessedDate": "2017-02-03",
              "ApprovalCode": 19,
              "StartDate": "2017-01-01",
              "EndDate": "2017-01-31",
              "ExpenseReportName": "Business Trip January 2017",
              "APSyncComplete": true
        },
        {
              "ID": "a9109697-ew08-45f1-9338-994e046a07ed",
              "EmployeeDepartment": "General",
              "FirstName": "Robbie",
              "LastName": "The Robot",
              "EmployeeID": "rrobot002",
              "NonReimAmount": 34.4000,
              "ReimAmount": 0.0000,
              "TotalAmount": 34.4000,
              "Currency": "USD",
              "ProcessedDate": "2016-02-03",
              "ApprovalCode": 23,
              "StartDate": "2017-01-23",
              "EndDate": "2017-01-30",
              "ExpenseReportName": "Visit to Alpaca Farm, Inc.",
              "APSyncComplete": false
        }]
}
    
<ExpenseReports>
    <ID>fdf32884-af87-49c1-a7q4-3e574ea6be88</ID>
    <EmployeeDepartment>General</EmployeeDepartment>
    <FirstName>Jack</FirstName>
    <LastName>Certi</LastName>
    <EmployeeID>jcerti001</EmployeeID>
    <NonReimAmount>0</NonReimAmount>
    <ReimAmount>292.04</ReimAmount>
    <TotalAmount>292.04</TotalAmount>
    <Currency>USD</Currency>
    <ProcessedDate>2017-02-03</ProcessedDate>
    <ApprovalCode>19</ApprovalCode>
    <StartDate>2017-01-01</StartDate>
    <EndDate>2017-01-31</EndDate>
    <ExpenseReportName>Business Trip January 2017</ExpenseReportName>
    <APSyncComplete>true</APSyncComplete>
</ExpenseReports>
<ExpenseReports>
    <ID>a9109697-ew08-45f1-93b8-994e046a07ed</ID>
    <EmployeeDepartment>General</EmployeeDepartment>
    <FirstName>Robbie</FirstName>
    <LastName>The Robot</LastName>
    <EmployeeID>rrobot002</EmployeeID>
    <NonReimAmount>34.40</NonReimAmount>
    <ReimAmount>0</ReimAmount>
    <TotalAmount>34.4</TotalAmount>
    <Currency>USD</Currency>
    <ProcessedDate>2016-02-03</ProcessedDate>
    <ApprovalCode>23</ApprovalCode>
    <StartDate>2017-01-23</StartDate>
    <EndDate>2017-01-30</EndDate>
    <ExpenseReportName>Visit to Alpaca Farm, Inc.</ExpenseReportName>
    <APSyncComplete>false</APSyncComplete>
</ExpenseReports>
Field Value Description
ID Unique ID of the Expense Report.
EmployeeDepartment Property fields of the employee who the expense report belongs to.
FirstName
LastName
EmployeeID
NonReimAmount Total non-reimbursable amount of the expense report.
ReimAmount Total reimbursable amount of the expense report.
TotalAmount Total amount, non-reimbursable + non-reimbursable amounts.
Currency Three letter code of the currency of the expense report. ISO 4217 format.
ProcessedDate Date on which the expense report was processed. (YYYY-MM-DD)
ApprovalCode Approval code of the expense report.
StartDate Start date of the expense report. (YYYY-MM-DD)
EndDate End date of the expense report. (YYYY-MM-DD)
ExpenseReportName Name of the expense report.
APSyncComplete Indicates whether the expense report has been synchronized with a third party AP system. (true/false)
GET
/expensereports/{id}
Description

This method returns a specific expense report associated with the supplied ID value.

Parameters
Name Located in Description Required Schema
x-api-key header API Key (see Authentication) Yes string
x-api-secret header API Secret (see Authentication) Yes string
id path Expense Report/Expense ID Yes string
Responses
Code Description
200 Success
400 One or more parameters is badly formatted. See specific error message for details.
401 Invalid API credentials or credentials were not supplied.
Example Response
{
        "ExpenseReports": [
        {
              "ID": "fdf32884-af87-4991-a7q4-3e574ea6be88",
              "EmployeeDepartment": "General",
              "FirstName": "Jack",
              "LastName": "Certi",
              "EmployeeID": "jcerti001",
              "NonReimAmount": 0.0000,
              "ReimAmount": 292.0400,
              "TotalAmount": 292.0400,
              "Currency": "USD",
              "ProcessedDate": "2017-02-03",
              "ApprovalCode": 19,
              "StartDate": "2017-01-01",
              "EndDate": "2017-01-31",
              "ExpenseReportName": "Business Trip January 2017",
              "APSyncComplete": true
        }]
}
    
<ExpenseReports>
    <ID>fdf32884-af87-49c1-a7q4-3e574ea6be88</ID>
    <EmployeeDepartment>General</EmployeeDepartment>
    <FirstName>Jack</FirstName>
    <LastName>Certi</LastName>
    <EmployeeID>jcerti001</EmployeeID>
    <NonReimAmount>0</NonReimAmount>
    <ReimAmount>292.04</ReimAmount>
    <TotalAmount>292.04</TotalAmount>
    <Currency>USD</Currency>
    <ProcessedDate>2017-02-03</ProcessedDate>
    <ApprovalCode>19</ApprovalCode>
    <StartDate>2017-01-01</StartDate>
    <EndDate>2017-01-31</EndDate>
    <ExpenseReportName>Business Trip January 2017</ExpenseReportName>
    <APSyncComplete>true</APSyncComplete>
</ExpenseReports>
Field Value Description
ID Unique ID of the Expense Report.
EmployeeDepartment Property fields of the employee who the expense report belongs to.
FirstName
LastName
EmployeeID
NonReimAmount Total non-reimbursable amount of the expense report.
ReimAmount Total reimbursable amount of the expense report.
TotalAmount Total amount, non-reimbursable + non-reimbursable amounts.
Currency Three letter code of the currency of the expense report. ISO 4217 format.
ProcessedDate Date on which the expense report was processed. (YYYY-MM-DD)
ApprovalCode Approval code of the expense report.
StartDate Start date of the expense report. (YYYY-MM-DD)
EndDate End date of the expense report. (YYYY-MM-DD)
ExpenseReportName Name of the expense report.
APSyncComplete Indicates whether the expense report has been synchronized with a third party AP system. (true/false)
GET
/expensereports/{id}/expenses
Description

This method returns all expenses for the processed expense report associated with the supplied ID value.

Parameters
Name Located in Description Required Schema
x-api-key header API Key (see Authentication) Yes string
x-api-secret header API Secret (see Authentication) Yes string
id path Expense Report/Expense ID Yes string
approvalcode query Approval code of single expense report. No string
startdate query Starting point for the processed date range. No string (YYYY-MM-DD)
enddate query Ending point for the processed date range. No string (YYYY-MM-DD)
Responses
Code Description
200 Success
400 One or more parameters is badly formatted. See specific error message for details.
401 Invalid API credentials or credentials were not supplied.
Example Response
{
        "Expense": [
        {
              "ID": "b65455e0-89d5-4910-82bf-cadfbf5c4126",
              "ExpenseReportID": "fdf33884-af87-2891-a7d4-3e574ea6be88",
              "FirstName": "Jack",
              "LastName": "Certi",
              "Email": "jcerti@certify.com",
              "EmployeeID": "jcerti001",
              "DepartmentName": "General",
              "DepartmentCode": "01",
              "ExpenseType": "Lodging",
              "ExpenseCategory": "Lodging",
              "ExpenseCategoryGLCode": "03",
              "Amount": 192.9300,
              "Billable": false,
              "Reimbursable": true,
              "ReimAmount": 191.9600,
              "ExpenseDate": "2016-05-03"
              "Vendor": "Mountain View Hotel",
              "Location": "Mountain View, CA",
              "ProcessedDate": "2016-05-30",
              "Processed": true,
              "Currency": "USD",
              "Reason": "Hotel Stay",
              "VATAmount": 0.0000,
              "HSTAmount": 0.0000,
              "PSTAmount": 0.0000,
              "ExpenseTextGLD1Label": "Text GLD Expense,
              "ExpenseTextGLD1": "business",
              "ExpenseTextGLD2Label": "Numbers Only GLD",
              "ExpenseTextGLD2": "123",
              "ExpenseReportGLD1Label": "Food",
              "ExpenseReportGLD1Name": "Apples and Oranges",
              "ExpenseReportGLD1Code": "A123"
              "ReceiptImageLink": "https://www.certify.com/ReceiptImage.aspx?receiptID=AECCC911C7B60688D6A0C39565A2224EBD&th=6E84D13C4EA482A5CC2A28F85A23F43C"
        },
        {
              "ID": "e373a213-1dd3-4e3d-83b7-786bd9a5e201",
              "ExpenseReportID": "9b7146b0-3e92-4745-babf-8bda8973238a",
              "FirstName": "Robbie",
              "LastName": "The Robot",
              "Email": "rrobot@certify.com",
              "EmployeeID": "rrobot002",
              "DepartmentName": "Marketing",
              "DepartmentCode": "02",
              "ExpenseType": "Travel",
              "ExpenseCategory": Airfare",
              "ExpenseCategoryGLCode": "01",
              "Amount": 150.0000,
              "Billable": false,
              "Reimbursable": false,
              "ReimAmount": 0.0000,
              "ExpenseDate": "2016-06-22"
              "Vendor": "Delta",
              "ProcessedDate": "2016-06-22",
              "Processed": true,
              "Currency": "USD",
              "Reason": "Airfare",
              "VATAmount": 0.0000,
              "HSTAmount": 0.0000,
              "PSTAmount": 0.0000,
              "ExpenseTextGLD1Label": "Text GLD Expense,
              "ExpenseTextGLD1": "Marketing Convention",
              "ExpenseTextGLD2Label": "Numbers Only GLD",
              "ExpenseReportGLD1Label": "Food",
              "ExpenseReportGLD1Name": "Surf and Turf",
              "ExpenseReportGLD1Code": "st001",
              "TravelFrom": "PWM",
              "TravelTo": "BOS"
              "ReceiptImageLink": "https://www.certify.com/ReceiptImage.aspx?receiptID=AECCC911C7B60618D6A0C39565A2224EBD&th=6E84D13C4EA482A5CC2A28F85A23F43C"
        }]
}
    
<Expenses>
    <Expense>
      <ID>b65455e0-89d5-4910-82bf-cadfbf5c4126</ID>
      <ExpenseReportID>fdf33884-af87-2891-a7d4-3e574ea6be88</ExpenseReportID>
      <FirstName>Jack</FirstName>
      <LastName>Certi</LastName>
      <Email>jcerti@certify.com</Email>
      <EmployeeID>jcerti001</EmployeeID>
      <DepartmentName>General</DepartmentName>
      <DepartmentCode>01</DepartmentCode>
      <ExpenseType>Lodging</ExpenseType>
      <ExpenseCategory>Lodging</ExpenseCategory>
      <ExpenseCategoryGLCode>03</ExpenseCategoryGLCode>
      <Amount>192.9300</Amount>
      <Billable>false</Billable>
      <Reimbursable>true</Reimbursable>
      <ReimAmount>191.9600</ReimAmount>
      <ExpenseDate>2016-05-03</ExpenseDate>
      <Vendor>Mountain View Hotel</Vendor>
      <Location>Mountain View, CA</Location>
      <ProcessedDate>2016-05-30</ProcessedDate>
      <Processed>true</Processed>
      <Currency>USD</Currency>
      <Reason>Hotel stay</Reason>
      <VATAmount>Hotel stay</0.0000>
      <HSTAmount>Hotel stay</0.0000>
      <PSTAmount>Hotel stay</0.0000>
      <ExpenseTextGLD1Label>Text GLD Expense</ExpenseTextGLD1Label>
      <ExpenseTextGLD1>business</ExpenseTextGLD1>
      <ExpenseTextGLD2Label>Numbers Only GLD</ExpenseTextGLD2Label>
      <ExpenseTextGLD2>123</ExpenseTextGLD2>
      <ExpenseTextGLD3Label />
      <ExpenseTextGLD3 />
      <ExpenseTextGLD4Label />
      <ExpenseTextGLD4 />
      <ExpenseTextGLD5Label />
      <ExpenseTextGLD5 />
      <ExpenseReportGLD1Label>Food</ExpenseReportGLD1Label>
      <ExpenseReportGLD1Name>Apples and Oranges</ExpenseReportGLD1Name>
      <ExpenseReportGLD1Code>A123</ExpenseReportGLD1Code>
      <ExpenseReportGLD2Label />
      <ExpenseReportGLD2Name />
      <ExpenseReportGLD2Code />
      <ExpenseReportGLD3Label />
      <ExpenseReportGLD3Name />
      <ExpenseReportGLD3Code />
      <ExpenseReportGLD4Label />
      <ExpenseReportGLD4Name />
      <ExpenseReportGLD4Code />
      <ExpenseReportGLD5Label />
      <ExpenseReportGLD5Name />
      <ExpenseReportGLD5Code />
      <TravelFrom />
      <TravelTo />
      <ReceiptImageLink>https://www.certify.com/ReceiptImage.aspx?receiptID=AECCC911C7B60618D6A0C39565A2224EBD&th=6E84D13C4EA482A5CC2A28F85A23F43C</ReceiptImageLink>
    </Expense>
    <Expense>
      <ID>e373a213-1dd3-4e3d-83b7-566bd9a5e201</ID>
      <ExpenseReportID>9b7146b0-3e92-4745-babf-8bda3273238a</ExpenseReportID>
      <FirstName>Robbie</FirstName>
      <LastName>The Robot</LastName>
      <Email>rrobot@certify.com</Email>
      <EmployeeID>rrobot002</EmployeeID>
      <DepartmentName>Marketing</DepartmentName>
      <DepartmentCode>02</DepartmentCode>
      <ExpenseType>Travel</ExpenseType>
      <ExpenseCategory>Airfare</ExpenseCategory>
      <ExpenseCategoryGLCode>01</ExpenseCategoryGLCode>
      <Amount>150.0000</Amount>
      <Billable>false</Billable>
      <Reimbursable>false</Reimbursable>
      <ReimAmount>0.0000</ReimAmount>
      <ExpenseDate>2016-06-22</ExpenseDate>
      <Vendor>Delta</Vendor>
      <ProcessedDate>2016-06-22</ProcessedDate>
      <Processed>true</Processed>
      <Currency>USD</Currency>
      <Reason />
      <VATAmount>Hotel stay</0.0000>
      <HSTAmount>Hotel stay</0.0000>
      <PSTAmount>Hotel stay</0.0000>
      <ExpenseTextGLD1Label>Text GLD Expense</ExpenseTextGLD1Label>
      <ExpenseTextGLD1>Marketing Convention</ExpenseTextGLD1>
      <ExpenseTextGLD2Label>Numbers Only GLD</ExpenseTextGLD2Label>
      <ExpenseTextGLD2 />
      <ExpenseTextGLD3Label />
      <ExpenseTextGLD3 />
      <ExpenseTextGLD4Label />
      <ExpenseTextGLD4 />
      <ExpenseTextGLD5Label />
      <ExpenseTextGLD5 />
      <ExpenseReportGLD1Label>Food</ExpenseReportGLD1Label>
      <ExpenseReportGLD1Name>Surf and Turf</ExpenseReportGLD1Name>
      <ExpenseReportGLD1Code>st001</ExpenseReportGLD1Code>
      <ExpenseReportGLD2Label />
      <ExpenseReportGLD2Name />
      <ExpenseReportGLD2Code />
      <ExpenseReportGLD3Label />
      <ExpenseReportGLD3Name />
      <ExpenseReportGLD3Code />
      <ExpenseReportGLD4Label />
      <ExpenseReportGLD4Name />
      <ExpenseReportGLD4Code />
      <ExpenseReportGLD5Label />
      <ExpenseReportGLD5Name />
      <ExpenseReportGLD5Code />
      <TravelFrom>PWM</TravelFrom>
      <TravelTo>BOS</TravelTo>
      <ReceiptImageLink>https://www.certify.com/ReceiptImage.aspx?receiptID=AECCC911C7B60618D6A0C39565A2224EBD&th=6E84D13C4EA482A5CC2A28F85A23F43C</ReceiptImageLink>
    </Expense>
  </Expenses>
Field Value Description
ID Unique ID of the expense.
ExpenseReportID Unique ID of the expense report the expense is attached to.
FirstName Property fields of the employee who the expense report belongs to.
LastName
Email
EmployeeID
DepartmentName Name of the department of the expense.
DepartmentCode Code of the department of the expense.
ExpenseType Type of expense (Mileage, Lodging, Meals, etc.).
ExpenseCategory Expense category of the expense.
ExpenseCategoryGLCode GL Code of the expense category of the expense.
Amount Total amount of the expense.
Billable Indicates whether the expense is billable (true/false).
Reimbursable Indicates whether the expense is reimbursable (true/false).
ReimAmount Reimbursable amount of the expense.
ExpenseDate The date of the expense (yyyy-MM-dd).
Vendor The vendor of the expense.
Location The location of the expense.
ProcessedDate The date the expense was processed on, if applicable (yyyy-MM-dd).
Processed Indicates whether the expense has been processed (true/false).
Currency Three letter code of the currency of the expense. ISO 4217 format. Ex: “USD”
Reason The text entered in the reason field of the expense
VATAmount The value-added tax amount of the expense, if applicable.
HSTAmount The harmonized sales tax amount of the expense, if applicable.
PSTAmount The provincial sales tax amount of the expense, if applicable.
ExpenseTextGLD1Label The label of the Expense Level Free-Text General Ledger Dimension 1.
ExpenseTextGLD1 The value of the Expense Level Free-Text General Ledger Dimension 1
ExpenseTextGLD2Label The labels and values of the Expense Level Free-Text General Ledger Dimension 2-5 (see above).
ExpenseTextGLD2
ExpenseTextGLD3Label
ExpenseTextGLD3
ExpenseTextGLD4Label
ExpenseTextGLD4
ExpenseTextGLD5Label
ExpenseTextGLD5
ExpenseReportGLD1Label The label of the Expense Report General Ledger Dimension 1.
ExpenseReportGLD1Name The name of the value of the Expense Report General Ledger Dimension 1.
ExpenseReportGLD1Code The code of the value of the Expense Report General Ledger Dimension 1.
ExpenseReportGLD2Label The labels and values of the Expense Report General Ledger Dimension 2-5 (see above).
ExpenseReportGLD2Name
ExpenseReportGLD2Code
ExpenseReportGLD3Label
ExpenseReportGLD3Name
ExpenseReportGLD3Code
ExpenseReportGLD4Label
ExpenseReportGLD4Name
ExpenseReportGLD4Code
ExpenseReportGLD5Label
ExpenseReportGLD5Name
ExpenseReportGLD5Code
TravelFrom The origin location or code for travel-based expense categories.
TravelTo The destination location or code for travel-based expense categories.
ReceiptImageLink The Certify URL provided to access the receipt image of this expense.
GET
/expenses
Description

This method returns a list of one or more expenses.

Parameters
Name Located in Description Required Schema
x-api-key header API Key (see Authentication) Yes string
x-api-secret header API Secret (see Authentication) Yes string
startdate query Starting point for the processed date range. No string (YYYY-MM-DD)
enddate query Ending point for the processed date range. No string (YYYY-MM-DD)
Responses
Code Description
200 Success
400 One or more parameters is badly formatted. See specific error message for details.
401 Invalid API credentials or credentials were not supplied.
Example Response
{
        "Expense": [
        {
              "ID": "b65455e0-89d5-4910-82bf-cadfbf5c4126",
              "ExpenseReportID": "fdf33884-af87-2891-a7d4-3e574ea6be88",
              "FirstName": "Jack",
              "LastName": "Certi",
              "Email": "jcerti@certify.com",
              "EmployeeID": "jcerti001",
              "DepartmentName": "General",
              "DepartmentCode": "01",
              "ExpenseType": "Lodging",
              "ExpenseCategory": "Lodging",
              "ExpenseCategoryGLCode": "03",
              "Amount": 192.9300,
              "Billable": false,
              "Reimbursable": true,
              "ReimAmount": 191.9600,
              "ExpenseDate": "2016-05-03"
              "Vendor": "Mountain View Hotel",
              "Location": "Mountain View, CA",
              "ProcessedDate": "2016-05-30",
              "Processed": true,
              "Currency": "USD",
              "Reason": "Hotel Stay",
              "VATAmount": 0.0000,
              "HSTAmount": 0.0000,
              "PSTAmount": 0.0000,
              "ExpenseTextGLD1Label": "Text GLD Expense,
              "ExpenseTextGLD1": "business",
              "ExpenseTextGLD2Label": "Numbers Only GLD",
              "ExpenseTextGLD2": "123",
              "ExpenseReportGLD1Label": "Food",
              "ExpenseReportGLD1Name": "Apples and Oranges",
              "ExpenseReportGLD1Code": "A123"
              "ReceiptImageLink": "https://www.certify.com/ReceiptImage.aspx?receiptID=AECCC911C7B60688D6A0C39565A2224EBD&th=6E84D13C4EA482A5CC2A28F85A23F43C"
        },
        {
              "ID": "e373a213-1dd3-4e3d-83b7-786bd9a5e201",
              "ExpenseReportID": "9b7146b0-3e92-4745-babf-8bda8973238a",
              "FirstName": "Robbie",
              "LastName": "The Robot",
              "Email": "rrobot@certify.com",
              "EmployeeID": "rrobot002",
              "DepartmentName": "Marketing",
              "DepartmentCode": "02",
              "ExpenseType": "Travel",
              "ExpenseCategory": Airfare",
              "ExpenseCategoryGLCode": "01",
              "Amount": 150.0000,
              "Billable": false,
              "Reimbursable": false,
              "ReimAmount": 0.0000,
              "ExpenseDate": "2016-06-22"
              "Vendor": "Delta",
              "ProcessedDate": "2016-06-22",
              "Processed": true,
              "Currency": "USD",
              "Reason": "Airfare",
              "VATAmount": 0.0000,
              "HSTAmount": 0.0000,
              "PSTAmount": 0.0000,
              "ExpenseTextGLD1Label": "Text GLD Expense,
              "ExpenseTextGLD1": "Marketing Convention",
              "ExpenseTextGLD2Label": "Numbers Only GLD",
              "ExpenseReportGLD1Label": "Food",
              "ExpenseReportGLD1Name": "Surf and Turf",
              "ExpenseReportGLD1Code": "st001",
              "TravelFrom": "PWM",
              "TravelTo": "BOS"
              "ReceiptImageLink": "https://www.certify.com/ReceiptImage.aspx?receiptID=AECCC911C7B60618D6A0C39565A2224EBD&th=6E84D13C4EA482A5CC2A28F85A23F43C"
        }]
}
    
<Expenses>
    <Expense>
      <ID>b65455e0-89d5-4910-82bf-cadfbf5c4126</ID>
      <ExpenseReportID>fdf33884-af87-2891-a7d4-3e574ea6be88</ExpenseReportID>
      <FirstName>Jack</FirstName>
      <LastName>Certi</LastName>
      <Email>jcerti@certify.com</Email>
      <EmployeeID>jcerti001</EmployeeID>
      <DepartmentName>General</DepartmentName>
      <DepartmentCode>01</DepartmentCode>
      <ExpenseType>Lodging</ExpenseType>
      <ExpenseCategory>Lodging</ExpenseCategory>
      <ExpenseCategoryGLCode>03</ExpenseCategoryGLCode>
      <Amount>192.9300</Amount>
      <Billable>false</Billable>
      <Reimbursable>true</Reimbursable>
      <ReimAmount>191.9600</ReimAmount>
      <ExpenseDate>2016-05-03</ExpenseDate>
      <Vendor>Mountain View Hotel</Vendor>
      <Location>Mountain View, CA</Location>
      <ProcessedDate>2016-05-30</ProcessedDate>
      <Processed>true</Processed>
      <Currency>USD</Currency>
      <Reason>Hotel stay</Reason>
      <VATAmount>Hotel stay</0.0000>
      <HSTAmount>Hotel stay</0.0000>
      <PSTAmount>Hotel stay</0.0000>
      <ExpenseTextGLD1Label>Text GLD Expense</ExpenseTextGLD1Label>
      <ExpenseTextGLD1>business</ExpenseTextGLD1>
      <ExpenseTextGLD2Label>Numbers Only GLD</ExpenseTextGLD2Label>
      <ExpenseTextGLD2>123</ExpenseTextGLD2>
      <ExpenseTextGLD3Label />
      <ExpenseTextGLD3 />
      <ExpenseTextGLD4Label />
      <ExpenseTextGLD4 />
      <ExpenseTextGLD5Label />
      <ExpenseTextGLD5 />
      <ExpenseReportGLD1Label>Food</ExpenseReportGLD1Label>
      <ExpenseReportGLD1Name>Apples and Oranges</ExpenseReportGLD1Name>
      <ExpenseReportGLD1Code>A123</ExpenseReportGLD1Code>
      <ExpenseReportGLD2Label />
      <ExpenseReportGLD2Name />
      <ExpenseReportGLD2Code />
      <ExpenseReportGLD3Label />
      <ExpenseReportGLD3Name />
      <ExpenseReportGLD3Code />
      <ExpenseReportGLD4Label />
      <ExpenseReportGLD4Name />
      <ExpenseReportGLD4Code />
      <ExpenseReportGLD5Label />
      <ExpenseReportGLD5Name />
      <ExpenseReportGLD5Code />
      <TravelFrom />
      <TravelTo />
      <ReceiptImageLink>https://www.certify.com/ReceiptImage.aspx?receiptID=AECCC911C7B60618D6A0C39565A2224EBD&th=6E84D13C4EA482A5CC2A28F85A23F43C</ReceiptImageLink>
    </Expense>
    <Expense>
      <ID>e373a213-1dd3-4e3d-83b7-566bd9a5e201</ID>
      <ExpenseReportID>9b7146b0-3e92-4745-babf-8bda3273238a</ExpenseReportID>
      <FirstName>Robbie</FirstName>
      <LastName>The Robot</LastName>
      <Email>rrobot@certify.com</Email>
      <EmployeeID>rrobot002</EmployeeID>
      <DepartmentName>Marketing</DepartmentName>
      <DepartmentCode>02</DepartmentCode>
      <ExpenseType>Travel</ExpenseType>
      <ExpenseCategory>Airfare</ExpenseCategory>
      <ExpenseCategoryGLCode>01</ExpenseCategoryGLCode>
      <Amount>150.0000</Amount>
      <Billable>false</Billable>
      <Reimbursable>false</Reimbursable>
      <ReimAmount>0.0000</ReimAmount>
      <ExpenseDate>2016-06-22</ExpenseDate>
      <Vendor>Delta</Vendor>
      <ProcessedDate>2016-06-22</ProcessedDate>
      <Processed>true</Processed>
      <Currency>USD</Currency>
      <Reason />
      <VATAmount>Hotel stay</0.0000>
      <HSTAmount>Hotel stay</0.0000>
      <PSTAmount>Hotel stay</0.0000>
      <ExpenseTextGLD1Label>Text GLD Expense</ExpenseTextGLD1Label>
      <ExpenseTextGLD1>Marketing Convention</ExpenseTextGLD1>
      <ExpenseTextGLD2Label>Numbers Only GLD</ExpenseTextGLD2Label>
      <ExpenseTextGLD2 />
      <ExpenseTextGLD3Label />
      <ExpenseTextGLD3 />
      <ExpenseTextGLD4Label />
      <ExpenseTextGLD4 />
      <ExpenseTextGLD5Label />
      <ExpenseTextGLD5 />
      <ExpenseReportGLD1Label>Food</ExpenseReportGLD1Label>
      <ExpenseReportGLD1Name>Surf and Turf</ExpenseReportGLD1Name>
      <ExpenseReportGLD1Code>st001</ExpenseReportGLD1Code>
      <ExpenseReportGLD2Label />
      <ExpenseReportGLD2Name />
      <ExpenseReportGLD2Code />
      <ExpenseReportGLD3Label />
      <ExpenseReportGLD3Name />
      <ExpenseReportGLD3Code />
      <ExpenseReportGLD4Label />
      <ExpenseReportGLD4Name />
      <ExpenseReportGLD4Code />
      <ExpenseReportGLD5Label />
      <ExpenseReportGLD5Name />
      <ExpenseReportGLD5Code />
      <TravelFrom>PWM</TravelFrom>
      <TravelTo>BOS</TravelTo>
      <ReceiptImageLink>https://www.certify.com/ReceiptImage.aspx?receiptID=AECCC911C7B60618D6A0C39565A2224EBD&th=6E84D13C4EA482A5CC2A28F85A23F43C</ReceiptImageLink>
    </Expense>
  </Expenses>
Field Value Description
ID Unique ID of the expense.
ExpenseReportID Unique ID of the expense report the expense is attached to.
FirstName Property fields of the employee who the expense report belongs to.
LastName
Email
EmployeeID
DepartmentName Name of the department of the expense.
DepartmentCode Code of the department of the expense.
ExpenseType Type of expense (Mileage, Lodging, Meals, etc.).
ExpenseCategory Expense category of the expense.
ExpenseCategoryGLCode GL Code of the expense category of the expense.
Amount Total amount of the expense.
Billable Indicates whether the expense is billable (true/false).
Reimbursable Indicates whether the expense is reimbursable (true/false).
ReimAmount Reimbursable amount of the expense.
ExpenseDate The date of the expense (yyyy-MM-dd).
Vendor The vendor of the expense.
Location The location of the expense.
ProcessedDate The date the expense was processed on, if applicable (yyyy-MM-dd).
Processed Indicates whether the expense has been processed (true/false).
Currency Three letter code of the currency of the expense. ISO 4217 format. Ex: “USD”
Reason The text entered in the reason field of the expense
VATAmount The value-added tax amount of the expense, if applicable.
HSTAmount The harmonized sales tax amount of the expense, if applicable.
PSTAmount The provincial sales tax amount of the expense, if applicable.
ExpenseTextGLD1Label The label of the Expense Level Free-Text General Ledger Dimension 1.
ExpenseTextGLD1 The value of the Expense Level Free-Text General Ledger Dimension 1
ExpenseTextGLD2Label The labels and values of the Expense Level Free-Text General Ledger Dimension 2-5 (see above).
ExpenseTextGLD2
ExpenseTextGLD3Label
ExpenseTextGLD3
ExpenseTextGLD4Label
ExpenseTextGLD4
ExpenseTextGLD5Label
ExpenseTextGLD5
ExpenseReportGLD1Label The label of the Expense Report General Ledger Dimension 1.
ExpenseReportGLD1Name The name of the value of the Expense Report General Ledger Dimension 1.
ExpenseReportGLD1Code The code of the value of the Expense Report General Ledger Dimension 1.
ExpenseReportGLD2Label The labels and values of the Expense Report General Ledger Dimension 2-5 (see above).
ExpenseReportGLD2Name
ExpenseReportGLD2Code
ExpenseReportGLD3Label
ExpenseReportGLD3Name
ExpenseReportGLD3Code
ExpenseReportGLD4Label
ExpenseReportGLD4Name
ExpenseReportGLD4Code
ExpenseReportGLD5Label
ExpenseReportGLD5Name
ExpenseReportGLD5Code
TravelFrom The origin location or code for travel-based expense categories.
TravelTo The destination location or code for travel-based expense categories.
ReceiptImageLink The Certify URL provided to access the receipt image of this expense.
GET
/expenses/{id}
Description

This method returns a specific expense associated with the supplied ID value.

Parameters
Name Located in Description Required Schema
x-api-key header API Key (see Authentication) Yes string
x-api-secret header API Secret (see Authentication) Yes string
id path Expense Report/Expense ID Yes string
Responses
Code Description
200 Success
400 One or more parameters is badly formatted. See specific error message for details.
401 Invalid API credentials or credentials were not supplied.
Example Response
{
        "Expense": [
        {
              "ID": "b65455e0-89d5-4910-82bf-cadfbf5c4126",
              "ExpenseReportID": "fdf33884-af87-2891-a7d4-3e574ea6be88",
              "FirstName": "Jack",
              "LastName": "Certi",
              "Email": "jcerti@certify.com",
              "EmployeeID": "jcerti001",
              "DepartmentName": "General",
              "DepartmentCode": "01",
              "ExpenseType": "Lodging",
              "ExpenseCategory": "Lodging",
              "ExpenseCategoryGLCode": "03",
              "Amount": 192.9300,
              "Billable": false,
              "Reimbursable": true,
              "ReimAmount": 191.9600,
              "ExpenseDate": "2016-05-03"
              "Vendor": "Mountain View Hotel",
              "Location": "Mountain View, CA",
              "ProcessedDate": "2016-05-30",
              "Processed": true,
              "Currency": "USD",
              "Reason": "Hotel Stay",
              "VATAmount": 0.0000,
              "HSTAmount": 0.0000,
              "PSTAmount": 0.0000,
              "ExpenseTextGLD1Label": "Text GLD Expense,
              "ExpenseTextGLD1": "business",
              "ExpenseTextGLD2Label": "Numbers Only GLD",
              "ExpenseTextGLD2": "123",
              "ExpenseReportGLD1Label": "Food",
              "ExpenseReportGLD1Name": "Apples and Oranges",
              "ExpenseReportGLD1Code": "A123"      
              "ReceiptImageLink": "https://www.certify.com/ReceiptImage.aspx?receiptID=AECCC911C7B60688D6A0C39565A2224EBD&th=6E84D13C4EA482A5CC2A28F85A23F43C"  
        }]
}
    
<Expenses>
    <Expense>
      <ID>b65455e0-89d5-4910-82bf-cadfbf5c4126</ID>
      <ExpenseReportID>fdf33884-af87-2891-a7d4-3e574ea6be88</ExpenseReportID>
      <FirstName>Jack</FirstName>
      <LastName>Certi</LastName>
      <Email>jcerti@certify.com</Email>
      <EmployeeID>jcerti001</EmployeeID>
      <DepartmentName>General</DepartmentName>
      <DepartmentCode>01</DepartmentCode>
      <ExpenseType>Lodging</ExpenseType>
      <ExpenseCategory>Lodging</ExpenseCategory>
      <ExpenseCategoryGLCode>03</ExpenseCategoryGLCode>
      <Amount>192.9300</Amount>
      <Billable>false</Billable>
      <Reimbursable>true</Reimbursable>
      <ReimAmount>191.9600</ReimAmount>
      <ExpenseDate>2016-05-03</ExpenseDate>
      <Vendor>Mountain View Hotel</Vendor>
      <Location>Mountain View, CA</Location>
      <ProcessedDate>2016-05-30</ProcessedDate>
      <Processed>true</Processed>
      <Currency>USD</Currency>
      <Reason>Hotel stay</Reason>
      <VATAmount>Hotel stay</0.0000>
      <HSTAmount>Hotel stay</0.0000>
      <PSTAmount>Hotel stay</0.0000>
      <ExpenseTextGLD1Label>Text GLD Expense</ExpenseTextGLD1Label>
      <ExpenseTextGLD1>business</ExpenseTextGLD1>
      <ExpenseTextGLD2Label>Numbers Only GLD</ExpenseTextGLD2Label>
      <ExpenseTextGLD2>123</ExpenseTextGLD2>
      <ExpenseTextGLD3Label />
      <ExpenseTextGLD3 />
      <ExpenseTextGLD4Label />
      <ExpenseTextGLD4 />
      <ExpenseTextGLD5Label />
      <ExpenseTextGLD5 />
      <ExpenseReportGLD1Label>Food</ExpenseReportGLD1Label>
      <ExpenseReportGLD1Name>Apples and Oranges</ExpenseReportGLD1Name>
      <ExpenseReportGLD1Code>A123</ExpenseReportGLD1Code>
      <ExpenseReportGLD2Label />
      <ExpenseReportGLD2Name />
      <ExpenseReportGLD2Code />
      <ExpenseReportGLD3Label />
      <ExpenseReportGLD3Name />
      <ExpenseReportGLD3Code />
      <ExpenseReportGLD4Label />
      <ExpenseReportGLD4Name />
      <ExpenseReportGLD4Code />
      <ExpenseReportGLD5Label />
      <ExpenseReportGLD5Name />
      <ExpenseReportGLD5Code />
      <TravelFrom />
      <TravelTo />
      <ReceiptImageLink>https://www.certify.com/ReceiptImage.aspx?receiptID=AECCC911C7B60618D6A0C39565A2224EBD&th=6E84D13C4EA482A5CC2A28F85A23F43C</ReceiptImageLink>
    </Expense>
</Expenses>
Field Value Description
ID Unique ID of the expense.
ExpenseReportID Unique ID of the expense report the expense is attached to.
FirstName Property fields of the employee who the expense report belongs to.
LastName
Email
EmployeeID
DepartmentName Name of the department of the expense.
DepartmentCode Code of the department of the expense.
ExpenseType Type of expense (Mileage, Lodging, Meals, etc.).
ExpenseCategory Expense category of the expense.
ExpenseCategoryGLCode GL Code of the expense category of the expense.
Amount Total amount of the expense.
Billable Indicates whether the expense is billable (true/false).
Reimbursable Indicates whether the expense is reimbursable (true/false).
ReimAmount Reimbursable amount of the expense.
ExpenseDate The date of the expense (yyyy-MM-dd).
Vendor The vendor of the expense.
Location The location of the expense.
ProcessedDate The date the expense was processed on, if applicable (yyyy-MM-dd).
Processed Indicates whether the expense has been processed (true/false).
Currency Three letter code of the currency of the expense. ISO 4217 format. Ex: “USD”
Reason The text entered in the reason field of the expense
VATAmount The value-added tax amount of the expense, if applicable.
HSTAmount The harmonized sales tax amount of the expense, if applicable.
PSTAmount The provincial sales tax amount of the expense, if applicable.
ExpenseTextGLD1Label The label of the Expense Level Free-Text General Ledger Dimension 1.
ExpenseTextGLD1 The value of the Expense Level Free-Text General Ledger Dimension 1
ExpenseTextGLD2Label The labels and values of the Expense Level Free-Text General Ledger Dimension 2-5 (see above).
ExpenseTextGLD2
ExpenseTextGLD3Label
ExpenseTextGLD3
ExpenseTextGLD4Label
ExpenseTextGLD4
ExpenseTextGLD5Label
ExpenseTextGLD5
ExpenseReportGLD1Label The label of the Expense Report General Ledger Dimension 1.
ExpenseReportGLD1Name The name of the value of the Expense Report General Ledger Dimension 1.
ExpenseReportGLD1Code The code of the value of the Expense Report General Ledger Dimension 1.
ExpenseReportGLD2Label The labels and values of the Expense Report General Ledger Dimension 2-5 (see above).
ExpenseReportGLD2Name
ExpenseReportGLD2Code
ExpenseReportGLD3Label
ExpenseReportGLD3Name
ExpenseReportGLD3Code
ExpenseReportGLD4Label
ExpenseReportGLD4Name
ExpenseReportGLD4Code
ExpenseReportGLD5Label
ExpenseReportGLD5Name
ExpenseReportGLD5Code
TravelFrom The origin location or code for travel-based expense categories.
TravelTo The destination location or code for travel-based expense categories.
ReceiptImageLink The Certify URL provided to access the receipt image of this expense.
GET
/receipts
Description

This method returns a list of one or more expenses.

Parameters
Name Located in Description Required Schema
x-api-key header API Key (see Authentication) Yes string
x-api-secret header API Secret (see Authentication) Yes string
expID query Filter receipts returned to a specific Expense ID No string
exprptID query Filter receipts returned to a specific Expense Report ID No string
startdate query Starting point for the expense date range. No string (YYYY-MM-DD)
enddate query Ending point for the expense date range. No string (YYYY-MM-DD)
batchID query Filter receipts returned to a specific Batch ID No string
Responses
Code Description
200 Success
400 One or more parameters is badly formatted. See specific error message for details.
401 Invalid API credentials or credentials were not supplied.
Example Response
{
    "Receipts": [
    {
        "ID": "f86663bd-00b2-495c-ad77-2b6af37895aa",
        "Filename": "image.jpg",
        "UploadDate": "2017-04-03",
        "ReceiptImage": "/9j/4AAQSkZJRgABAQAAAQABAAD..."
    },
    {
        "ID": "03fa573c-b7f0-4398-b329-9f39a03dfb55",
        "Filename": "image2.jpg",
        "UploadDate": "2017-04-03",
        "ReceiptImage": "/9j/4AAQSkZJRgABAQAAAQABAAD..."
    }]
}
<Receipts>
  	<Receipt>
		<ID>f86663bd-00b2-495c-ad77-2b6af37895aa</ID>
		<Filename>image.jpg</Filename>
		<UploadDate>2017-04-03</UploadDate>
		<ReceiptImage>/9j/4AAQSkZJRgABAQAAAQABAAD...;/ReceiptImage>
	</Receipt>
  	<Receipt>
		<ID>03fa573c-b7f0-4398-b329-9f39a03dfb55</ID>
		<Filename>image2.jpg</Filename>
		<UploadDate>2017-04-03</UploadDate>
		<ReceiptImage>/9j/4AAQSkZJRgABAQAAAQABAAD...;/ReceiptImage>
	</Receipt>
</Receipts>
Field Value Description
ID Unique ID of the receipt.
Filename Filename of the receipt.
UploadDate Date the receipt was uploaded to the wallet.
ReceiptImage Base-64 encoded string of the image data.