Get all triples where the specified entity is the subject.

Path Parameters - subject_id: The entity ID to find triples for Response Returns a paginated list of all triples where this entity is the subject…

GET /api/v1/triples/{subject_id}

cURL

curl --request GET \
  --url 'https://api.nsr.stateset.com/api/v1/triples/{subject_id}' \
  --header "X-API-Key: $STATESET_NSR_API_KEY"

200

{
  "items": [
    {
      "confidence": 7.5,
      "object": "string",
      "object_name": "string",
      "predicate": "string",
      "subject": "Replacement tent pole set",
      "subject_name": "string",
      "valid_from": "string",
      "valid_to": "string"
    }
  ],
  "pagination": {
    "has_more": true,
    "limit": 20,
    "next_cursor": "string",
    "offset": 1,
    "prev_cursor": "string",
    "total": 102
  }
}

Path Parameters

• subject_id: The entity ID to find triples for Response Returns a paginated list of all triples where this entity is the subject. Retrieve triples matching filters.

Required scope: read

Path parameters

subject_id · string · required

Subject entity ID to list triples for

Query parameters

limit · integer

Maximum number of items to return (1-1000, default: 50)

offset · integer

Number of items to skip (default: 0)

cursor · string

Cursor for cursor-based pagination (alternative to offset)

sort · string

Sort field with optional direction prefix (- for descending) Examples: ‘created_at’, ‘-name’, ‘confidence’

Response

PaginatedTripleResponse

items · TripleResponse[] · required

The items in this page

Show TripleResponse

confidence · number (float) · required

object · string · required

object_name · string · required

predicate · string · required

subject · string · required

subject_name · string · required

valid_from · string

valid_to · string

pagination · PaginationMeta · required

Show PaginationMeta

has_more · boolean · required

Whether there are more items after this page

limit · integer · required

Current page limit

next_cursor · string

Cursor for the next page (if using cursor-based pagination)

offset · integer · required

Current offset

prev_cursor · string

Cursor for the previous page

total · integer

Total number of items (if available)

Status codes

Code	Meaning
200	Paginated triples with this subject
401	Unauthorized — missing or invalid credentials
403	Forbidden — the key/token lacks the required scope
429	Rate limited — see Retry-After / X-RateLimit-Reset

cURL

curl --request GET \
  --url 'https://api.nsr.stateset.com/api/v1/triples/{subject_id}' \
  --header "X-API-Key: $STATESET_NSR_API_KEY"

200

{
  "items": [
    {
      "confidence": 7.5,
      "object": "string",
      "object_name": "string",
      "predicate": "string",
      "subject": "Replacement tent pole set",
      "subject_name": "string",
      "valid_from": "string",
      "valid_to": "string"
    }
  ],
  "pagination": {
    "has_more": true,
    "limit": 20,
    "next_cursor": "string",
    "offset": 1,
    "prev_cursor": "string",
    "total": 102
  }
}