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

{
  "content": [
    {
      "entityId": "string",
      "id": 1,
      "text": "string",
      "textType": "string",
      "compliance": {
        "characterCount": 1,
        "meetsRequirements": true,
        "violation": [
          "string"
        ],
        "wordCount": 1
      },
      "publicSource": {
        "recordedAt": "2024-01-15T09:30:00Z",
        "sourceDetail": "string",
        "lastFetchedAt": "2024-01-15T09:30:00Z",
        "publishedAt": "2024-01-15T09:30:00Z"
      },
      "updatedAt": "2024-01-15T09:30:00Z"
    }
  ],
  "empty": true,
  "first": true,
  "last": true,
  "number": 1,
  "numberOfElements": 1,
  "pageable": {
    "offset": 1,
    "pageNumber": 1,
    "pageSize": 1,
    "paged": true,
    "sort": {
      "empty": true,
      "sorted": true,
      "unsorted": true
    },
    "unpaged": true
  },
  "size": 1,
  "sort": {
    "empty": true,
    "sorted": true,
    "unsorted": true
  },
  "totalElements": 1,
  "totalPages": 1
}

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

Your aVenture API key (https://aventure.vc/settings/api-keys) or OAuth access token

Path parameters

entityIdstringRequiredformat: "uuid"

Entity id (UUID).

Query parameters

pageintegerOptionalDefaults to 0

Zero-based page index (0..N)

sizeintegerOptionalDefaults to 20

The size of the page to be returned

Response headers

X-RateLimit-LimitintegerOptional

Requests allowed per client IP in the current rate-limit window.

X-RateLimit-RemainingintegerOptional

Requests left before the tightest applicable rate-limit bucket rejects.

X-RateLimit-ResetintegerOptional

Seconds until the exhausted rate-limit bucket admits another request; 0 when none is exhausted.

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

422

Unprocessable Entity Error

429

Too Many Requests Error

500

Internal Server Error

503

Service Unavailable Error