v1

latestOpenAPI 3.0.3Apache 2.02026-07-131453851.1 MB
Expenses

List Expenses

List Expenses

get/accounting/expenses

Query parameters

rawboolean

Include raw response. Mostly used for debugging purposes

cursorstring nullable

Cursor to start from. You can find cursors for next/previous pages in the meta.cursors property of the response.

limitinteger

Number of results to return. Minimum 1, Maximum 200, Default 20

updated_sincestring date-time
status'draft' | 'posted' | 'voided'
type'expense' | 'refund'

Apply filters

{
  "updated_since": "2020-09-30T07:43:32.000Z",
  "status": "draft",
  "type": "expense"
}
example_downstream_propertystring

All passthrough query parameters are passed along to the connector as is (?pass_through[search]=leads becomes ?search=leads)

Optional unmapped key/values that will be passed through to downstream as query parameters. Ie: ?pass_through[search]=leads becomes ?search=leads

{
  "search": "San Francisco"
}

Headers

x-apideck-consumer-idstring required

ID of the consumer which you want to get or push data from

x-apideck-app-idstring required

The ID of your Unify application

x-apideck-service-idstring

Provide the service id you want to call (e.g., pipedrive). Only needed when a consumer has activated multiple integrations for a Unified API.

x-apideck-company-idstring

The ID of the company to scope requests to. For connectors that support multi-company, this overrides the default company configured in connection settings.

Response

Expenses

status_codeinteger required

HTTP Response Status Code

statusstring required

HTTP Response Status

servicestring required

Apideck ID of service provider

resourcestring required

Unified API resource name

operationstring required

Operation performed

_rawRaw nullable

Raw response from the integration when raw=true query param is provided

Example response

{
  "status_code": 200,
  "status": "OK",
  "service": "quickbooks",
  "resource": "Expenses",
  "operation": "all",
  "data": [
    {
      "id": "12345",
      "display_id": "123456",
      "number": "OIT00546",
      "transaction_date": "2021-05-01T12:00:00.000Z",
      "account_id": "123456",
      "account": {
        "id": "123456",
        "type": "ledger_account",
        "code": "1100",
        "display_id": "123456",
        "account_number": "123465",
        "name": "Current assets",
        "downstream_id": "12345"
      },
      "supplier_id": "12345",
      "supplier": {
        "id": "12345",
        "display_id": "SUPP00101",
        "display_name": "Windsurf Shop",
        "company_name": "The boring company",
        "address": {
          "id": "123",
          "type": "primary",
          "string": "25 Spring Street, Blackburn, VIC 3130",
          "name": "HQ US",
          "line1": "Main street",
          "line2": "apt #",
          "line3": "Suite #",
          "line4": "delivery instructions",
          "line5": "Attention: Finance Dept",
          "street_number": "25",
          "city": "San Francisco",
          "state": "CA",
          "postal_code": "94104",
          "country": "US",
          "latitude": "40.759211",
          "longitude": "-73.984638",
          "county": "Santa Clara",
          "contact_name": "Elon Musk",
          "salutation": "Mr",
          "phone_number": "111-111-1111",
          "fax": "122-111-1111",
          "email": "elon@musk.com",
          "website": "https://elonmusk.com",
          "notes": "Address notes or delivery instructions.",
          "row_version": "1-12345"
        }
      },
      "company_id": "12345",
      "location": {
        "id": "123456",
        "display_id": "123456",
        "name": "New York Office",
        "downstream_id": "12345"
      },
      "department_id": "12345",
      "department": {
        "id": "12345",
        "display_id": "123456",
        "name": "Acme Inc.",
        "downstream_id": "12345"
      },
      "payment_type": "cash",
      "currency": "USD",
      "currency_rate": 0.69,
      "type": "expense",
      "memo": "For travel expenses incurred on 2024-05-15",
      "tax_rate": {
        "id": "123456",
        "code": "N-T",
        "name": "GST on Purchases",
        "rate": 10
      },
      "tax_inclusive": true,
      "sub_total": 250,
      "total_tax": 25,
      "total_amount": 275,
      "tracking_categories": [
        {
          "id": "123456",
          "code": "100",
          "name": "New York",
          "parent_id": "123456",
          "parent_name": "New York"
        }
      ],
      "line_items": [
        {
          "id": "12345",
          "tracking_categories": [
            {
              "id": "123456",
              "code": "100",
              "name": "New York",
              "parent_id": "123456",
              "parent_name": "New York"
            }
          ],
          "account_id": "123456",
          "account": {
            "id": "123456",
            "name": "Bank account",
            "nominal_code": "N091",
            "code": "453",
            "parent_id": "123456",
            "display_id": "123456"
          },
          "customer_id": "12345",
          "customer": {
            "id": "12345",
            "display_id": "CUST00101",
            "display_name": "Windsurf Shop",
            "name": "Windsurf Shop",
            "company_name": "The boring company",
            "email": "boring@boring.com"
          },
          "department_id": "12345",
          "department": {
            "id": "12345",
            "display_id": "123456",
            "name": "Acme Inc.",
            "downstream_id": "12345"
          },
          "location_id": "12345",
          "location": {
            "id": "123456",
            "display_id": "123456",
            "name": "New York Office",
            "downstream_id": "12345"
          },
          "tax_rate": {
            "id": "123456",
            "code": "N-T",
            "name": "GST on Purchases",
            "rate": 10
          },
          "description": "Travel US.",
          "type": "expense_account",
          "total_amount": 275,
          "tax_amount": 27.5,
          "quantity": 1,
          "unit_price": 27500.5,
          "item": {
            "id": "12344",
            "code": "120-C",
            "name": "Model Y"
          },
          "line_number": 1,
          "rebilling": {
            "rebillable": true,
            "rebill_status": "billed",
            "linked_transaction_id": "txn_abc123",
            "linked_transaction_line_id": "line_xyz789"
          }
        }
      ],
      "reference": "INV-2024-001",
      "source_document_url": "https://www.invoicesolution.com/expense/123456",
      "custom_fields": [
        {
          "id": "2389328923893298",
          "name": "employee_level",
          "description": "Employee Level",
          "value": "Uses Salesforce and Marketo"
        }
      ],
      "status": "draft",
      "updated_at": "2020-09-30T07:43:32.000Z",
      "created_at": "2020-09-30T07:43:32.000Z",
      "row_version": "1-12345",
      "updated_by": "12345",
      "created_by": "12345",
      "pass_through": [
        {
          "extend_paths": [
            {
              "path": "$.nested.property",
              "value": {
                "TaxClassificationRef": {
                  "value": "EUC-99990201-V1-00020000"
                }
              }
            }
          ]
        }
      ]
    }
  ],
  "meta": {
    "items_on_page": 50,
    "cursors": {
      "previous": "em9oby1jcm06OnBhZ2U6OjE=",
      "current": "em9oby1jcm06OnBhZ2U6OjI=",
      "next": "em9oby1jcm06OnBhZ2U6OjM="
    },
    "total_count": 1,
    "warnings": [
      {
        "type": "downstream_request_failed",
        "status_code": 429,
        "operation": "getManager"
      }
    ]
  },
  "links": {
    "previous": "https://unify.apideck.com/crm/companies?cursor=em9oby1jcm06OnBhZ2U6OjE%3D",
    "current": "https://unify.apideck.com/crm/companies",
    "next": "https://unify.apideck.com/crm/companies?cursor=em9oby1jcm06OnBhZ2U6OjM"
  }
}