Get the history of progress updates for a note

Retrieves the history of progress updates made against a note (required scope notes:read)

Path Parameters

noteId int64 required

Possible values: >= 1

The unique identifier of the note

Query Parameters

sortBy NoteProgressSortOptions

Possible values: [progressedAt]

The field to sort items in the page by

direction SortDirection

Possible values: [ascending, descending]

The direction to apply the sort

pageNumber int32

Possible values: >= 1 and <= 2147483

The page number being requested (minimum: 1, maximum: 2147483)

pageSize int32

Possible values: >= 1 and <= 1000

The page size being requested (minimum: 1, maximum: 1000)

Header Parameters

Customer-Id int64 required

The customer identifier

Responses

• 200
• 400
• 403
• 404
• 500

---

Success

application/json

Schema

Example (from schema)

---

Schema

items object[]
The items returned for the requested page
Array [
id int64
The unique identifier of the note progress entry
progressedAt date-time
The UTC timestamp of when this note was progressed
percentage int32
The percentage the note was progressed to
comment string
Free text description about progress made by this update
]
pageNumber int32

The page number of the response where 1 is the first page

pageSize int32

The number of items requested for the current page

pageItemCount int32

The number of items returned in the current page

{
  "items": [
    {
      "id": 124124,
      "progressedAt": "2023-09-12T11:24:23.0000000+00:00",
      "percentage": 50,
      "comment": "Sent out the new part"
    }
  ],
  "pageNumber": 2,
  "pageSize": 100,
  "pageItemCount": 55
}

Bad Request

application/problem+json

Schema

Example (from schema)

---

Schema

type string nullable

A URI reference [RFC3986] that identifies the problem type

title string nullable

A short, human-readable summary of the problem type

status int32 nullable

The HTTP status code([RFC7231], Section 6) generated by the origin server for this occurrence of the problem

detail string nullable

A human-readable explanation specific to this occurrence of the problem

instance string nullable

A URI reference that identifies the specific occurrence of the problem

{
  "type": "https://example.com/probs/out-of-credit",
  "title": "You do not have enough credit",
  "status": 403,
  "detail": "Your current balance is 30, but that costs 50",
  "instance": "/account/12345/msgs/abc"
}

Forbidden

application/problem+json

Schema

Example (from schema)

---

Schema

type string nullable

A URI reference [RFC3986] that identifies the problem type

title string nullable

A short, human-readable summary of the problem type

status int32 nullable

The HTTP status code([RFC7231], Section 6) generated by the origin server for this occurrence of the problem

detail string nullable

A human-readable explanation specific to this occurrence of the problem

instance string nullable

A URI reference that identifies the specific occurrence of the problem

{
  "type": "https://example.com/probs/out-of-credit",
  "title": "You do not have enough credit",
  "status": 403,
  "detail": "Your current balance is 30, but that costs 50",
  "instance": "/account/12345/msgs/abc"
}

Not Found

application/problem+json

Schema

Example (from schema)

---

Schema

type string nullable

A URI reference [RFC3986] that identifies the problem type

title string nullable

A short, human-readable summary of the problem type

status int32 nullable

The HTTP status code([RFC7231], Section 6) generated by the origin server for this occurrence of the problem

detail string nullable

A human-readable explanation specific to this occurrence of the problem

instance string nullable

A URI reference that identifies the specific occurrence of the problem

{
  "type": "https://example.com/probs/out-of-credit",
  "title": "You do not have enough credit",
  "status": 403,
  "detail": "Your current balance is 30, but that costs 50",
  "instance": "/account/12345/msgs/abc"
}

Server Error

application/problem+json

Schema

Example (from schema)

---

Schema

type string nullable

A URI reference [RFC3986] that identifies the problem type

title string nullable

A short, human-readable summary of the problem type

status int32 nullable

The HTTP status code([RFC7231], Section 6) generated by the origin server for this occurrence of the problem

detail string nullable

A human-readable explanation specific to this occurrence of the problem

instance string nullable

A URI reference that identifies the specific occurrence of the problem

{
  "type": "https://example.com/probs/out-of-credit",
  "title": "You do not have enough credit",
  "status": 403,
  "detail": "Your current balance is 30, but that costs 50",
  "instance": "/account/12345/msgs/abc"
}

Loading...