List entities

List entities with optional filters and cursor-based pagination. Supports full-text search via `q` parameter (uses `websearch_to_tsquery`). Cursor pagination guarantees no skipped or duplicated rows under concurrent writes.

Query Parameters

vertical?|

Filter by vertical (e.g., 'manufacturing').

entity_type?|

Filter by entity type (e.g., 'product').

status?|

Filter by status: active, archived, draft.

q?|

Full-text search query. Supports OR, phrases, negation.

cursor?|

Opaque pagination cursor from a previous response.

limit?integer

Results per page (1-100).

Default20

Range1 <= value <= 100

Header Parameters

x-tenant-id?|

authorization?|

Response Body

`application/json`

curl -X GET "https://loading/api/v1/entities"

{
  "items": [
    {
      "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",
      "tenant_id": "34f5c98e-f430-457b-a812-92637d0c6fd0",
      "vertical": "string",
      "entity_type": "string",
      "name": "string",
      "description": "string",
      "description_llm": "string",
      "source_url": "string",
      "source_type": "string",
      "source_name": "string",
      "source_id": "string",
      "status": "string",
      "vertical_data": {},
      "embedding_status": "string",
      "claim_status": "string",
      "data_quality_score": 0,
      "created_at": "2019-08-24T14:15:22Z",
      "updated_at": "2019-08-24T14:15:22Z"
    }
  ],
  "pagination": {
    "cursor": "string",
    "has_more": false,
    "total": 0
  }
}

{
  "detail": [
    {
      "loc": [
        "string"
      ],
      "msg": "string",
      "type": "string",
      "input": null,
      "ctx": {}
    }
  ]
}

Query Parameters

Header Parameters

Response Body

200application/json

422application/json

`application/json`

`application/json`