Resource configuration and account history

Get current resource configuration

GET /api/v1/resource

Read public integration configuration for the selected resource. Despite its public-resource name, this operation’s role/context requires an active user; it is not the guest embedded-settings endpoint.

Before you call

Use an existing active member token and resource public key. Despite its short path, this is an authenticated user operation. Payment-system configuration must exist for its selected provider branch. See member and resource context for supplied configuration and shared checks.

Request

GET with no request body or request Content-Type requirement. Response media type is JSON. Requires the user role or inherited permission and active member context. See credential transport.

This action is excluded from ordinary session expiry/revocation checks, but role and user/resource guards still apply. No query fields, filters, sort or pagination are read.

Result

HTTP 200 JSON.

curl "${WALLKIT_API_BASE}/api/v1/resource" \
  -H "resource: ${RESOURCE_KEY}" \
  -H "token: ${USER_TOKEN}"

// Node.js 18+; built-in fetch. Supply existing integration configuration.
async function main() {
  const url = new URL("/api/v1/resource", process.env.WALLKIT_API_BASE);
  const headers = { resource: process.env.RESOURCE_KEY, token: process.env.USER_TOKEN };
  const response = await fetch(url, { method: "GET", headers });
  const body = await response.json();
  console.log(response.status, body);
}
main().catch(console.error);

# Python 3; standard library only.
import json
import os
from urllib.error import HTTPError
from urllib.parse import urlencode, urljoin
from urllib.request import Request, urlopen

url = urljoin(os.environ["WALLKIT_API_BASE"], "/api/v1/resource")
headers = {"resource": os.environ["RESOURCE_KEY"], "token": os.environ["USER_TOKEN"]}
request = Request(url, headers=headers, method="GET")
try:
    with urlopen(request) as response:
        print(response.status, json.load(response))
except HTTPError as error:
    print(error.code, json.load(error))

{
  "public_key": "example-resource",
  "origin": "https://example.com",
  "payments_in_live_mode": false,
  "web_app_config": null,
  "default_payment_system": "stripe",
  "stripe_public_key": "EXAMPLE_STRIPE_PUBLIC_KEY"
}

{
  "web_app_config": null
}

List resources used by the user

GET /api/v1/user/resources

List resources where this user has at least one transaction. This list spans transaction history across resources. The summary operations below instead require user relationships and a shared partner.

Before you call

Use an existing member token and its normal resource context for session resolution. This list spans transaction-linked resources; the resource header does not restrict it to one resource. See member and resource context for supplied configuration and shared checks.

Request

GET with no request body or request Content-Type requirement. Response media type is JSON. Requires the user role or inherited permission and active member context. See credential transport.

No explicit by, order or sort is read. Use the summary calls for nested account records. Resource header remains the session-resolution context; it does not restrict this query to only that resource.

Result

HTTP 200 JSON.

paginator uses the collection fields. An empty collection is an ordinary result; do not interpret it as an authentication failure.

curl "${WALLKIT_API_BASE}/api/v1/user/resources?page=1&limit=10" \
  -H "resource: ${RESOURCE_KEY}" \
  -H "token: ${USER_TOKEN}"

// Node.js 18+; built-in fetch. Supply existing integration configuration.
async function main() {
  const url = new URL("/api/v1/user/resources", process.env.WALLKIT_API_BASE);
  url.searchParams.set("page", "1");
  url.searchParams.set("limit", "10");
  const headers = { resource: process.env.RESOURCE_KEY, token: process.env.USER_TOKEN };
  const response = await fetch(url, { method: "GET", headers });
  const body = await response.json();
  console.log(response.status, body);
}
main().catch(console.error);

# Python 3; standard library only.
import json
import os
from urllib.error import HTTPError
from urllib.parse import urlencode, urljoin
from urllib.request import Request, urlopen

url = urljoin(os.environ["WALLKIT_API_BASE"], "/api/v1/user/resources")
url += "?" + urlencode({'page': '1', 'limit': '10'})
headers = {"resource": os.environ["RESOURCE_KEY"], "token": os.environ["USER_TOKEN"]}
request = Request(url, headers=headers, method="GET")
try:
    with urlopen(request) as response:
        print(response.status, json.load(response))
