List items

curl --request GET \
  --url https://api.example.com/items \
  --header 'Authorization: Bearer <token>'

{
  "data": [
    {
      "id": "<string>",
      "type": "<string>",
      "properties": {},
      "version": 123,
      "schema_version": 123,
      "source": "<string>",
      "timestamp": "<string>",
      "created_at": "<string>",
      "updated_at": "<string>",
      "tenant_id": "<string>",
      "source_id": "<string>",
      "device": "<string>",
      "capture_latitude": 123,
      "capture_longitude": 123,
      "edges": {},
      "extensions": {}
    }
  ],
  "cursor": "<string>",
  "has_more": true
}

Items

List items

Returns a paginated list of items in the tenant, narrowed by the supplied query parameters. type matches subtypes via inheritance — type=core.media returns core.media.book, core.media.article, etc. since / until operate on the item’s effective time (timestamp, falling back to created_at), not updated_at. tier accepts library, feed, or all (omitting returns both slices).

Lists are lean by default — no edges, no metadata, no extensions. The include parameter is the escape hatch: ?include=edges,metadata hydrates the matching extras inline so the caller avoids the N+1 trap. See Items — lists are lean and Search and query for the filter grammar.

Cursors are stable for ~24 hours; concurrent writes don’t shift pages already returned.

GET

items

List items

curl --request GET \
  --url https://api.example.com/items \
  --header 'Authorization: Bearer <token>'

{
  "data": [
    {
      "id": "<string>",
      "type": "<string>",
      "properties": {},
      "version": 123,
      "schema_version": 123,
      "source": "<string>",
      "timestamp": "<string>",
      "created_at": "<string>",
      "updated_at": "<string>",
      "tenant_id": "<string>",
      "source_id": "<string>",
      "device": "<string>",
      "capture_latitude": 123,
      "capture_longitude": 123,
      "edges": {},
      "extensions": {}
    }
  ],
  "cursor": "<string>",
  "has_more": true
}

Authorizations

Authorization

string

header

required

Pass an API key (marfa_k1_...) or OAuth access token (marfa_at_...)

Query Parameters

type

string

state

string

source

string

tier

enum<string>

Available options:

library,

feed,

all

Response

Paginated list of items

Option 1
Option 2

data

object[]

required

Show child attributes

cursor

string | null

required

has_more

boolean

required

Create an item

Documentation Index

Authorizations

Query Parameters

Response