List research snippets

GET

https://api.aventure.vc/v1/entities/:entityId/research/snippets

GET

/v1/entities/:entityId/research/snippets

$ curl -G https://api.aventure.vc/v1/entities/04e2bf9c-a100-72ad-83ff-ba69c647b30b/research/snippets \
>      -H "Authorization: Bearer <token>" \
>      -d page=0 \
>      -d size=25

1 {
2   "content": [
3     {
4       "entityId": "string",
5       "id": 1,
6       "isCurrent": true,
7       "isPrimary": true,
8       "text": "string",
9       "textType": "string",
10       "visible": true,
11       "compliance": {
12         "characterCount": 1,
13         "meetsRequirements": true,
14         "violation": [
15           "string"
16         ],
17         "wordCount": 1
18       },
19       "createdAt": "2024-01-15T09:30:00Z",
20       "updatedAt": "2024-01-15T09:30:00Z"
21     }
22   ],
23   "empty": true,
24   "first": true,
25   "last": true,
26   "number": 1,
27   "numberOfElements": 1,
28   "pageable": {
29     "offset": 1,
30     "pageNumber": 1,
31     "pageSize": 1,
32     "paged": true,
33     "sort": {
34       "empty": true,
35       "sorted": true,
36       "unsorted": true
37     },
38     "unpaged": true
39   },
40   "size": 1,
41   "sort": {
42     "empty": true,
43     "sorted": true,
44     "unsorted": true
45   },
46   "totalElements": 1,
47   "totalPages": 1
48 }

Returns paginated research snippets for one entity. Public reads omit hidden rows and private provenance fields; privileged private reads include hidden rows. Sorting is fixed by the server.

Authentication

AuthorizationBearer

User bearer token: Supabase or Clerk session JWT, Clerk OAuth access token, or Clerk personal API key

X-API-Keystring

Admin API key for system-to-system write operations

X-Client-Secretstring

Client secret for read-only service-to-service access (no writes)

Path parameters

entityIdstringRequiredformat: "uuid"

Canonical entity UUID.

Query parameters

pageintegerOptionalDefaults to 0

Zero-based page index (0..N)

sizeintegerOptionalDefaults to 25

The size of the page to be returned

Response

contentlist of objectsOptional

emptybooleanOptional

firstbooleanOptional

lastbooleanOptional

numberintegerOptional

numberOfElementsintegerOptional

pageableobjectOptional

sizeintegerOptional

sortobjectOptional

totalElementslongOptional

totalPagesintegerOptional

Errors

400

Bad Request Error

401

Unauthorized Error

403

Forbidden Error

404

Not Found Error

406

Not Acceptable Error

429

Too Many Requests Error

500

Internal Server Error

503

Service Unavailable Error