Find related entries

Find silo entries whose document mentions the given entry’s UUID.

GET /silo/v1/entries/{id}/related

cURL

cURL

curl --request GET \
  --url https://api.invopop.com/silo/v1/entries/{id}/related \
  --header 'Authorization: Bearer <token>'

import requests

url = "https://api.invopop.com/silo/v1/entries/{id}/related"

headers = {"Authorization": "Bearer <token>"}

response = requests.get(url, headers=headers)

print(response.text)

const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};

fetch('https://api.invopop.com/silo/v1/entries/{id}/related', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.invopop.com/silo/v1/entries/{id}/related",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer <token>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://api.invopop.com/silo/v1/entries/{id}/related"

	req, _ := http.NewRequest("GET", url, nil)

	req.Header.Add("Authorization", "Bearer <token>")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.get("https://api.invopop.com/silo/v1/entries/{id}/related")
  .header("Authorization", "Bearer <token>")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://api.invopop.com/silo/v1/entries/{id}/related")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Get.new(url)
request["Authorization"] = 'Bearer <token>'

response = http.request(request)
puts response.read_body

200

{
  "created_at": "2025-05-01T00:00:00.000Z",
  "cursor": "<string>",
  "folder": "sales",
  "limit": 20,
  "list": [
    {
      "attachments": [
        {
          "category": "version",
          "created_at": "2018-01-01T00:00:00.000Z",
          "desc": "Invoice for January 2021.",
          "embeddable": true,
          "entry_id": "347c5b04-cde2-11ed-afa1-0242ac120002",
          "hash": "a1b2c3d4e5f6g7h8i9j0k1l2m3n4o5p6q7r8s9t0u1v2w3x4y5z6",
          "id": "<string>",
          "key": "pdf",
          "meta": {},
          "mime": "application/pdf",
          "name": "invoice.pdf",
          "previous": [
            {
              "created_at": "2018-01-01T00:00:00.000Z",
              "hash": "<string>",
              "id": "<string>",
              "size": 123
            }
          ],
          "private": true,
          "size": 12345,
          "stored": true,
          "url": "<string>"
        }
      ],
      "context": "line.item",
      "created_at": "2018-01-01T00:00:00.000Z",
      "data": {},
      "digest": {
        "alg": "<string>",
        "val": "<string>"
      },
      "doc_schema": "https://gobl.org/draft-0/bill/invoice",
      "draft": true,
      "env_schema": "https://gobl.org/draft-0/envelope",
      "faults": [
        {
          "code": "<string>",
          "message": "<string>",
          "paths": [
            "<string>"
          ],
          "provider": "pdf"
        }
      ],
      "folder": "sales",
      "id": "347c5b04-cde2-11ed-afa1-0242ac120002",
      "invalid": true,
      "key": "invoice-101",
      "meta": [
        {
          "created_at": "2018-01-01T00:00:00.000Z",
          "entry_id": "347c5b04-cde2-11ed-afa1-0242ac120002",
          "id": "347c5b04-cde2-11ed-afa1-0242ac120002:source:key",
          "indexed": true,
          "key": "service-id",
          "link_scope": "public",
          "link_url": "https://example.com/info",
          "owned": true,
          "owner_id": "<string>",
          "ref": "<string>",
          "secure": true,
          "shared": true,
          "src": "source",
          "updated_at": "2018-01-01T00:00:00.000Z",
          "value": {
            "key": "value"
          }
        }
      ],
      "signed": true,
      "snippet": {
        "title": "Sample Title"
      },
      "state": "sent",
      "tags": [
        "<string>"
      ],
      "updated_at": "2018-01-01T00:00:00.000Z"
    }
  ],
  "next_cursor": "<string>"
}

Authorizations

Authorization · string · header · required

Use the Bearer scheme with a valid JWT token to authenticate requests. Example: Authorization: Bearer <token>

Path Parameters

id · string · required

Silo entry ID to find related entries for.

Example:

"347c5b04-cde2-11ed-afa1-0242ac120002"

Query Parameters

uuid · string

The unique identifier of the document to find related entries for.

Example:

"347c5b04-cde2-11ed-afa1-0242ac120002"

context · string

The specific context within a document where the silo entry's UUID is referenced.

Example:

"line.item"

created_at · string

The starting date and time for retrieving related entries in descending order, formatted as an ISO timestamp.

Example:

"2023-08-02T00:00:00.000Z"

cursor · string

The position marker from the previous result's next_cursor property, used for pagination.

limit · integer

The maximum number of related entries to return in a single page of results.

Example:

20

Response

200 - application/json

OK

created_at · string

Starting date for results. Acts as the upper bound when descending (the default) or the lower bound when ascending.

Example:

"2025-05-01T00:00:00.000Z"

cursor · string

Cursor used to identify the current page of results.

folder · string

Key for the folder

Example:

"sales"

limit · integer

Maximum number of entries to show in a page of results, up to 100.

Example:

20

list · List · object[] | null

Array of entries sorted by creation time, descending by default or ascending when requested.

Show child attributes

next_cursor · string

Cursor used to identify the next page of results.