Get one record of any type

​

Fetch a record without knowing its type in advance. act-minted ids carry their type in the prefix (t0_invoice_…); for ids you supplied through insert, pass type.

Path Parameters

  • external_id
    Type: string
    required

    The record's external id.

Query Parameters

  • type
    Type: stringenumnullable

    Public type name. Required when the id was not minted by act.

    values
    InvoiceVendorBillPaymentCustomerVendorLineItemBillLineItem
  • expand
    Type: array of stringnullable

    Linked records to include under expanded; must be links the resolved type declares (see /types).

  • include_deleted
    Type: boolean

    Return the record even if act has deleted it.

  • entity
    Type: string

    External id of the entity to act for, from GET /v1/entities. Required when signed in with OAuth (an organization can hold several entities; ask the user which one if more than one could apply). Optional with an API key, which is scoped to one entity already.

Responses

  • application/json
  • 400

    The record's type could not be resolved: no act prefix and no type, an unknown type, a type contradicting the prefix, or an act type not served here (CAPI66); or expand names a link the resolved type does not declare (CAPI68).

  • 401

    The credential was refused: none sent (CAPI11), an API key that is not valid (CAPI15), or an OAuth sign-in that has expired (CAPI16), was not issued for this API (CAPI17), names an organization T0 does not hold (CAPI18) or a membership that is no longer usable (CAPI19). detail says what to do.

  • 403

    The key lacks customer_api:read, or the signed-in user cannot read this record type on the entity (CAPI71); or entity is not the key's own (CAPI14).

  • 404

    No record of this type with that id in the entity (CAPI61), or no such entity in your organization (CAPI13).

  • 409

    The id resolves to more than one record of this type (CAPI63), or the entity has no applied books start date (CAPI67).

  • application/json
Request Example for get/v1/objects/{external_id}
curl 'https://api.t0.ai/v1/objects/{external_id}?include_deleted=false' \
  --header 'Authorization: Bearer YOUR_SECRET_TOKEN'

{
  "data": {
    "amount": 1,
    "currencyCode": "string",
    "customFields": {
      "additionalProperty": "anything"
    },
    "date": "2026-11-11",
    "description": "string",
    "endDate": "2026-11-11",
    "exchangeRates": [],
    "startDate": "2026-11-11"
  },
  "id": {
    "dataType": "Adjustment",
    "externalId": "string",
    "platformDataType": "string",
    "platformId": "string",
    "platformType": "string"
  },
  "links": [],
  "expanded": {
    "additionalProperty": [
      {
        "data": {
          "amount": 1,
          "currencyCode": "string",
          "customFields": {
            "additionalProperty": "anything"
          },
          "date": "2026-11-11",
          "description": "string",
          "endDate": "2026-11-11",
          "exchangeRates": [],
          "startDate": "2026-11-11"
        },
        "id": {
          "dataType": "Adjustment",
          "externalId": "string",
          "platformDataType": "string",
          "platformId": "string",
          "platformType": "string"
        },
        "links": []
      }
    ]
  },
  "expanded_truncated": [
    "string"
  ]
}

Successful Response

Previous
Discover the exposed record types
Next
Get one Invoice