# List all notes

You can fetch a list of notes that are associated to a contact.
Requires the `read_users_companies` or `read_write_users` OAuth scope.

Endpoint: GET /contacts/{contact_id}/notes
Version: 2.18
Security: bearerAuth

## Path parameters:

  - `contact_id` (string, required)
    The unique identifier of a contact.

## Query parameters:

  - `page` (integer)
    The page of results to return. Defaults to `1`.

  - `per_page` (integer)
    The number of notes to return per page. Defaults to `50`, maximum `60`.

  - `order` (string)
    The order the notes are returned in, by id. Defaults to `desc`.

## Header parameters:

  - `Intercom-Version` (string)

## Response 200 fields (application/json):

  - `type` (string)
    String representing the object's type. Always has the value `list`.
    Example: list

  - `data` (array)
    An array of notes.

  - `data.type` (string)
    String representing the object's type. Always has the value `note`.
    Example: note

  - `data.id` (string)
    The id of the note.
    Example: 17495962

  - `data.created_at` (integer)
    The time the note was created.
    Example: 1674589321

  - `data.contact` (object)
    Represents the contact that the note was created about.

  - `data.contact.type` (string)
    String representing the object's type. Always has the value `contact`.

  - `data.contact.id` (string)
    The id of the contact.
    Example: 214656d0c743eafcfde7f248

  - `data.company` (object)
    Represents the company that the note was created about.

  - `data.company.type` (string)
    String representing the object's type. Always has the value `company`.

  - `data.company.id` (string)
    The id of the company.
    Example: 5f4d3c1c-7b1b-4d7d-a97e-6095715c6632

  - `data.author` (object)
    Represents the Admin that created the note. When the note has no recorded admin, this is `null` on a single note and left out of each note in a list.

  - `data.author.type` (string)
    String representing the object's type. Always has the value `admin`.
    Example: admin

  - `data.author.id` (string)
    The id representing the admin.
    Example: 1295

  - `data.author.name` (string)
    The name of the admin.
    Example: Joe Example

  - `data.author.email` (string)
    The email of the admin.
    Example: jdoe@example.com

  - `data.author.job_title` (string)
    The job title of the admin.
    Example: Associate

  - `data.author.away_mode_enabled` (boolean)
    Identifies if this admin is currently set in away mode.
    Example: false

  - `data.author.away_mode_reassign` (boolean)
    Identifies if this admin is set to automatically reassign new conversations to the apps default inbox.
    Example: false

  - `data.author.away_status_reason_id` (integer)
    The unique identifier of the away status reason. Not returned by List all admins.
    Example: 12345

  - `data.author.has_inbox_seat` (boolean)
    Identifies if this admin has a paid inbox seat to restrict/allow features that require them.
    Example: true

  - `data.author.team_ids` (array)
    The ids of the teams the admin belongs to. When the workspace has a default team, its id is the last item.
    Example: [814865]

  - `data.author.avatar` (object)
    The teammate's avatar image. On List all admins it is only included when `display_avatar` is `true`. Elsewhere it is left out when the teammate has neither an uploaded avatar nor a gravatar.

  - `data.author.avatar.type` (string)
    Value is `avatar`. Returned by List all admins only.
    Example: avatar

  - `data.author.avatar.image_url` (string)
    The URL of the avatar image.
    Example: https://picsum.photos/200/300

  - `data.author.team_priority_level` (object)
    Admin priority levels for teams

  - `data.author.team_priority_level.primary_team_ids` (array)
    The primary team ids for the team
    Example: [814865]

  - `data.author.team_priority_level.secondary_team_ids` (array)
    The secondary team ids for the team
    Example: [493881]

  - `data.author.role` (object)
    The role assigned to this admin. Only present if the admin has a role assigned.

  - `data.author.role.type` (string)
    String representing the object's type. Always has the value `role`.
    Example: role

  - `data.author.role.id` (string)
    The id of the role.
    Example: 1

  - `data.author.role.name` (string)
    The name of the role.
    Example: Support Agent

  - `data.body` (string)
    The body text of the note.
    Example: <p>Text for the note.</p>

  - `total_count` (integer)
    A count of the total number of notes.
    Example: 1

  - `pages` (object)
    The majority of list resources in the API are paginated to allow clients to traverse data over multiple requests.

Their responses are likely to contain a pages object that hosts pagination links which a client can use to paginate through the data without having to construct a query. The link relations for the pages field are as follows.

  - `pages.type` (string)
    Enum: "pages"

  - `pages.page` (integer)
    Example: 1

  - `pages.next` (string)
    A link to the next page of results. Omitted or `null` on the last page, depending on the list. Some lists never include `next` or `prev`, so compare `page` with `total_pages` to tell whether more pages remain.

  - `pages.prev` (string)
    A link to the previous page of results. Omitted on the first page.

  - `pages.per_page` (integer)
    Example: 50

  - `pages.total_pages` (integer)
    Example: 1

## Response 400 fields (application/json):

  - `type` (string, required)
    The type is error.list
    Example: error.list

  - `request_id` (string)
    Example: f93ecfa8-d08a-4325-8694-89aeb89c8f85

  - `errors` (array, required)
    An array of one or more error objects

  - `errors.code` (string, required)
    A string indicating the kind of error, used to further qualify the HTTP response code.
    Example: unauthorized

  - `errors.message` (string)
    Optional. Human readable description of the error.
    Example: Access Token Invalid

## Response 401 fields (application/json):

  - `type` (string, required)
    The type is error.list
    Example: error.list

  - `request_id` (string)
    Example: f93ecfa8-d08a-4325-8694-89aeb89c8f85

  - `errors` (array, required)
    An array of one or more error objects

  - `errors.code` (string, required)
    A string indicating the kind of error, used to further qualify the HTTP response code.
    Example: unauthorized

  - `errors.message` (string)
    Optional. Human readable description of the error.
    Example: Access Token Invalid

## Response 404 fields (application/json):

  - `type` (string, required)
    The type is error.list
    Example: error.list

  - `request_id` (string)
    Example: f93ecfa8-d08a-4325-8694-89aeb89c8f85

  - `errors` (array, required)
    An array of one or more error objects

  - `errors.code` (string, required)
    A string indicating the kind of error, used to further qualify the HTTP response code.
    Example: unauthorized

  - `errors.message` (string)
    Optional. Human readable description of the error.
    Example: Access Token Invalid