except HTTPError as error:
    print(error.code, json.load(error))

{
  "items": [
    {
      "title": "Example publication",
      "key": "example-resource",
      "host": "https://example.com"
    }
  ]
}

{
  "items": []
}

Read subscriptions grouped by resource

GET /api/v1/user/resources/subscriptions

Read the user’s plan memberships grouped by related resources of the selected partner. This summarizes existing memberships; it does not purchase or change them.

Before you call

Use an existing member token and selected resource context. Results come from related active resources of active partners sharing that resource’s partner. See member and resource context for supplied configuration and shared checks.

Request

GET with no request body or request Content-Type requirement. Response media type is JSON. Requires the user role or inherited permission and active member context. See credential transport.

See grouped summary selection for the resource set, pagination, ignored filters and empty wrapper.

Result

HTTP 200 JSON.

paginator uses the collection fields. An empty collection is an ordinary result; do not interpret it as an authentication failure.

curl "${WALLKIT_API_BASE}/api/v1/user/resources/subscriptions?page=1&limit=10" \
  -H "resource: ${RESOURCE_KEY}" \
  -H "token: ${USER_TOKEN}"

// Node.js 18+; built-in fetch. Supply existing integration configuration.
async function main() {
  const url = new URL("/api/v1/user/resources/subscriptions", process.env.WALLKIT_API_BASE);
  url.searchParams.set("page", "1");
  url.searchParams.set("limit", "10");
  const headers = { resource: process.env.RESOURCE_KEY, token: process.env.USER_TOKEN };
  const response = await fetch(url, { method: "GET", headers });
  const body = await response.json();
  console.log(response.status, body);
}
main().catch(console.error);

# Python 3; standard library only.
import json
import os
from urllib.error import HTTPError
from urllib.parse import urlencode, urljoin
from urllib.request import Request, urlopen

url = urljoin(os.environ["WALLKIT_API_BASE"], "/api/v1/user/resources/subscriptions")
url += "?" + urlencode({'page': '1', 'limit': '10'})
headers = {"resource": os.environ["RESOURCE_KEY"], "token": os.environ["USER_TOKEN"]}
request = Request(url, headers=headers, method="GET")
try:
    with urlopen(request) as response:
        print(response.status, json.load(response))
except HTTPError as error:
    print(error.code, json.load(error))

{
  "items": [
    {
      "resources": [
        {
          "id": 1001,
          "title": "Example publication",
          "key": "example-resource",
          "host": "https://example.com",
          "plans": [
            {
              "id": 1001,
              "title": "Reader plan",
              "slug": "reader",
              "description": "Example membership",
              "subscription": {
                "id": 2001,
                "title": "Monthly",
                "expiration_date": "2026-12-01 00:00:00",
                "autorenew": true
              }
            }
          ]
        }
      ]
    }
  ]
}

{
  "items": [
    {
      "resources": []
    }
  ]
}

Read purchases grouped by resource

GET /api/v1/user/resources/purchases

Read this user’s purchases in each related resource, selecting the resource through the purchase’s transaction. This is a history summary, not a checkout action.

Before you call

Use an existing member token and selected resource context. Results come from related active resources of active partners sharing that resource’s partner. See member and resource context for supplied configuration and shared checks.

Request

GET with no request body or request Content-Type requirement. Response media type is JSON. Requires the user role or inherited permission and active member context. See credential transport.

See grouped summary selection for the resource set, pagination, ignored filters and empty wrapper.

Result

HTTP 200 JSON.

paginator uses the collection fields. An empty collection is an ordinary result; do not interpret it as an authentication failure.

curl "${WALLKIT_API_BASE}/api/v1/user/resources/purchases?page=1&limit=10" \
  -H "resource: ${RESOURCE_KEY}" \
  -H "token: ${USER_TOKEN}"

