Skip to main content
POST
/
partitions
/
{partitionKey}
/
v1
/
collections
/
{collectionKey}
/
resources
/
{resourceId}
/
browse-includes
Browse across a resource includes
curl --request POST \
  --url https://{workspaceId}.clinia.cloud/partitions/{partitionKey}/v1/collections/{collectionKey}/resources/{resourceId}/browse-includes \
  --header 'Content-Type: application/json' \
  --header 'X-Clinia-API-Key: <api-key>' \
  --data '
{
  "cursor": "<string>",
  "includes": [
    "<string>"
  ],
  "perPage": 500
}
'
{
  "hits": [
    {
      "id": "<string>",
      "type": "<string>",
      "from": {
        "id": "<string>",
        "type": "<string>"
      },
      "to": {
        "id": "<string>",
        "type": "<string>"
      },
      "data": {},
      "meta": {
        "createdAt": "2023-11-07T05:31:56Z",
        "identifier": [
          {
            "id": "<string>",
            "system": "<string>",
            "value": "<string>",
            "use": "<string>",
            "period": {
              "id": "<string>",
              "start": "<string>",
              "end": "<string>"
            }
          }
        ],
        "source": "<string>",
        "updatedAt": "2023-11-07T05:31:56Z"
      },
      "targetResource": {
        "id": "<string>",
        "type": "<string>",
        "data": {},
        "meta": {
          "createdAt": "2023-11-07T05:31:56Z",
          "identifier": [
            {
              "id": "<string>",
              "system": "<string>",
              "value": "<string>",
              "use": "<string>",
              "period": {
                "id": "<string>",
                "start": "<string>",
                "end": "<string>"
              }
            }
          ],
          "source": "<string>",
          "updatedAt": "2023-11-07T05:31:56Z"
        },
        "contained": {},
        "relativeIdentities": {}
      }
    }
  ],
  "meta": {
    "cursor": "<string>",
    "total": 123
  }
}

Authorizations

X-Clinia-API-Key
string
header
required

Path Parameters

partitionKey
string
required
collectionKey
string
required

Key of the collection.

resourceId
string
required

The unified resource id.

Body

application/json

Parameters to initiate or continue a browse includes session. To initiate a session, provide the list of includes to browse and optionally the number of results to return per page. To continue a session, provide the cursor returned from a previous response.

cursor
string

The cursor representing the current BrowseIncludes session.

includes
string[]

The list of includes to browse. It can be used to include only a relationship (e.g. worksAt) or a relationship and the targeted resource (e.g. worksAt.clinic).

perPage
integer

The number of results to return per batch. Defaults to 100.

Required range: 1 <= x <= 1000

Response

A successful response containing the first batch of results and a cursor to continue browsing. 5 minutes after the request, the cursor will expire and a 404 error will be returned if you try to continue browsing.

hits
object[]
required
meta
object
required

Metadata about the browse session, including the cursor and the total number of results available in the browse session.