Skip to main content
GET
/
v0
/
platform
/
instances
/
{instance_id}
Retrieve an Instance
curl --request GET \
  --url https://api.sandbox.teal.dev/v0/platform/instances/{instance_id} \
  --header 'Authorization: Bearer <token>'
{
  "id": "<string>",
  "entries_start": "2023-11-07T05:31:56Z",
  "name": "<string>",
  "subscription": "tier0",
  "accounting_package": "platformgl",
  "latest_journal_entry_datetime": "2024-10-01T00:00:00Z",
  "latest_close_datetime": "2025-10-01T00:00:00Z",
  "accounting_basis": "accrual"
}

Authorizations

​
Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Path Parameters

​
instance_id
string
required

The instance ID

Response

Successful Response

​
id
string
required

The unique ID of the object.

Example:

"RKtPbubK5NcbBsUmU1ktSP"

​
entries_start
string<date-time>
required

The datetime in UTC time from which the API will sync an Instance's accounting data. Transactions or journal entries cannot be entered before this date.

Example:

"2024-01-01T00:00:00Z"

​
name
string
required

The name of the business.

Example:

"ACME Goods Inc"

​
subscription
enum<string>
required

The Instance's subscription tier.

Available options:
tier0,
tier1,
tier2,
tier3,
tier4,
tier5
Example:

"tier3"

​
accounting_package
enum<string>
required

The type of accounting package the Instance uses as the source of truth for their books.

Available options:
platformgl,
quickbooks
Example:

"platformgl"

​
latest_journal_entry_datetime
string<date-time> | null
required

The datetime of the latest journal entry if one exists, otherwise null

Example:

"2024-10-01T00:00:00Z"

​
latest_close_datetime
string<date-time> | null
required

The datetime when the books for the instance were last closed by a bookkeeper

Example:

"2025-10-01T00:00:00Z"

​
accounting_basis
enum<string> | null

The accounting method used: cash basis or accrual basis.

Available options:
cash,
accrual
Example:

"accrual"