latestOpenAPI 3.1.0raw.githubusercontent.com2026-08-054874600.7 KB

3a810b6f9c66

Mapping options

Mapping options

Gets the mapping options (accounts, trackingCategories and taxRates) for a company's accounting software

get/companies/{companyId}/sync/expenses/mappingOptions

Path parameters

companyIdstring uuid required

Unique identifier for your SMB in Codat.

Example:8a210b68-6988-11ed-a1eb-0242ac120002

Unique identifier for a company.

Response

Success

expenseProviderstring nullable

Name of the expense integration.

Example response

{
  "expenseProvider": "Partner Expense",
  "accounts": [
    {
      "id": "127f3b99-8dc2-4b7e-854c-91ef9bd2757b",
      "nominalCode": "300",
      "name": "Purchases",
      "currency": "GBP",
      "accountType": "Expense",
      "fullyQualifiedCategory": "Expense.DirectCosts",
      "validTransactionTypes": [
        "Payment"
      ],
      "validFor": [
        "expense-transactions.Payment"
      ]
    }
  ],
  "trackingCategories": [
    {
      "id": "DEPARTMENT_2",
      "name": "New York",
      "parentId": "DEPARTMENTS"
    }
  ],
  "taxRates": [
    {
      "id": "23_Bills",
      "name": "20% Bill tax Bills",
      "code": "20% Bill tax",
      "effectiveTaxRate": 20,
      "totalTaxRate": 20,
      "validTransactionTypes": [
        "Payment"
      ]
    }
  ]
}