// Node.js 18+; built-in fetch. Supply existing integration configuration.
async function main() {
  const url = new URL("/api/v1/user/resources/purchases", process.env.WALLKIT_API_BASE);
  url.searchParams.set("page", "1");
  url.searchParams.set("limit", "10");
  const headers = { resource: process.env.RESOURCE_KEY, token: process.env.USER_TOKEN };
  const response = await fetch(url, { method: "GET", headers });
  const body = await response.json();
  console.log(response.status, body);
}
main().catch(console.error);

# Python 3; standard library only.
import json
import os
from urllib.error import HTTPError
from urllib.parse import urlencode, urljoin
from urllib.request import Request, urlopen

url = urljoin(os.environ["WALLKIT_API_BASE"], "/api/v1/user/resources/purchases")
url += "?" + urlencode({'page': '1', 'limit': '10'})
headers = {"resource": os.environ["RESOURCE_KEY"], "token": os.environ["USER_TOKEN"]}
request = Request(url, headers=headers, method="GET")
try:
    with urlopen(request) as response:
        print(response.status, json.load(response))
except HTTPError as error:
    print(error.code, json.load(error))

{
  "items": [
    {
      "resources": [
        {
          "id": 1001,
          "title": "Example publication",
          "key": "example-resource",
          "host": "https://example.com",
          "purchases": [
            {
              "id": 4001,
              "item_type": "content",
              "item_key": "article-1001",
              "item_id": 1001,
              "price": 500,
              "discount": 0,
              "amount": 500,
              "currency": "USD",
              "created_at": "2026-09-30 10:00:00"
            }
          ]
        }
      ]
    }
  ]
}

{
  "items": [
    {
      "resources": []
    }
  ]
}

Read transactions grouped by resource

GET /api/v1/user/resources/transactions

Read this user’s transactions for each related resource. This does not create, refund or update a payment.

Before you call

Use an existing member token and selected resource context. Results come from related active resources of active partners sharing that resource’s partner. See member and resource context for supplied configuration and shared checks.

Request

GET with no request body or request Content-Type requirement. Response media type is JSON. Requires the user role or inherited permission and active member context. See credential transport.

See grouped summary selection for the resource set, pagination, ignored filters and empty wrapper. Use the transaction definition for supported status meanings; no closed enum is promised.

Result

HTTP 200 JSON.

paginator uses the collection fields. An empty collection is an ordinary result; do not interpret it as an authentication failure.

curl "${WALLKIT_API_BASE}/api/v1/user/resources/transactions?page=1&limit=10" \
  -H "resource: ${RESOURCE_KEY}" \
  -H "token: ${USER_TOKEN}"

// Node.js 18+; built-in fetch. Supply existing integration configuration.
async function main() {
  const url = new URL("/api/v1/user/resources/transactions", process.env.WALLKIT_API_BASE);
  url.searchParams.set("page", "1");
  url.searchParams.set("limit", "10");
  const headers = { resource: process.env.RESOURCE_KEY, token: process.env.USER_TOKEN };
  const response = await fetch(url, { method: "GET", headers });
  const body = await response.json();
  console.log(response.status, body);
}
main().catch(console.error);

# Python 3; standard library only.
import json
import os
from urllib.error import HTTPError
from urllib.parse import urlencode, urljoin
from urllib.request import Request, urlopen

url = urljoin(os.environ["WALLKIT_API_BASE"], "/api/v1/user/resources/transactions")
url += "?" + urlencode({'page': '1', 'limit': '10'})
headers = {"resource": os.environ["RESOURCE_KEY"], "token": os.environ["USER_TOKEN"]}
request = Request(url, headers=headers, method="GET")
try:
    with urlopen(request) as response:
        print(response.status, json.load(response))
except HTTPError as error:
    print(error.code, json.load(error))

{
  "items": [
    {
      "resources": [
        {
          "id": 1001,
          "title": "Example publication",
          "key": "example-resource",
          "host": "https://example.com",
          "transactions": [
            {
              "id": 5001,
              "date": "2026-09-30 10:00:00",
              "amount": 500,
              "amount_refunded": 0,
              "currency": "USD",
              "card": "4242",
              "type": "Visa",
              "pay_system": "stripe",
              "status": "succeeded"
            }
          ]
        }
      ]
    }
  ]
}

{
  "items": [
    {
      "resources": []
    }
  ]
}