Get note

The Get note method is used to get information about a note added to an entity in the platform.

An API token of a manager is required for authorization. To get an API token via the Operator Control Panel, see Viewing and updating Manager's information

The manager's API token specified in an API request determines:

  • The role and access level of the manager, which determine the availability of a method.
  • The current reseller and downstream resellers accessible within a method.

GET {base_url}/api/v3/resellers/{reseller_id}/notes/{note_id}

Arguments

Name

Parameter Type

Data type

Required/Optional

Description

X-Api-TokenheaderstringRequiredAPI token of a manager that performs the operation (see Viewing and updating Manager's information)
Content-TypeheaderstringRequiredMedia type of the request. Specify the following: application/vnd.api+json
AcceptheaderstringRequired

Supported media types of the answer. Specify the following: application/vnd.api+json

base_urlpathstringRequiredActivePlatform URL
reseller_idpathintegerRequiredID of the current reseller or any of its downstream resellers (see Viewing and updating Reseller general information)
note_idpathintegerRequiredNote ID

Response model

Name

Data type

Description

dataobjectResponse data


id

string

Note ID in the platform

typestringData type

attributesobjectNote information


created_at

string

Date and time of the note creation


updated_atstringDate and time when of the note last update


contentstringThe text of a note


creatorstring

Information about the creator of a note:

  • The name of the manager who added the note.
  • System — the note is created automatically.


original_linkstringA link to a note


original_idintegerThe ID of an entity in the platform with a note. For an Account entity, original_id = null


original_typestring

The type of an entity in the platform with a note:

  • null — Account.
  • Subscription.
  • Order.
  • ManualOperation.
  • Discount.


attachmentobjectInformation about a file attached to a note. For a note without file, attachment = null



namestringThe file name



urlstringThe file link



sizestringThe file size in bytes

Request example

GET /api/v3/resellers/1/notes/214
Host: test.activeplatform.com
Content-Type: application/vnd.api+json
X-Api-Token: vY5fwetestK3gJXZH5uHCw
Accept: application/vnd.api+json

Response example

{
    "data": {
        "id": "5",
        "type": "notes",
        "attributes": {
            "created_at": "2023-03-27T11:35:12.509+03:00",
            "updated_at": "2023-03-27T11:35:12.509+03:00",
            "content": "Migrated",
            "creator": "Bill Smith",
            "original_link": "/admin/accounts/29/notes/5",
            "original_id": null,
            "original_type": null,
            "attachment": {
                "name": "Logo",
                "url": "https://storage.test.activeplatform.com/private/uploads/note/attachment/5/Logo?expires=1680009898&hash=DStusb6w",
                "size": 3439
            }
        }
    }
}