Skip to content

QuickBooks: Read an attachable — response body — Attachable Attachable Ref item

Read an attachable: response body, field Attachable / AttachableRef / item. Complete fields and constraints for contract 2026-10-20.

API reference · Contract 2026-10-20

SDK schema: Read an attachable — response body — Attachable Attachable Ref item

FieldTypePresenceDescription and constraints
$objectRootAdditional keys: allowed
CustomFieldarrayOptionalIf the user tries to fetch a record without permission, the permission denied message is conveyed through this field.
CustomField[]ModelEach itemExpand Read an invoice — response body — Invoice Custom Field item
EntityRefModelOptionalExpand Read an item — response body — Item Class Ref
Object reference to which this attachment is linked. Set EntityRef.value with the Id of the target object as returned in its response body when queried. Set EntityRef.type with the specific type of the target object. For example, invoice , bill , item , etc.
InactiveJSONOptionalIndicates whether or not to include references to hidden entities when filtering. When set to true , hidden references are returned in the result set. For filtering results, it works with AttachableRef.EntityRef.Type , AttachableRef.EntityRef.Value and AttachableRef.NoRefOnly filters in combination.
Inactive (anyOf 1)booleanAlternative
Inactive (anyOf 2)stringAlternativeKnown values: true, false
IncludeOnSendJSONOptionalUsed when EntityRef.type references a transaction object. This field indicates whether or not the attachment is sent with the transaction when Save and Send button is clicked in the QuickBooks UI or when the Send endpoint (send email) is invoked for the object.
IncludeOnSend (anyOf 1)booleanAlternative
IncludeOnSend (anyOf 2)stringAlternativeKnown values: true, false
LineInfostringOptionalFor transaction objects, used to reference a transaction detail line.
NoRefOnlyJSONOptionalIndicates whether or not to find attachable records that have no references to any entity. Combine with AttachableRef.Inactive to return hidden references.
NoRefOnly (anyOf 1)booleanAlternative
NoRefOnly (anyOf 2)stringAlternativeKnown values: true, false

Referenced models: Read an invoice — response body — Invoice Custom Field item, Read an item — response body — Item Class Ref

Report an issue with this page

Necessary

Required for sign-in, security, authorization, and remembering your choices.

Always active

Analytics

Helps us understand which product and documentation features are useful.

Performance diagnostics

Uses performance tracing and privacy-masked session replay to diagnose problems.

You can change these choices at any time from Cookie settings.