Get a single resource by provider-native ID

curl --request GET \
  --url https://api.routemcp.io/api/v1/accounting/{resource}/{id} \
  --header 'Authorization: <api-key>' \
  --header 'X-End-User-Id: <x-end-user-id>'

import requests

url = "https://api.routemcp.io/api/v1/accounting/{resource}/{id}"

headers = {
    "X-End-User-Id": "<x-end-user-id>",
    "Authorization": "<api-key>"
}

response = requests.get(url, headers=headers)

print(response.text)

const options = {
  method: 'GET',
  headers: {'X-End-User-Id': '<x-end-user-id>', Authorization: '<api-key>'}
};

fetch('https://api.routemcp.io/api/v1/accounting/{resource}/{id}', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.routemcp.io/api/v1/accounting/{resource}/{id}",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
  CURLOPT_HTTPHEADER => [
    "Authorization: <api-key>",
    "X-End-User-Id: <x-end-user-id>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://api.routemcp.io/api/v1/accounting/{resource}/{id}"

	req, _ := http.NewRequest("GET", url, nil)

	req.Header.Add("X-End-User-Id", "<x-end-user-id>")
	req.Header.Add("Authorization", "<api-key>")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.get("https://api.routemcp.io/api/v1/accounting/{resource}/{id}")
  .header("X-End-User-Id", "<x-end-user-id>")
  .header("Authorization", "<api-key>")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://api.routemcp.io/api/v1/accounting/{resource}/{id}")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Get.new(url)
request["X-End-User-Id"] = '<x-end-user-id>'
request["Authorization"] = '<api-key>'

response = http.request(request)
puts response.read_body

{
  "success": true,
  "statusCode": 200,
  "message": "OK",
  "data": {
    "id": "urn:uuid:0958cbc6-6040-430a-848e-aafacbadf4ae",
    "remote_id": "EILBM0XYAR1",
    "created_at": "2026-04-15T10:30:00Z",
    "modified_at": "2026-04-16T15:45:00Z",
    "type": "ACCOUNTS_RECEIVABLE",
    "contact": "022a2bef-57e5-4def-8285-d68a25d1e36e",
    "number": "AIM-01-2026",
    "issue_date": "2026-04-15",
    "due_date": "2026-05-15",
    "paid_on_date": null,
    "memo": "Quarterly retainer.",
    "company": "0bb37dc5-2bf3-4c75-95ab-58f06a93a2ac",
    "employee": null,
    "currency": "USD",
    "exchange_rate": "1.00",
    "payment_term": "fb8c55b6-0525-4452-b3b5-d2922d20b212",
    "total_discount": 0,
    "sub_total": 1500,
    "status": "OPEN",
    "total_tax_amount": 120,
    "total_amount": 1620,
    "balance": 1620,
    "remote_updated_at": "2026-04-16T15:45:00Z",
    "tracking_categories": [],
    "accounting_period": "0a3a9f8b-2c2c-4f50-b34a-e7a3e4d56789",
    "purchase_orders": [],
    "sales_orders": [],
    "payments": [],
    "applied_payments": [],
    "line_items": [
      {
        "id": "urn:uuid:5fc63596-d40e-4c73-bee6-26a0e6356f48",
        "remote_id": "8765",
        "description": "Strategy consulting — April 2026",
        "unit_price": 1500,
        "quantity": 1,
        "total_amount": 1500,
        "currency": "USD",
        "account": "9d9eaaf6-9f95-4e34-bc03-d33b7b4d2611",
        "tax_rate": "ee2c8927-d59f-4f89-90e3-4eef5ee43a91",
        "is_billable": true
      }
    ],
    "applied_credit_notes": [],
    "applied_vendor_credits": [],
    "inclusive_of_tax": false,
    "remote_was_deleted": false,
    "providerSlug": "quickbooks-online",
    "providerId": "a1b2c3d4-e5f6-7890-abcd-ef1234567890"
  }
}

GET

accounting

{resource}

{id}

Get a single resource by provider-native ID

curl --request GET \
  --url https://api.routemcp.io/api/v1/accounting/{resource}/{id} \
  --header 'Authorization: <api-key>' \
  --header 'X-End-User-Id: <x-end-user-id>'

import requests

url = "https://api.routemcp.io/api/v1/accounting/{resource}/{id}"

headers = {
    "X-End-User-Id": "<x-end-user-id>",
    "Authorization": "<api-key>"
}

response = requests.get(url, headers=headers)

print(response.text)

const options = {
  method: 'GET',
  headers: {'X-End-User-Id': '<x-end-user-id>', Authorization: '<api-key>'}
};

fetch('https://api.routemcp.io/api/v1/accounting/{resource}/{id}', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.routemcp.io/api/v1/accounting/{resource}/{id}",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
  CURLOPT_HTTPHEADER => [
    "Authorization: <api-key>",
    "X-End-User-Id: <x-end-user-id>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://api.routemcp.io/api/v1/accounting/{resource}/{id}"

	req, _ := http.NewRequest("GET", url, nil)

	req.Header.Add("X-End-User-Id", "<x-end-user-id>")
	req.Header.Add("Authorization", "<api-key>")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.get("https://api.routemcp.io/api/v1/accounting/{resource}/{id}")
  .header("X-End-User-Id", "<x-end-user-id>")
  .header("Authorization", "<api-key>")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://api.routemcp.io/api/v1/accounting/{resource}/{id}")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Get.new(url)
request["X-End-User-Id"] = '<x-end-user-id>'
request["Authorization"] = '<api-key>'

response = http.request(request)
puts response.read_body

{
  "success": true,
  "statusCode": 200,
  "message": "OK",
  "data": {
    "id": "urn:uuid:0958cbc6-6040-430a-848e-aafacbadf4ae",
    "remote_id": "EILBM0XYAR1",
    "created_at": "2026-04-15T10:30:00Z",
    "modified_at": "2026-04-16T15:45:00Z",
    "type": "ACCOUNTS_RECEIVABLE",
    "contact": "022a2bef-57e5-4def-8285-d68a25d1e36e",
    "number": "AIM-01-2026",
    "issue_date": "2026-04-15",
    "due_date": "2026-05-15",
    "paid_on_date": null,
    "memo": "Quarterly retainer.",
    "company": "0bb37dc5-2bf3-4c75-95ab-58f06a93a2ac",
    "employee": null,
    "currency": "USD",
    "exchange_rate": "1.00",
    "payment_term": "fb8c55b6-0525-4452-b3b5-d2922d20b212",
    "total_discount": 0,
    "sub_total": 1500,
    "status": "OPEN",
    "total_tax_amount": 120,
    "total_amount": 1620,
    "balance": 1620,
    "remote_updated_at": "2026-04-16T15:45:00Z",
    "tracking_categories": [],
    "accounting_period": "0a3a9f8b-2c2c-4f50-b34a-e7a3e4d56789",
    "purchase_orders": [],
    "sales_orders": [],
    "payments": [],
    "applied_payments": [],
    "line_items": [
      {
        "id": "urn:uuid:5fc63596-d40e-4c73-bee6-26a0e6356f48",
        "remote_id": "8765",
        "description": "Strategy consulting — April 2026",
        "unit_price": 1500,
        "quantity": 1,
        "total_amount": 1500,
        "currency": "USD",
        "account": "9d9eaaf6-9f95-4e34-bc03-d33b7b4d2611",
        "tax_rate": "ee2c8927-d59f-4f89-90e3-4eef5ee43a91",
        "is_billable": true
      }
    ],
    "applied_credit_notes": [],
    "applied_vendor_credits": [],
    "inclusive_of_tax": false,
    "remote_was_deleted": false,
    "providerSlug": "quickbooks-online",
    "providerId": "a1b2c3d4-e5f6-7890-abcd-ef1234567890"
  }
}

Authorizations

Authorization

string

header

required

Enter your API key with the Bearer prefix — e.g. Bearer sk_live_xxx (production) or Bearer sk_test_xxx (sandbox)

Headers

X-End-User-Id

string

required

Identifier of the end user whose connected provider should be queried. This is the same endUserId you supplied when creating the connect token. Required on every CRM and accounting call.

Example:

"user-001"

Path Parameters

resource

enum<string>

required

Canonical accounting resource type to fetch. Must be one of the values in the enum below. RouteMCP maps this to the equivalent provider-native object (e.g. invoice → QuickBooks Online Invoice/Bill, Xero Invoice, Zoho Books Invoice). On-demand reports (balance_sheet, income_statement, cash_flow_statement) accept synthetic period URNs as the {id} — see the relevant guide for the URN format.

Available options:

invoice,

contact,

account,

payment,

tax_rate,

journal_entry,

expense,

purchase_order,

sales_order,

credit_note,

vendor_credit,

company_info,

item,

tracking_category,

accounting_period,

payment_method,

payment_term,

address,

attachment,

balance_sheet,

bank_feed_account,

bank_feed_transaction,

cash_flow_statement,

employee,

expense_report,

general_ledger_transaction,

income_statement,

item_fulfillment,

phone_number,

project,

transaction

string

required

Provider-native record id. This is the id as it appears in the source system (e.g. a HubSpot contact id, a Pipedrive deal id, a QuickBooks invoice id). Use the remote_id field returned by the list endpoint.

Example:

"12345"

Query Parameters

provider

string

required

Provider slug identifying which connected provider to target (e.g. hubspot, pipedrive, zoho-crm, quickbooks-online, xero, zoho-books). Required — single-record operations always target a specific provider.

Example:

"hubspot"

enrich

string

Controls enrichment of related-record fields such as owner_name, owner_email, contact_name, companyName, etc. Accepts:

true (default) — enrich all supported fields. Adds extra provider calls; slower but more complete.
false — skip enrichment entirely. Fastest; returns only ids for related records.
A comma-separated list of field names (e.g. owner_name,owner_email) — enrich only the listed fields.

Example:

"true"

Response

Single accounting resource record

Standard envelope returned by GET /accounting/{resource}/{id}. The shape of data depends on the {resource} path parameter — see the tabs to switch between resource variants.

success

boolean

required

Always true for successful (2xx) responses.

Example:

true

statusCode

integer

required

HTTP status code mirrored inside the envelope.

Example:

200

message

string

required

Example:

"OK"

data

Invoice · object

required

Fields present on every accounting resource returned by RouteMCP.

Show child attributes

Upload an attachment Full update of a resource

Overview

CRM Resources

Workspaces

HTTP Streaming Chat

Accounting Resources

Field Mappings

Connect

Get a single resource by provider-native ID

Authorizations

Headers

Path Parameters

Query Parameters

Response