Skip to main content

Get a note​

Retrieves the details of a single note (required scope notes:read)

Path Parameters
    noteId int64 required

    Possible values: >= 1

    The unique identifier of the note

Header Parameters
    Customer-Id int64 required

    The customer identifier

Responses

Success

Schema
    id int64

    The unique identifier of the note

    entityType NoteEntityType

    Possible values: [contact, job, stockItem, resource, vehicle, salesOpportunity, contract]

    The type of entity that the note is associated to

    Possible values:

    • contact: Associated with a contact entity
    • job: Associated with a job entity
    • stockItem: Associated with a stock item entity
    • resource: Associated with a resource entity
    • vehicle: Associated with a vehicle entity
    • salesOpportunity: Associated with a sales opportunity entity
    • contract: Associated with a contract entity

    entityId int64

    The unique identifier of the associated entity that owns the note, relative to the entityType

    contactId int64 nullable

    The unique identifier of the contact associated to this note

    typeId int64

    The unique identifier of the note type definition associated to this note

    createdAt date-time

    The UTC timestamp of when this note was created

    subject string

    The subject of the note

    parentId int64 nullable

    The unique identifier of the parent note of this note

    dueAt date-time nullable

    The UTC timestamp of when this note is due for completion

    progressedAt date-time nullable

    The UTC timestamp of when this note was last progressed

    reference string

    The internal reference of the note - should usually be unique

    status NoteStatus

    Possible values: [open, completed, cancelled]

    The status of the note

    Possible values:

    • open: Open
    • completed: Completed
    • cancelled: Cancelled

    description string

    The detailed textual content about the note

    completionText string nullable

    A textual note that can be added when a note has been completed. Can only be set if the note has a completed status

    progressPercentage int32

    The percentage of work done required to complete the note

    createdByUserName string

    The name of the user who owns the note

    ownedByUserId int64

    The unique id of the user who owns the note

    ownedByUserName string

    The name of the user who owns the note

    customFields object[]

    The collection of custom fields applied to this note

  • Array [
    • definitionId int64

    The unique identifier of the associated custom field definition

    value string nullable

    The current value set for the custom field

    definition object

    Represents the definition of a custom field

    caption string

    The caption of a custom field

    type CustomFieldType

    Possible values: [boolean, integer, decimal, text, list, statement, date, note, time, systemList]

    The type of the custom field. New field types may be added in the future, so integrations should be resilient to this

    Possible values:

    • boolean: Indicates a boolean field (Example: "false")
    • integer: Indicates an integer numeric field (Example: "1001")
    • decimal: Indicates a floating point numeric field (Example: "1.42")
    • text: Indicates an editable text field (Example: "Purple")
    • list: Indicates a field with a single value from a predefined list of options (Example: "Purple")
    • statement: Indicates a text field that cannot be edited. The value is always equal to the default value (Example: "By signing this you agree to the following...")
    • date: Indicates a date field, which will be represented as an RFC3339 formatted date string. The default value is not supported for this type and will always be null (Example: "2024-01-31")
    • note: Indicates a multiline, editable text field. Lines are seperated with a line feed character (Example: "This is a note.")
    • time: Indicates a time field, formatted as HH:mm. The default value is not supported for this type and will always be null (Example: "10:30")
    • systemList: Indicates the ID of a related resource, vehicle or web user (Example: "228007")

    listOptions string[] nullable

    Shows the possible values for a list type custom field. Value will be null if type is not list

    isRequired boolean

    Indicates if the field is required in the UI. This is NOT enforced in the API

    isEditable boolean

    Indicates if the field is editable

    default string nullable

    The default value of a custom field. Formatted in accordance with the rules of the field type

    systemListValueMetadata object

    Represents details of custom field value of type system list

    label string nullable

    A descriptive label for the specific resource, vehicle or web user that this system list value relates to

    entityType CustomFieldSystemListType

    Possible values: [resource, vehicle, webUser]

    The type of entity used for custom field value of type system list

    Possible values:

    • resource
    • vehicle
    • webUser

  • ]
Loading...