> ## Documentation Index > Fetch the complete documentation index at: https://docs.opennous.cloud/llms.txt > Use this file to discover all available pages before exploring further. # List notes > Saved notes, newest first. Optionally for one person or company. Saved notes, newest first, with a short snippet of each. Pass `focus` for one person or company. ## OpenAPI ````yaml GET /v2/notes openapi: 3.1.0 info: title: OpenNous REST API version: 2.0.0 description: >- Read and write the OpenNous revenue context graph over HTTP. Authenticate with a workspace API key. servers: - url: https://api.opennous.cloud description: OpenNous Cloud security: - bearerAuth: [] - apiKeyHeader: [] tags: - name: People - name: Accounts - name: Deals - name: Notes - name: Attention - name: Insights - name: Enrich & score - name: Organization - name: Workflows - name: Webhooks description: >- Subscribe to events and have them pushed to your own stack, with the account record attached. - name: Usage paths: /v2/notes: get: tags: - Notes summary: List notes description: Saved notes, newest first. Optionally for one person or company. operationId: listNotes parameters: - name: focus in: query required: false schema: type: string description: >- Only notes on this person or company. Email, LinkedIn URL, domain, or entity UUID. - name: limit in: query required: false schema: type: integer default: 20 minimum: 1 maximum: 100 description: Page size. - name: offset in: query required: false schema: type: integer default: 0 minimum: 0 description: Rows to skip. responses: '200': description: A page of notes, or candidates when `focus` is ambiguous. content: application/json: schema: oneOf: - type: object properties: notes: type: array items: $ref: '#/components/schemas/NoteSummary' count: type: integer has_more: type: boolean description: True when the page is full. - $ref: '#/components/schemas/Ambiguous' example: notes: - id: 7a2c9e1f-3b4d-4f6a-8c0e-1d2b3a4c5e6f entity_id: 9b2f6c1e-4d3a-4f7e-9a51-2c8d7e3b1f40 type: meeting_brief title: Discovery prep date: '2026-10-02' snippet: >- Goals: confirm budget owner, map the committee, agree a pilot scope. count: 1 has_more: false '401': $ref: '#/components/responses/Unauthorized' '402': $ref: '#/components/responses/UpgradeRequired' '404': $ref: '#/components/responses/EntityNotFound' '429': $ref: '#/components/responses/RateLimited' '500': $ref: '#/components/responses/InternalError' components: schemas: NoteSummary: type: object properties: id: type: string format: uuid entity_id: type: string format: uuid type: type: string enum: - note - meeting_brief - transcript - meeting_notes - pre_meeting - research title: type: - string - 'null' date: type: - string - 'null' snippet: type: string description: First 280 characters. Ambiguous: type: object description: >- Returned with HTTP 200 when the identifier matches more than one record. Pick a candidate and call again with its `entity_id`. required: - status - candidates properties: status: type: string const: ambiguous candidates: type: array items: $ref: '#/components/schemas/FocusCandidate' example: status: ambiguous candidates: - entity_id: 9b2f6c1e-4d3a-4f7e-9a51-2c8d7e3b1f40 name: Sarah Chen detail: VP Sales at Acme matched_on: exact - entity_id: c41d9e0a-7b2f-4a61-8e3c-5f9a0b2d6e71 name: Sarah Chen detail: Founder at Northwind matched_on: exact FocusCandidate: type: object properties: entity_id: type: string format: uuid name: type: - string - 'null' detail: type: - string - 'null' description: Company or title, to tell candidates apart. matched_on: type: string description: >- How the candidate matched: `exact`, `prefix`, `contains`, or `company`. Error: type: object description: >- Every error response. `error` is a stable machine code. Some errors add fields such as `detail`, `supported`, `max`, or `reason`. required: - error properties: error: type: string description: Machine-readable error code. detail: type: string description: Human-readable explanation, when there is one. additionalProperties: true responses: Unauthorized: description: Missing, unknown, or expired API key. content: application/json: schema: $ref: '#/components/schemas/Error' examples: missing: summary: api_key_required value: error: api_key_required invalid: summary: invalid_api_key value: error: invalid_api_key expired: summary: api_key_expired value: error: api_key_expired detail: >- This API key has expired. Create or rotate a key to get a fresh one. UpgradeRequired: description: The workspace is past its monthly operations limit and grace window. content: application/json: schema: $ref: '#/components/schemas/Error' example: error: upgrade_required reason: ops_limit_reached current_plan: starter upgrade_url: /settings?section=billing EntityNotFound: description: Nothing in the workspace matches the identifier. content: application/json: schema: $ref: '#/components/schemas/Error' example: error: entity_not_found RateLimited: description: More than 600 requests in a minute on this key. headers: RateLimit-Limit: schema: type: integer description: Requests allowed per window. RateLimit-Remaining: schema: type: integer description: Requests left in the window. RateLimit-Reset: schema: type: integer description: Seconds until the window resets. content: application/json: schema: $ref: '#/components/schemas/Error' example: error: rate_limited InternalError: description: Unexpected server error. content: application/json: schema: $ref: '#/components/schemas/Error' example: error: internal_error securitySchemes: bearerAuth: type: http scheme: bearer description: Workspace API key. Create one in **Settings → API keys**. apiKeyHeader: type: apiKey in: header name: X-API-Key description: The same key, sent as a header. ```` This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.